Qué vas a crear

Cada complemento basado en MCP tiene tres partes:

• Un servidor MCP que define las herramientas, devuelve datos, aplica los controles de acceso e indica a ChatGPT dónde encontrar los recursos de la interfaz.
• Un componente web opcional que se muestra dentro de un iframe de ChatGPT. Puedes crearlo con React o directamente con HTML, CSS y JavaScript.
• Un modelo que decide cuándo llamar a las herramientas del complemento según los metadatos que le proporciones.

Codex resulta más útil cuando se encarga de las tareas de ingeniería repetitivas que requieren esas partes:

• Planificar qué herramientas ofrecer y qué metadatos incluir.
• Crear la estructura inicial del servidor y del widget.
• Configurar los scripts de ejecución local.
• Incorporar los cambios de autenticación y despliegue en etapas separadas.
• Escribir una rutina de verificación que permita comprobar que el complemento funciona en ChatGPT.

Por qué conviene usar Codex

• Los complementos basados en MCP se dividen en tres partes bien definidas: un servidor, una interfaz opcional y las llamadas a herramientas que decide hacer el modelo.
• Los prompts para Codex funcionan mejor cuando la tarea es explícita, tiene un alcance definido y es fácil de verificar. El desarrollo de complementos se presta a este tipo de tareas.
• Las habilidades y AGENTS.md le dan a Codex instrucciones reutilizables y reglas del proyecto que le sirven de referencia.

Para saber más sobre cómo instalar y usar habilidades, consulta nuestra documentación sobre habilidades.

Cómo usar Codex

Requisitos previos

• Empieza por definir qué tarea principal podrá realizar el usuario, en vez de intentar trasladar todo un producto al chat.
• Elige desde el principio las tecnologías que vas a usar: TypeScript o Python para el servidor y React o directamente HTML, CSS y JavaScript para el widget.
• Decide cómo accederás al servidor por HTTPS durante el desarrollo, por ejemplo, con ngrok o Cloudflare Tunnel.
• Algunas opciones de configuración todavía usan términos anteriores para la conexión a un servidor MCP. Durante las pruebas locales, ten en cuenta que esas etiquetas se refieren al servidor registrado.

1. Define una tarea concreta que el usuario podrá realizar con el complemento y pídele a Codex que proponga de tres a cinco herramientas con nombres, descripciones, entradas y salidas claros.
2. Decide si la primera versión puede limitarse a devolver datos o si necesita un widget. Luego crea la estructura inicial del servidor MCP y del widget opcional siguiendo los patrones del repositorio antes de agregar dependencias.
3. Ejecuta el servidor MCP de forma local y habilita el acceso por HTTPS. Conéctalo en ChatGPT con Agregar servidor MCP personalizado y pruébalo con un conjunto pequeño de prompts directos, indirectos y negativos.
4. Ajusta los metadatos, el manejo del estado y el contenido de structuredContent y _meta hasta que el flujo principal de lectura funcione de manera confiable en ChatGPT.
5. Agrega OAuth 2.1 solo cuando lo requieran los datos específicos de cada usuario o las operaciones de escritura, sin complicar los flujos anónimos o de solo lectura.
6. Prepara una versión de prueba alojada con un punto de acceso /mcp estable. Verifica la transmisión de respuestas y el alojamiento de los recursos de la interfaz, y repasa la lista de verificación para el lanzamiento antes de compartir el complemento o enviarlo a revisión.

Prompts sugeridos

Los prompts eficaces para este flujo de trabajo tienen varios elementos en común:

• Un objetivo claro: indica qué tarea podrá realizar el usuario con el complemento en ChatGPT.
• Tecnologías concretas: indica si quieres usar TypeScript o Python en el servidor y si el widget debe usar React o ser ligero.
• Un alcance explícito para cada herramienta: pídele a Codex que proponga o cree un conjunto pequeño de herramientas, cada una con una sola función.
• Requisitos de autenticación: indica si la primera versión puede permitir el acceso anónimo o si necesita cuentas vinculadas y operaciones de escritura.
• Una vía de acceso para el desarrollo local: especifica qué túnel o servicio de alojamiento piensas usar para las pruebas por HTTPS en ChatGPT.
• Pasos de verificación: dile a Codex qué comandos ejecutar, qué prompts probar y qué evidencias presentar.

Evita pedir en un solo prompt extenso que Codex se encargue de la planificación, la implementación, la autenticación, el despliegue, el envío a revisión y los ajustes finales. Divide el trabajo en etapas más pequeñas.

Planifica el complemento antes de crear su estructura inicial

Crea la estructura inicial de la primera versión funcional

Agrega la autenticación solo cuando funcione el flujo principal

Prepara el complemento para el despliegue y la revisión

Preparación para el lanzamiento

• El complemento permite realizar una tarea concreta que los usuarios pueden entender.
• El conjunto de herramientas es pequeño y cada herramienta tiene metadatos, entradas y salidas explícitos.
• El servidor MCP funciona de extremo a extremo, devuelve un structuredContent conciso y reserva _meta para los datos que solo usa el widget.
• El widget, si se necesita, se muestra correctamente en ChatGPT.
• Puedes repetir las pruebas locales por HTTPS con el servidor MCP personalizado conectado en ChatGPT.
• Un conjunto pequeño de prompts directos, indirectos y negativos pasa las pruebas: tanto el flujo de la conversación como los datos de las llamadas a herramientas coinciden con lo esperado.
• La autenticación se usa solo cuando la requieren los datos específicos de cada usuario o las operaciones de escritura.
• El plan de despliegue y la revisión previa al lanzamiento cubren los metadatos, las indicaciones de uso de las herramientas, la privacidad y los prompts de prueba antes de compartir el complemento o enviarlo a revisión.

Errores frecuentes

• Pedirle a Codex que traslade todo el producto a ChatGPT. Define una tarea principal para el usuario y pide de tres a cinco herramientas y un widget de alcance limitado.
• Empezar con un prompt de implementación demasiado extenso. Divide el trabajo en etapas de planificación, creación de la estructura inicial, autenticación, despliegue y revisión.
• Crear la interfaz antes de definir el contrato de las herramientas. Primero define qué herramientas ofrecerás y qué esquema tendrán sus respuestas. Luego crea el widget.
• Omitir el anclaje en la documentación oficial. Usa $chatgpt-apps junto con $openai-docs para que la estructura inicial siga las pautas vigentes para complementos.
• Dejar los metadatos para el final. Escribe desde el principio las descripciones de las herramientas y la documentación de sus parámetros. Luego vuelve a ejecutar un conjunto de prompts para probarlos.
• Agregar autenticación antes de verificar el flujo anónimo o de solo lectura. Primero comprueba que funcione el flujo principal de las herramientas y luego agrega OAuth a las que lo necesiten.
• Dar por terminado el complemento antes de probarlo en ChatGPT. Conecta el servidor MCP personalizado en ChatGPT, inspecciona los datos de las llamadas a herramientas y verifica el flujo real de la conversación.