Skip to content

docs: how to migrate from openai apps - #260

Merged
ochafik merged 6 commits into
mainfrom
ochafik/docs-migrate-from-openai
Jan 13, 2026
Merged

docs: how to migrate from openai apps#260
ochafik merged 6 commits into
mainfrom
ochafik/docs-migrate-from-openai

Conversation

@ochafik

@ochafikochafik commented Jan 13, 2026•
edited
Loading

Copy link
Copy Markdown
Contributor

@jonathanhefner maybe could link this from #256 wdyt?

@pkg-pr-new

pkg-pr-newBot commented Jan 13, 2026•
edited
Loading

Copy link
Copy Markdown

Open in StackBlitz

@modelcontextprotocol/ext-apps

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/ext-apps@260

@modelcontextprotocol/server-basic-react

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-basic-react@260

@modelcontextprotocol/server-basic-vanillajs

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-basic-vanillajs@260

@modelcontextprotocol/server-budget-allocator

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-budget-allocator@260

@modelcontextprotocol/server-cohort-heatmap

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-cohort-heatmap@260

@modelcontextprotocol/server-customer-segmentation

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-customer-segmentation@260

@modelcontextprotocol/server-scenario-modeler

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-scenario-modeler@260

@modelcontextprotocol/server-system-monitor

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-system-monitor@260

@modelcontextprotocol/server-threejs

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-threejs@260

@modelcontextprotocol/server-wiki-explorer

npm i https://pkg.pr.new/modelcontextprotocol/ext-apps/@modelcontextprotocol/server-wiki-explorer@260

commit: 9bbd279

@ochafik
ochafik marked this pull request as ready for review January 13, 2026 13:26
jonathanhefner
jonathanhefner previously approved these changes Jan 13, 2026
View reviewed changes

@jonathanhefnerjonathanhefner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great! Really like the table format!

maybe could link this from #256 wdyt?

I was think about something like that too. Do we want it to be part of that skill (e.g., create a new MCP App derived from an OAI App), or do we want it to be a separate skill (e.g., migrate an OAI App to the MCP App SDK)?

Comment threadAGENTS.md Outdated
Comment threaddocs/migrate_from_openai_apps.md Outdated
| -------------------------------- | -------------------------------------------------- | ------------------------------------------------------ |
| `window.openai` (auto-available) | `const app = new App({name, version}, {})` | MCP requires explicit instantiation |
| (implicit) | `await app.connect()` | MCP requires async connection; auto-detects OpenAI env |
| — | `await app.connect(new OpenAITransport())` | Force OpenAI mode explicitly |

@jonathanhefnerjonathanhefnerJan 13, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just noting that this doesn't exist yet (see #172).

Comment threaddocs/migrate_from_openai_apps.md Outdated
Comment threaddocs/migrate_from_openai_apps.md Outdated
@ochafik@jonathanhefner
Update docs/migrate_from_openai_apps.md
71c4c07
Co-authored-by: Jonathan Hefner <jonathan@hefner.pro>
@ochafik
Merge branch 'main' ofhttps://github.com/modelcontextprotocol/ext-apps…
4c62859
… into ochafik/docs-migrate-from-openai
@ochafik
Merge branch 'ochafik/docs-migrate-from-openai' ofhttps://github.com…
da0c91c
…/modelcontextprotocol/ext-apps into ochafik/docs-migrate-from-openai
@ochafik
address PR review comments
9bbd279
- Remove AGENTS.md reference to migration guide
- Add note that OpenAITransport is not yet available (PR #172)
- Remove unnecessary note about return type ordering
@ochafik

ochafik commented Jan 13, 2026

Copy link
Copy Markdown
ContributorAuthor

Addressed the review comments in 9bbd279:

  1. AGENTS.md reference - Removed as suggested
  2. OpenAITransport - Added note that it's not yet available with link to PR feat: experimental OpenAI Apps SDK compatibility #172
  3. Return type ordering note - Removed the unnecessary "Same shape, slightly different ordering" note

Regarding the skill integration question: I think a separate "Migrate OAI App" skill makes more sense - it's a distinct workflow from creating a new app from scratch, and keeps the concerns separated. But open to either approach!

@ochafik
ochafik merged commit 152b953 into mainJan 13, 2026
9 of 15 checks passed
@ochafik
ochafik deleted the ochafik/docs-migrate-from-openai branch January 13, 2026 15:29
@tobinsouth

tobinsouth commented Jan 13, 2026

Copy link
Copy Markdown
Contributor

FYI I think docs pointing to the plugins is a great idea. Most folks will probably be vibe coding apps by end of Q1, let's be honest.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jonathanhefnerjonathanhefnerjonathanhefner left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@ochafik@tobinsouth@jonathanhefner