Del SDK de aplicaciones a los complementos de ChatGPT
En esta página
Curso reescrito el 3 de noviembre de 2026 basándose en la documentación de Complementos de OpenAI. La versión anterior dependía de un paquete
@openai/apps-sdkinexistente (que incluíadefineAction,defineWidgety un manifiestochatgpt-app.json). Ahora construyes aplicaciones de ChatGPT utilizando el protocolo MCP, sus SDK oficiales y el estándar de interfaz MCP Apps. Hemos reescrito las catorce lecciones y eliminado las listas de compatibilidad de modelos no admitidas, las estructuras de comisiones y los pasos de publicación de la versión antigua. Fuentes: Inicio rápido · Arquitectura de complementos.
¿Qué es un complemento?
Un complemento es el paquete que descubres, instalas, compartes y publicas dentro de ChatGPT y Codex. Amplía las capacidades del asistente proporcionando nuevos conocimientos, herramientas o ambos. La documentación de OpenAI identifica cuatro bloques de construcción:
- Habilidades (Skills), que proporcionan al modelo instrucciones y recursos para gestionar flujos de trabajo recurrentes;
- Un servidor MCP, que expone herramientas y conecta el asistente a sistemas externos: tu API, base de datos o servicio;
- Ambos, cuando el modelo necesita tanto un manual de procedimientos como capacidades servidas por tu infraestructura;
- Ganchos del ciclo de vida (Lifecycle hooks), comandos ejecutados en momentos específicos del entorno de ejecución de Codex, incluido dentro de ChatGPT Work.
ChatGPT y Codex comparten un único directorio de complementos: un complemento público se publica una vez y se hace visible en todas las superficies compatibles de ambos productos. Algunas capacidades siguen siendo específicas de la superficie; por ejemplo, un script de gancho debe existir en el entorno de ejecución, por lo que instalar el complemento en la web no lo despliega automáticamente allí.
¿Qué ocurre con el «SDK de aplicaciones»?
Este término hace referencia al conjunto de herramientas de OpenAI para crear aplicaciones dentro de ChatGPT: el protocolo MCP y sus SDK oficiales, el estándar abierto MCP Apps que ChatGPT implementa para renderizar interfaces, extensiones específicas de ChatGPT, un sistema de diseño (@openai/apps-sdk-ui) y un repositorio de ejemplos. La documentación agrupa ahora estos elementos bajo «Complementos de ChatGPT y SDK de aplicaciones»: una aplicación se centra en un servidor MCP, incluye una interfaz opcional y se distribuye como parte de un complemento.
La elección de MCP es deliberada. El Protocolo de Contexto de Modelo (Model Context Protocol) es una especificación abierta para conectar clientes de IA con herramientas y datos. El servidor que escribes para ChatGPT habla un protocolo que otros hosts entienden, y una interfaz compatible con MCP Apps funciona en cualquier host que admita ese estándar.
Cuatro formas posibles
Comienza con la forma más pequeña que cubra tus casos de uso; puedes añadir un servidor o una interfaz más tarde sin cambiar el propósito central del complemento.
| Forma | Elige esta cuando |
|---|---|
| Solo habilidades | Las instrucciones y herramientas existentes son suficientes para gestionar el flujo de trabajo |
| Solo servidor MCP | El complemento necesita herramientas MCP pero no instrucciones adicionales de flujo de trabajo |
| Habilidades y servidor MCP | Las habilidades deben guiar al modelo a través de flujos de trabajo que utilizan tus herramientas |
| Servidor MCP con interfaz | La interacción visual mejora significativamente parte del flujo de trabajo |
Un complemento que redacte actas de reuniones según las normas de tu empresa podría necesitar solo habilidades. En cuanto deba leer datos en tiempo real, autenticar a un usuario o actuar dentro de un sistema que tú operas, requerirá un servidor MCP. Por último, una interfaz nunca es obligatoria: una herramienta debe seguir siendo útil sin ella.
Dónde se ejecuta el complemento
En ChatGPT, invocas un complemento instalado directamente escribiendo @ en el campo de entrada y seleccionándolo. El modelo también puede llamarlo automáticamente cuando una solicitud coincide con sus herramientas o habilidades. La guía de inicio rápido de OpenAI recomienda probar tu primer complemento en ChatGPT Work, la pestaña Work en la página de inicio web de ChatGPT. Los mismos complementos aparecen en Codex, limitados por las capacidades específicas de cada superficie.
Qué vas a construir
Este curso sigue la ruta descrita en la documentación. Comenzarás definiendo tus herramientas basándote en las necesidades del usuario, conectarás un primer servidor MCP a ChatGPT y luego construirás el tuyo propio: herramientas bien documentadas, una interfaz MCP Apps donde aporte valor, autenticación OAuth para datos privados y, si tu modelo de negocio lo permite, un flujo de compra utilizando la API de Checkout. Terminarás con el empaquetado, las normas de publicación y el envío al directorio.
Puntos clave
- Un complemento combina habilidades, un servidor MCP o ambos; la interfaz es opcional
- ChatGPT y Codex comparten un único directorio de complementos
- «SDK de aplicaciones» se refiere a las herramientas de OpenAI para crear aplicaciones: MCP, el estándar MCP Apps, las extensiones de ChatGPT y el sistema de diseño
- No existe ningún paquete
@openai/apps-sdk: comienza con los SDK oficiales de MCP - Elige la forma de complemento más pequeña que cubra tus casos de uso