Skip to content

Polish OpenAI migration reference for readability #345

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jonathanhefner merged 1 commit into from
Jan 24, 2026
+10 −1
Merged

Polish OpenAI migration reference for readability #345

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion docs/migrate_from_openai_apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -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 |
Expand Down
Loading