migrate-oai-app

This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

Ir a la instalación

Repositorio: modelcontextprotocol/ext-apps
Última actividad en el origen: 10 de febrero de 2026 a las 14:50
Idioma detectado de SKILL.md: inglés
Estrellas: 2712
Forks: 364

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/modelcontextprotocol/ext-apps --skill migrate-oai-app

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

create-mcp-app

This skill should be used when the user asks to "create an MCP App", "add a UI to an MCP tool", "build an interactive MCP View", "scaffold an MCP App", or needs guidance on MCP Apps SDK patterns, UI-resource registration, MCP App lifecycle, or host integration. Provides comprehensive guidance for building MCP Apps with interactive UIs.

2026-03-06

convert-web-app

This skill should be used when the user asks to "add MCP App support to my web app", "turn my web app into a hybrid MCP App", "make my web page work as an MCP App too", "wrap my existing UI as an MCP App", "convert iframe embed to MCP App", "turn my SPA into an MCP App", or needs to add MCP App support to an existing web application while keeping it working standalone. Provides guidance for analyzing existing web apps and creating a hybrid web + MCP App with server-side tool and resource registration.

2026-02-21

add-app-to-server

This skill should be used when the user asks to "add an app to my MCP server", "add UI to my MCP server", "add a view to my MCP tool", "enrich MCP tools with UI", "add interactive UI to existing server", "add MCP Apps to my server", or needs to add interactive UI capabilities to an existing MCP server that already has tools. Provides guidance for analyzing existing tools and adding MCP Apps UI resources.

2026-02-20

Ver todos los de este repositorio

name	migrate-oai-app
description	This skill should be used when the user asks to "migrate from OpenAI Apps SDK", "convert OpenAI App to MCP", "port from window.openai", "migrate from skybridge", "convert openai/outputTemplate", or needs guidance on converting OpenAI Apps SDK applications to MCP Apps SDK. Provides step-by-step migration guidance with API mapping tables.

Migrate OpenAI App to MCP

Migrate existing OpenAI Apps SDK applications to the MCP Apps SDK (@modelcontextprotocol/ext-apps). The MCP Apps SDK provides a standardized, open protocol for interactive UIs in conversational clients.

Best Practices

Use your package manager to add dependencies (e.g., npm install, pnpm add, yarn add) instead of manually writing version numbers. This lets the package manager resolve the latest compatible versions. Never specify version numbers from memory.
Preemptively add a final todo item with this exact wording: "Re-read the 'Before Finishing' checklist in this skill and address each checkbox individually, stating what you did for each one, before marking this todo complete."

Getting Reference Code

Clone the SDK repository for complete migration documentation and working examples:

git clone --branch "v$(npm view @modelcontextprotocol/ext-apps version)" --depth 1 https://github.com/modelcontextprotocol/ext-apps.git /tmp/mcp-ext-apps

Migration Reference Guide

Read the migration reference guide with "before/after" mapping tables: /tmp/mcp-ext-apps/docs/migrate_from_openai_apps.md

API Reference (Source Files)

Read JSDoc documentation directly from /tmp/mcp-ext-apps/src/*:

`src/app.ts`	`App` class, handlers, lifecycle
`src/server/index.ts`	`registerAppTool`, `registerAppResource`
`src/spec.types.ts`	Type definitions
`src/react/useApp.tsx`	`useApp` hook for React apps
`src/react/use.ts`	Other `use*` hooks for React apps

Template	Key Files
`basic-server-vanillajs/`	`server.ts`, `src/mcp-app.ts`, `mcp-app.html`
`basic-server-react/`	`server.ts`, `src/mcp-app.tsx` (uses `useApp` hook)
`basic-server-vue/`	`server.ts`, `src/App.vue`
`basic-server-svelte/`	`server.ts`, `src/App.svelte`
`basic-server-preact/`	`server.ts`, `src/mcp-app.tsx`
`basic-server-solid/`	`server.ts`, `src/mcp-app.tsx`

OpenAI Feature	Status/Workaround
`_meta["openai/toolInvocation/invoking"]` / `_meta["openai/toolInvocation/invoked"]`	Progress indicators not yet available
`_meta["openai/widgetDescription"]`	Use `app.updateModelContext()` for dynamic context

OpenAI Feature	Status/Workaround
`window.openai.widgetState` / `setWidgetState()`	Use `localStorage` or server-side state
`window.openai.uploadFile()` / `getFileDownloadUrl()`	File operations not yet available
`window.openai.requestModal()` / `requestClose()`	Modal management not yet available
`window.openai.view`	Not yet available

Pattern	Indicates
`"openai/`	Old metadata keys → `_meta.ui.*`
`text/html+skybridge`	Old MIME type → `RESOURCE_MIME_TYPE` constant
`text/html;profile=mcp-app`	New MIME type, but prefer `RESOURCE_MIME_TYPE` constant
`_domains"` or `_domains:`	snake_case CSP → camelCase (`connect_domains` → `connectDomains`)

migrate-oai-app

Opciones de instalación

Revisa los archivos de origen

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Front-End Framework Examples

CSP Investigation

CORS Configuration

Key Conceptual Changes

Server-Side

Client-Side

Features Not Yet Available in MCP Apps

Before Finishing

Testing

Using basic-host

Verify Runtime Behavior

Pattern	Indicates
`window.openai.toolInput`	Old global → `params.arguments` in `ontoolinput` handler
`window.openai.toolOutput`	Old global → `params.structuredContent` in `ontoolresult`
`window.openai`	Old global API → `App` instance methods

migrate-oai-app

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

Más de este repositorio

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Migrate OpenAI App to MCP

Best Practices

Getting Reference Code

Migration Reference Guide

API Reference (Source Files)

Front-End Framework Examples

CSP Investigation

CORS Configuration

Key Conceptual Changes

Server-Side

Client-Side

Features Not Yet Available in MCP Apps

Before Finishing

Testing

Using basic-host

Verify Runtime Behavior