Ir al contenido principal
Español— Elegir un idioma
Menú

Del SDK de aplicaciones a los complementos de ChatGPT

Lección 1 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. ¿Qué es un complemento?
  2. ¿Qué ocurre con el «SDK de aplicaciones»?
  3. Cuatro formas posibles
  4. Dónde se ejecuta el complemento
  5. Qué vas a construir
  6. Puntos clave

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-sdk inexistente (que incluía defineAction, defineWidget y un manifiesto chatgpt-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.

FormaElige esta cuando
Solo habilidadesLas instrucciones y herramientas existentes son suficientes para gestionar el flujo de trabajo
Solo servidor MCPEl complemento necesita herramientas MCP pero no instrucciones adicionales de flujo de trabajo
Habilidades y servidor MCPLas habilidades deben guiar al modelo a través de flujos de trabajo que utilizan tus herramientas
Servidor MCP con interfazLa 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