modelcontextprotocol/ext-apps
Watch
1
0
Fork
You've already forked ext-apps
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #345 from jonathanhefner/polish-oai-migration-reference

Browse source 
Polish OpenAI migration reference for readability
This commit is contained in:
Jonathan Hefner 2026-01-24 15:41:44 -06:00 • committed by GitHub
commit 6c767c4bd4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 10 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

11
docs/migrate_from_openai_apps.md
View file

@ -4,10 +4,17 @@ title: Migrate OpenAI App
# Migrating from OpenAI Apps SDK to MCP Apps SDK
This guide helps you migrate from the OpenAI Apps SDK to the MCP Apps SDK (`@modelcontextprotocol/ext-apps`).
This reference maps OpenAI Apps SDK concepts to their MCP Apps SDK (`@modelcontextprotocol/ext-apps`) equivalents. Use the tables below for quick lookup during migration, and refer to the code examples for complete before/after comparisons.
This guide covers server-side changes first (metadata, tools, resources), then client-side changes (setup, context, events).
> [!NOTE]
> Some OpenAI Apps SDK features don't have MCP equivalents yet. These are marked "Not yet implemented" in the tables below.
## Server-Side
The server-side changes involve updating metadata structure and using helper functions.
### Quick Start Comparison
| OpenAI Apps SDK | MCP Apps SDK |
@ -190,6 +197,8 @@ function createServer() {
## Client-Side
Client-side migration involves replacing the implicit `window.openai` global with an explicit `App` instance.
### Quick Start Comparison
| OpenAI Apps SDK | MCP Apps SDK |