Si ya publicas un complemento o conector de Claude Code, elige cómo enviarlo según si incluye habilidades, un servidor MCP o ambos.
| Qué tienes | Qué debes enviar |
|---|---|
| Habilidades sin servidor MCP | Sube un complemento que solo incluya habilidades. |
| Un punto de acceso MCP con una URL HTTPS pública | Crea una solicitud para un servidor MCP remoto. Si tienes habilidades, inclúyelas en el mismo borrador. |
| Un servidor MCP local | Consulta Envía complementos exclusivos para escritorio para conocer los requisitos de elegibilidad y las instrucciones de envío. |
Claude tiene procesos de envío distintos 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 con la guía sobre el seguimiento de instrucciones antes de enviarlas por cualquiera de las dos vías.
Envía un complemento que solo incluya habilidades
Elige esta opción si el complemento no necesita un servidor MCP.
Revisa qué admite OpenAI
| Qué incluye tu complemento de Claude | Qué debes hacer |
|---|---|
skills |
Conserva cada habilidad junto con su SKILL.md, sus 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 en el archivo comprimido tanto los directorios como sus declaraciones en el archivo de manifiesto. |
| Habilidades que hacen referencia explícita a Claude | En las instrucciones de las habilidades, sustituye las referencias específicas a Claude por expresiones que no dependan del proveedor, como “el modelo”. Conserva el nombre de un producto solo si la instrucción realmente se aplica a ese producto. |
commands, commands/, agents o agents/ |
Convierte cada comando de Markdown en una habilidad, traslada a las habilidades los procedimientos reutilizables de los agentes e incorpora a la habilidad correspondiente las instrucciones útiles sobre el rol que debe adoptar el agente. Así podrás reutilizar esos comportamientos como habilidades. |
hooks o hooks/hooks.json |
Quita los hooks del ciclo de vida antes de enviar el complemento al directorio público. Si el complemento depende de esos hooks, distribúyelo de modo que los usuarios puedan instalarlo manualmente en Codex para escritorio. Consulta Hooks del ciclo de vida. |
userConfig o ${user_config.*} |
OpenAI no muestra las solicitudes de datos que Claude presenta durante la instalación ni expande las variables de user_config. Sigue los pasos de Reemplaza userConfig de Claude. Si el complemento necesita credenciales o ajustes de usuario persistentes, usa un servidor MCP. |
| Habilidades que crean o actualizan artefactos dinámicos de Claude | Por el momento, OpenAI no admite los artefactos dinámicos de Claude. Quita las instrucciones que requieran crear, volver a abrir, recargar o actualizar un artefacto. Devuelve el contenido directamente en la respuesta de la conversación. Por ejemplo, muestra las tablas del artefacto como tablas estándar. No se conservan el HTML, la persistencia, el comportamiento de recarga ni las interacciones propios del artefacto. |
bin/, settings, settings.json, CLAUDE.md o .claude/settings*.json |
Conserva en el complemento las herramientas auxiliares y las instrucciones necesarias. Invoca los ejecutables incluidos mediante rutas relativas al paquete y quita los ajustes exclusivos de Claude. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels o dependencies |
Traslada las funciones esenciales a las habilidades y luego elimina la declaración de Claude. Ponte en contacto con tu socio de OpenAI si el flujo de trabajo principal necesita recibir mensajes de canales. |
.claude-plugin/plugin.json |
Conserva el archivo de manifiesto para subir directamente el archivo comprimido de Claude. El portal lo convierte en .codex-plugin/plugin.json. |
.claude-plugin/marketplace.json, .mcp.json, mcpServers, .app.json o apps |
Evita depender de estos archivos o declaraciones. Si subes un complemento que solo incluye habilidades, se excluye la configuración del servidor MCP. Tampoco puedes enviar una integración existente con un servidor MCP mediante una referencia. |
Prepara y sube el archivo comprimido
- Confirma que la raíz del archivo comprimido o su único directorio de primer nivel contenga
.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 ni credenciales locales sin declarar.
- Completa los campos de la ficha y de la revisión, corrige todos los problemas que detecte el análisis y envía el borrador.
Si el archivo comprimido no cumple los requisitos para subirlo directamente, sigue los pasos de Empaqueta tu complemento para crear el archivo de manifiesto de OpenAI y la estructura del paquete. Consulta los requisitos de las habilidades en Crea habilidades.
Envía un complemento con un servidor MCP remoto
Elige esta opción si el servidor tiene una URL HTTPS pública y estable a la que OpenAI puede acceder. Aunque el servidor haya sido local en el complemento de Claude, puedes enviarlo por esta vía si ya lo implementaste como servicio remoto.
Revisa qué admite OpenAI
| Qué incluye tu integración de Claude | Qué debes 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) |
Implementa el servidor MCP en una URL HTTPS pública o sigue los pasos de Envía complementos exclusivos para escritorio para enviar un complemento MCP local. El portal no acepta archivos .mcpb. |
| Habilidades o directorios personalizados de habilidades declarados en el archivo de manifiesto | Incluye las habilidades en la misma solicitud Con MCP. Conserva cada SKILL.md junto con sus scripts, referencias y recursos. |
| Habilidades que hacen referencia explícita a Claude | En las instrucciones de las habilidades, sustituye las referencias específicas a Claude por expresiones que no dependan del proveedor, como “el modelo”. Conserva el nombre de un producto solo si la instrucción realmente se aplica a ese producto. |
commands, commands/, agents o agents/ |
Convierte cada comando de Markdown en una habilidad, traslada a las habilidades los procedimientos reutilizables de los agentes e incorpora a la habilidad correspondiente las instrucciones útiles sobre el rol que debe adoptar el agente. Así podrás reutilizar esos comportamientos como habilidades. |
hooks o hooks/hooks.json |
Quita los hooks del ciclo de vida antes de enviar el complemento al directorio público. Si el complemento depende de esos hooks, distribúyelo de modo que los usuarios puedan instalarlo manualmente en Codex para escritorio. Consulta Hooks del ciclo de vida. |
userConfig o ${user_config.*} |
OpenAI no muestra las solicitudes de datos que Claude presenta durante la instalación ni expande las variables de user_config. Sigue los pasos de Reemplaza userConfig de Claude para trasladar cada valor a una entrada explícita, a OAuth, al almacenamiento del servicio alojado o a la configuración local de Codex. |
| Habilidades que crean o actualizan artefactos dinámicos de Claude | Por el momento, OpenAI no admite los artefactos dinámicos de Claude. Quita las instrucciones que requieran crear, volver a abrir, recargar o actualizar un artefacto. Devuelve el contenido directamente en la respuesta de la conversación. Por ejemplo, muestra las tablas del artefacto como tablas estándar. No se conservan el HTML, la persistencia, el comportamiento de recarga ni las interacciones propios del artefacto. |
.app.json, apps o una integración existente con un servidor MCP |
Envía directamente el punto de acceso del servidor MCP. No puedes enviar una integración existente con un servidor MCP mediante una referencia. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels o dependencies |
Traslada las funciones esenciales a las habilidades o a las herramientas MCP y luego elimina la declaración de Claude. Ponte en contacto con tu socio de OpenAI si el flujo de trabajo principal necesita recibir mensajes de canales. |
Prepara y envía el servidor MCP
- Implementa 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. Consulta Autentica a los usuarios para conocer los requisitos del producto y la especificación de autorización de MCP que debes seguir.
- Agrega esquemas que describan con precisión las herramientas y añade anotaciones de seguridad. Comprueba que cada herramienta se conecte, se autentique, devuelva resultados con la estructura esperada y exija la confirmación prevista para las acciones de escritura o destructivas.
- Convierte los comandos o agentes que tengas en habilidades y asegúrate de que las habilidades no dependan de paquetes, archivos ni credenciales locales sin declarar.
- Abre el portal de envío de complementos, selecciona Crear complemento, elige Con MCP y envía el punto de acceso de producción. Cuando corresponda, agrega las habilidades convertidas al mismo borrador.
- Verifica el dominio del servidor, configura la autenticación si el servidor requiere iniciar sesión, completa los campos de la ficha y de la revisión, corrige todos los problemas que detecte el análisis y envía el borrador.
Antes de enviar el complemento, ten en cuenta estos dos pasos de configuración:
- Verificación del dominio: debes poder servir el token exacto que proporciona el portal desde
/.well-known/openai-apps-challengeen el host del servidor MCP o en un host de nivel superior permitido. Completa el desafío cuando el portal te lo solicite. Consulta Configura la solicitud para MCP. - OAuth y restricciones de dominio del Espacio de trabajo: si el complemento usa OAuth, expón un punto de acceso UserInfo que devuelva el atributo
emaildel usuario yemail_verified: true. Anuncia y habilita los ámbitosopenidyemail. Consulta Admite restricciones de dominio del Espacio de trabajo.
Antes de enviar el complemento, consulta los requisitos de revisión para servidores MCP remotos.
Reemplaza userConfig de Claude
Los complementos de OpenAI no muestran las solicitudes de datos que Claude define con userConfig para la instalación ni expanden las referencias ${user_config.*}. Elimina esas referencias y reemplaza cada valor según el uso que le dé el complemento.
| Qué controla el valor | Qué usar en OpenAI |
|---|---|
| Una opción que puede cambiar en cada tarea | Agrega una entrada explícita a la habilidad o a la 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 comprimido de habilidades, 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 una entrada de herramienta. |
| Un ajuste para un script o hook local de Codex | Usa una variable de entorno o un archivo de configuración que estén documentados. Comprueba que el ajuste exista antes de usarlo y, si falta, devuelve un error que indique cómo resolverlo. Evita que el flujo de trabajo principal de ChatGPT dependa de este ajuste local. |
| Un valor fijo e idéntico 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 incluye habilidades necesita una credencial o un ajuste que deba persistir entre conversaciones, agrega un servidor MCP. Para el servidor remoto, usa OAuth y almacenamiento en el servicio alojado. Si el valor solo afecta a la tarea actual, mantén el complemento sin servidor MCP y solicita el valor como entrada explícita de la habilidad.
Cumple 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 como persona o empresa. Todos los complementos deben pasar por el proceso de revisión de OpenAI.
Antes de enviar el complemento, ponte en contacto con tu socio de OpenAI si su función principal requiere ejecución local, acceso arbitrario a archivos de la computadora del usuario, acceso a hardware o aplicaciones, funcionamiento sin conexión o recepción de mensajes de canales. Estos casos pueden requerir una revisión específica del producto.
Para conocer el proceso completo en el portal, consulta Envía complementos. Si el portal muestra un código de validación del paquete, consulta la referencia de errores de envío.