Si ya publicas un complemento o conector de Claude Code, elige el proceso de envío según incluya habilidades, un servidor MCP o ambos.
| Qué tienes | Qué enviar |
|---|---|
| Habilidades sin servidor MCP | Sube un complemento que solo incluya habilidades. |
| Un punto de acceso MCP público con HTTPS | Crea un envío de MCP remoto. Incluye las habilidades que tengas en el mismo borrador. |
| Un servidor MCP local | Despliégalo en una URL HTTPS pública. Si no puedes hacerlo, comunícate con tu contacto de OpenAI para obtener soporte para MCP local. |
Claude usa procesos de envío separados para los complementos de Claude Code y los conectores MCP. OpenAI usa un único paquete de complemento que puede contener habilidades, servidores MCP o ambos. Las fichas y aprobaciones del marketplace de Claude no se transfieren.
Si tu complemento incluye habilidades, revisa sus instrucciones siguiendo las pautas sobre el seguimiento de instrucciones antes de enviarlas por cualquiera de las dos vías.
Envía un complemento que solo incluya habilidades
Elige este proceso cuando el complemento no necesite un servidor MCP.
Revisa qué admite OpenAI
| Qué incluye tu complemento de Claude | Qué hacer |
|---|---|
skills | Conserva cada habilidad junto con su SKILL.md, scripts, referencias y recursos. Para subir directamente un archivo comprimido de Claude, este debe incluir al menos una habilidad en skills/<skill-name>/SKILL.md. |
| Directorios personalizados de habilidades declarados en el archivo de manifiesto | Conserva los directorios y sus declaraciones en el archivo de manifiesto dentro del archivo comprimido. |
| Habilidades que hacen referencia explícita a Claude | Reemplaza las referencias específicas a Claude en las instrucciones de la habilidad por expresiones independientes del proveedor, como “el modelo”. Conserva el nombre de un producto solo cuando la instrucción realmente se aplique a ese producto. |
commands, commands/, agents o agents/ | Convierte el comportamiento reutilizable en habilidades. Convierte cada comando de Markdown en una habilidad, traslada los procedimientos reutilizables de los agentes a habilidades e integra las instrucciones útiles sobre la personalidad en la habilidad correspondiente. |
hooks o hooks/hooks.json | Adapta los hooks de comandos al entorno de ejecución de hooks de Codex, incluidos ChatGPT Work y Codex. Los scripts de los hooks deben estar disponibles en el entorno de ejecución y haberse marcado como confiables antes de ejecutarse. No dependas de hooks en el Chat habitual; Codex no ejecuta controladores de hooks de tipo prompt o agente. |
userConfig o ${user_config.*} | OpenAI no ejecuta los prompts de instalación de Claude ni expande las variables user_config. Sigue las instrucciones de Reemplaza userConfig de Claude. Si el complemento necesita credenciales o configuraciones de usuario persistentes, usa un servidor MCP. |
| Habilidades que crean o actualizan artefactos dinámicos de Claude | OpenAI actualmente no admite los artefactos dinámicos de Claude. Elimina las instrucciones que requieran crear, volver a abrir, recargar o actualizar un artefacto. En su lugar, devuelve el contenido subyacente como una respuesta normal de la conversación; por ejemplo, muestra las tablas de los artefactos como tablas estándar. No se conservan el HTML, la persistencia, el comportamiento de recarga ni las interacciones específicos de los artefactos. |
bin/, settings, settings.json, CLAUDE.md o .claude/settings*.json | Conserva las herramientas auxiliares y las instrucciones necesarias en el complemento. Invoca los ejecutables incluidos mediante rutas relativas al paquete y elimina las configuraciones exclusivas de Claude. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels o dependencies | Traslada el comportamiento esencial a habilidades y luego elimina la declaración de Claude. Comunícate con tu socio de OpenAI si el flujo de trabajo principal requiere mensajes entrantes de canales. |
.claude-plugin/plugin.json | Conserva el archivo de manifiesto para subir directamente un archivo comprimido de Claude. El portal lo convierte a .codex-plugin/plugin.json. |
.claude-plugin/marketplace.json, .mcp.json, mcpServers, .app.json o apps | No dependas de estos archivos o declaraciones. Una carga que solo incluye habilidades excluye la configuración del servidor MCP y no puedes enviar una integración de servidor MCP existente mediante una referencia. |
Prepara y sube el archivo comprimido
- Confirma que la raíz del archivo comprimido, o su único directorio de nivel superior, incluya
.claude-plugin/plugin.jsoncon un valor no vacío endescriptiony al menos una habilidad válida enskills/<skill-name>/SKILL.md. - Abre el portal de envío de complementos, selecciona Crear complemento, elige Solo habilidades y sube el archivo comprimido.
- Revisa el archivo
.codex-plugin/plugin.jsongenerado. Durante la conversión, el portal agrega los valores predeterminados de la interfaz que falten y normaliza los campos de texto. - Prueba las habilidades importadas en un entorno limpio. Confirma que cada habilidad pueda encontrar los archivos y ejecutables a los que hace referencia y que no dependa de paquetes, archivos o credenciales locales no declarados.
- Completa los campos de la ficha y de revisión, corrige todos los problemas detectados en el análisis y envía el borrador.
Si el archivo comprimido no cumple los requisitos para subirlo directamente, sigue las instrucciones de Empaqueta tu complemento para crear el archivo de manifiesto de OpenAI y la estructura del paquete. Consulta Crear habilidades para conocer los requisitos de las habilidades.
Envía un complemento con un servidor MCP remoto
Elige este proceso cuando el servidor tenga una URL HTTPS pública y estable a la que OpenAI pueda acceder. El servidor puede haber sido local en el complemento de Claude; lo que importa para este envío es que lo hayas desplegado como un servicio remoto.
Revisa qué admite OpenAI
| Qué incluye tu integración de Claude | Qué hacer |
|---|---|
| Un servidor MCP remoto | Reutiliza la implementación del servidor. Envía un punto de acceso HTTPS público y estable que use Streamable HTTP. |
Un servidor MCP local o una extensión de Claude Desktop (.mcpb) | Despliega el servidor MCP en una URL HTTPS pública. Si no puedes hacerlo, comunícate con tu contacto de OpenAI para obtener soporte para MCP local. El portal no acepta archivos .mcpb. |
| Habilidades o directorios personalizados de habilidades declarados en el archivo de manifiesto | Incluye las habilidades en el mismo envío Con MCP . Conserva cada SKILL.md junto con sus scripts, referencias y recursos. |
| Habilidades que hacen referencia explícita a Claude | Reemplaza las referencias específicas a Claude en las instrucciones de la habilidad por expresiones independientes del proveedor, como “el modelo”. Conserva el nombre de un producto solo cuando la instrucción realmente se aplique a ese producto. |
commands, commands/, agents o agents/ | Convierte el comportamiento reutilizable en habilidades. Convierte cada comando de Markdown en una habilidad, traslada los procedimientos reutilizables de los agentes a habilidades e integra las instrucciones útiles sobre la personalidad en la habilidad correspondiente. |
hooks o hooks/hooks.json | Adapta los hooks de comandos al entorno de ejecución de hooks de Codex, incluidos ChatGPT Work y Codex. Los scripts de los hooks deben estar disponibles en el entorno de ejecución y haberse marcado como confiables antes de ejecutarse. No dependas de hooks en el Chat habitual; Codex no ejecuta controladores de hooks de tipo prompt o agente. |
userConfig o ${user_config.*} | OpenAI no ejecuta los prompts de instalación de Claude ni expande las variables user_config. Sigue las instrucciones de Reemplaza userConfig de Claude para trasladar cada valor a una entrada explícita, OAuth, almacenamiento alojado o una configuración local de Codex. |
| Habilidades que crean o actualizan artefactos dinámicos de Claude | OpenAI actualmente no admite los artefactos dinámicos de Claude. Elimina las instrucciones que requieran crear, volver a abrir, recargar o actualizar un artefacto. Devuelve el contenido subyacente como una respuesta normal en la conversación; por ejemplo, muestra las tablas de los artefactos como tablas estándar. No se conservan el HTML, la persistencia, el comportamiento de recarga ni las interacciones propios de los artefactos. |
.app.json, apps o una integración existente de servidor MCP | Envía directamente el punto de acceso del servidor MCP. No puedes enviar una integración existente de servidor MCP por referencia. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels o dependencies | Traslada el comportamiento esencial a habilidades o herramientas MCP y luego elimina la declaración de Claude. Comunícate con tu socio de OpenAI si el flujo de trabajo principal requiere mensajes entrantes de canales. |
Preparar y enviar el servidor MCP
- Despliega el servidor MCP en su punto de acceso HTTPS de producción con Streamable HTTP. Usa OAuth 2.1 cuando el servidor acceda a datos privados del usuario o realice acciones en su nombre. Sigue Autenticar usuarios para consultar los requisitos de producto compatibles y la especificación de autorización de MCP.
- Agrega esquemas de herramientas precisos y anotaciones de seguridad. Comprueba que cada herramienta se conecte, se autentique, devuelva la estructura de resultados esperada y solicite la confirmación prevista para las acciones de escritura o destructivas.
- Convierte los comandos o agentes en habilidades y asegúrate de que estas no dependan de paquetes, archivos ni credenciales locales no declarados.
- Abre el portal de envío de complementos, selecciona Crear complemento, elige Con MCP y envía el punto de acceso de producción. Agrega las habilidades convertidas al mismo borrador cuando corresponda.
- Verifica el dominio del servidor, configura la autenticación cuando el servidor requiera iniciar sesión, completa los campos de la ficha y de revisión, resuelve todos los problemas detectados en el análisis y envía el borrador.
Planifica estos dos pasos de configuración antes de realizar el envío:
- Verificación del dominio: debes poder servir el token exacto del portal
desde
/.well-known/openai-apps-challengeen el host MCP o en un host superior permitido. Completa el desafío cuando el portal te lo solicite. Consulta Configurar el envío de MCP. - OAuth y restricciones de dominio del espacio de trabajo: si el complemento usa OAuth, expón
un punto de acceso UserInfo que devuelva la declaración
emaildel usuario yemail_verified: true. Anuncia y habilita los alcancesopenidyemail. Consulta Admitir restricciones de dominio del espacio de trabajo.
Consulta los requisitos de revisión de servidores MCP remotos antes de realizar el envío.
Reemplazar userConfig de Claude
Los complementos de OpenAI no ejecutan los prompts de instalación de userConfig de Claude ni expanden
las referencias a ${user_config.*}. Elimina esas referencias y reemplaza cada valor
según cómo lo use el complemento.
| Qué controla el valor | Alternativa en OpenAI |
|---|---|
| Una elección que puede cambiar para cada tarea | Agrega un parámetro de entrada explícito a la habilidad o herramienta MCP. Solicita el valor solo cuando el flujo de trabajo lo necesite. |
| Una credencial para un servicio remoto | Usa OAuth 2.1 a través del servidor MCP remoto. No incluyas secretos en el archivo de la habilidad, el archivo de manifiesto, las instrucciones ni los valores predeterminados. |
| Una preferencia que debe persistir | Guárdala en el servicio alojado y asóciala con el usuario autenticado. Permite que el usuario la actualice mediante un flujo de trabajo explícito o un parámetro de entrada de una herramienta. |
| Una opción de configuración para un script o hook local de Codex | Usa una variable de entorno o un archivo de configuración documentados. Comprueba que estén disponibles antes de usarlos y, si faltan, devuelve un error que indique cómo resolverlo. No hagas que esta configuración local sea necesaria para el flujo de trabajo principal de ChatGPT. |
| Un valor fijo que es igual para todos los usuarios | Incluye un valor predeterminado que no sea secreto en las instrucciones de la habilidad o en la configuración del servicio alojado. |
Si un complemento que solo contiene habilidades necesita una credencial o una configuración que deba persistir entre conversaciones, agrega un servidor MCP. Usa OAuth y almacenamiento alojado para el servidor remoto. Si el valor solo afecta a la tarea actual, mantén el complemento limitado a habilidades y solicítalo como un parámetro de entrada explícito de la habilidad.
Cumplir los requisitos de envío
Antes de enviar cualquiera de los dos tipos de complemento, obtén acceso de escritura a Administración de Apps en la organización de OpenAI que será su propietaria. También debes completar la verificación de identidad personal o empresarial. Todos los complementos deben completar la revisión de OpenAI.
Comunícate con tu socio de OpenAI antes de realizar el envío si el valor principal del complemento requiere ejecución local, acceso arbitrario a archivos en la computadora del usuario, acceso al hardware o a aplicaciones, funcionamiento sin conexión o mensajes entrantes de canales. Estos casos pueden requerir una revisión específica del producto.
Para conocer el flujo de trabajo completo del portal, consulta Enviar complementos. Si el portal informa un código de validación del paquete, consulta la referencia de errores de envío.