For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme
Descripción general Documentación para usuarios de ChatGPT y Codex Casos de uso

Registro de cambios de la interfaz de los complementos

Últimas actualizaciones de las API de compatibilidad con la interfaz de los complementos y de las extensiones de ChatGPT.

August 2026

  • URL de redirección estables de OAuth e identificadores de cliente CIMD

    Correcciones y mejoras

    • Las apps de ChatGPT pueden usar la URL de redirección estable de OAuth https://chatgpt.com/connector_platform_oauth_redirect cuando su recurso protegido y sus metadatos de OAuth identifican el mismo servidor de autorización y ese servidor admite la identificación del emisor según el RFC 9207.

    • Las apps que usan documentos de metadatos de identificadores de cliente (CIMD) también pueden usar https://chatgpt.com/oauth/client.json como identificador de cliente estable. Los servidores que no admiten la identificación del emisor siguen gestionando las redirecciones como hasta ahora. Más información.

July 2026

  • Los metadatos anteriores de visibilidad de herramientas quedan obsoletos

    Correcciones y mejoras

    • _meta["openai/visibility"] quedó obsoleto porque el valor private oculta la herramienta al modelo sin indicar si la app puede verla. Esto puede generar dudas sobre quién debería tener acceso a la herramienta. Usa _meta.ui.visibility para elegir si la herramienta está disponible para el modelo, para la app o para ambos.

June 2026

  • Controles de permisos de las apps en ChatGPT

    Correcciones y mejoras

    • Ahora puedes elegir cuándo deben pedirte permiso las apps conectadas a ChatGPT: siempre, antes de hacer cambios o solo antes de hacer cambios importantes. Si tienes una cuenta personal, puedes configurar tus preferencias globales y por app. En Business y Enterprise, los administradores definen la configuración predeterminada para el Espacio de trabajo y para cada app.

May 2026

  • Variables de estilo del host de MCP Apps

    Correcciones y mejoras

    • Durante la inicialización, ChatGPT ahora proporciona las variables CSS estandarizadas del host de MCP Apps mediante hostContext.styles.variables. Cuando cambia el tema del host, ChatGPT las actualiza mediante ui/notifications/host-context-changed. Esto ayuda a las apps a adaptarse a los modos claro y oscuro de ChatGPT sin tener que definir en el código colores específicos del host.

  • Cambios en el ciclo de vida de las herramientas de MCP Apps

    Correcciones y mejoras

    • Cuando ChatGPT inicia un widget, window.openai.toolResponseMetadata ahora conserva la estructura canónica que contiene el resultado de la herramienta MCP, incluido el campo oculto _meta.

    • Si una herramienta requiere la aprobación del usuario, ChatGPT ahora envía al widget los datos de entrada de la herramienta mediante la notificación ui/notifications/tool-input del ciclo de vida de MCP Apps una vez que el usuario da su aprobación, en lugar de precargar esos datos en las variables globales iniciales del widget.

  • Instrucciones del servidor MCP

    Correcciones y mejoras

    • ChatGPT ahora lee las instrucciones que devuelve el servidor MCP durante la inicialización y las usa junto con los metadatos de las herramientas para comprender los flujos de trabajo que combinan varias herramientas, las restricciones y las pautas que se aplican a todo el servidor.

  • Ejemplos de esquemas de salida

    Correcciones y mejoras

    • La documentación sobre la interfaz de usuario de los complementos y el servidor MCP ahora incluye outputSchema en los ejemplos de herramientas y recomienda declarar un esquema de salida para las herramientas que devuelven contenido estructurado.

March 2026

  • Guía para distribuir complementos

    Correcciones y mejoras

    • Las integraciones aprobadas de Apps SDK podían distribuirse como complementos de Codex. En el momento del lanzamiento, los complementos solo estaban disponibles en Codex.

  • Funciones auxiliares de window.openai para la biblioteca de archivos

    Correcciones y mejoras

    • window.openai.selectFiles() permite que los widgets seleccionen archivos que ya están en la biblioteca de archivos del usuario en ChatGPT cuando esa biblioteca está disponible.

    • window.openai.uploadFile(file, { library: true }) permite que los widgets guarden los archivos subidos en la biblioteca de archivos del usuario en ChatGPT cuando esa biblioteca está disponible.

  • Carga de archivos que no son imágenes

    Correcciones y mejoras

    • window.openai.uploadFile ahora admite otros tipos de archivo además de las imágenes.

February 2026

  • Compatibilidad con MCP Apps

  • Actualizaciones de la interfaz de los complementos para las redirecciones, las descripciones de widgets y el desplazamiento al enviar mensajes de seguimiento

    Correcciones y mejoras

    • window.openai.openExternal({ href, redirectUrl }) admite redirectUrl: false, lo que evita que el host agregue ?redirectUrl=... al final de los enlaces externos.

    • window.openai.setOpenInAppUrl({ href }) es el método admitido para cambiar el destino de “Abrir en ” en la vista de pantalla completa. Si no lo llamas, ChatGPT sigue abriendo la ruta actual del iframe del widget.

    • openai/widgetDescription se tiene en cuenta al construir el recurso y, si está presente, tiene prioridad sobre resource.description.

    • window.openai.sendFollowUpMessage admite el parámetro scrollToBottom. Su valor predeterminado es true y puedes pasar false para desactivar el desplazamiento automático hasta el final.

January 2026

  • Guía de compatibilidad con el conocimiento de la empresa

  • Metadatos de sesión para llamadas a herramientas y cambio de plantilla con requestModal

    Correcciones y mejoras

    • Las llamadas a herramientas ahora incluyen _meta["openai/session"], un identificador anonimizado de la conversación que puedes usar para correlacionar solicitudes dentro de una misma sesión de ChatGPT.

    • window.openai.requestModal({ template }) ahora te permite abrir otra plantilla de interfaz registrada si le pasas el URI de la plantilla que obtienes de registerResource.

November 2025