OpenAI MCP Extensions permite a los desarrolladores integrar sus complementos en partes clave de la interfaz de ChatGPT, como la barra lateral, el editor y los visores de archivos.
Las extensiones de complementos pronto estarán disponibles en la web para quienes usen ChatGPT Gratis o ChatGPT Go. Los complementos existentes seguirán funcionando como hasta ahora. Las menciones en el editor solo están disponibles en la app de escritorio de ChatGPT.
Prueba las extensiones
Explora las extensiones con Bits & Bolts, nuestro complemento que reúne ejemplos de todas ellas. Lo actualizaremos a medida que lancemos nuevas extensiones.
Empieza a desarrollar
Consulta el repositorio de GitHub para ver las instrucciones de instalación, los ejemplos de los SDK y la especificación completa.
Agrega extensiones a tu servidor MCP y a la interfaz de tu app.
Agrega extensiones del lado del servidor con el SDK de MCP para Python.
Define la API formal e independiente del lenguaje de programación que amplía las especificaciones de MCP y MCP Apps.
Cuando tu servidor esté listo, conecta y prueba tu complemento y luego empaquétalo para distribuirlo.
Referencia de extensiones
Las extensiones ofrecen a los usuarios nuevas formas de interactuar con tu complemento en ChatGPT. Bastan unas pocas líneas de código del SDK para indicar que tu complemento admite una extensión.
| Extensión | Qué pueden hacer los usuarios | |
|---|---|---|
| Apps de la barra lateral | Permite que los usuarios abran tu app desde la barra lateral y trabajen en ella en pantalla completa. | |
| Paneles de conversación | Permite que los usuarios abran tu app junto a una conversación para tener a la vista tanto su trabajo como el chat. | |
| Configuración del complemento | Permite que los usuarios ajusten las opciones propias de tu complemento desde ChatGPT. | |
| Visores y editores de archivos | Abre archivos compatibles en tu propia interfaz, donde los usuarios pueden leerlos, ver actualizaciones en tiempo real y guardar cambios. | |
| Modos de visualización | Elige dónde y cómo aparece tu app en las conversaciones de ChatGPT. | |
| Enlaces profundos | Lleva a los usuarios directamente a una página o un elemento específico de tu app de la barra lateral. | |
| Contexto ampliado del modelo | Controla las anotaciones y la forma en que se muestra el contexto adjunto en el editor. | |
| Opciones ampliadas de envío de mensajes | Envía mensajes a la conversación actual. En la app de escritorio y en el modo Work en la web, también puedes enviarlos a una conversación nueva. | |
| Menciones en el editor | Permite que los usuarios busquen y seleccionen contenido de tu complemento en el editor de la app de escritorio de ChatGPT. | |
| Formularios ampliados | Pide a los usuarios que ingresen datos estructurados o permíteles elegir entre varias imágenes. Luego devuelve su respuesta a tu herramienta. | |
| Configuración inicial del complemento | Guía a los usuarios durante la configuración en una conversación nueva o existente. |
Apps de la barra lateral
Agrega un acceso a la barra lateral global para abrir tu MCP App en pantalla completa.
Pasa estos metadatos en _meta al registrar la herramienta de tu MCP App. Reemplaza ui://parts/library por el URI del recurso de interfaz que registraste:
import type { OpenAIUiToolMetadata } from "@openai/mcp-extensions/server";
const toolMetadata = {
ui: { resourceUri: "ui://parts/library" },
"openai/ui": {
entrypoints: [{ type: "global" }],
} satisfies OpenAIUiToolMetadata,
};Usa { type: "thread" } para agregar un punto de entrada en el panel lateral de una conversación. Consulta la guía de puntos de entrada para ver ejemplos completos de registro.
Visores y editores de archivos
Abre tu MCP App en el panel lateral de la conversación cuando un usuario abra un archivo con una extensión compatible.
En _meta de tu herramienta, define un punto de entrada para archivos e indica las extensiones que admite tu visor:
import type { OpenAIUiToolMetadata } from "@openai/mcp-extensions/server";
const toolMetadata = {
ui: { resourceUri: "ui://parts/viewer" },
"openai/ui": {
entrypoints: [{ type: "file", extensions: ["stl"] }],
} satisfies OpenAIUiToolMetadata,
};Reemplaza ui://parts/viewer por el recurso de interfaz que registraste. La app recibe el URI del recurso correspondiente al archivo abierto. Sigue la guía de manejo de archivos para recibir ese URI y leer el recurso con el SDK de la app.
Formularios ampliados
Amplía los formularios estándar de MCP con componentes nativos de ChatGPT que ofrecen más opciones de interacción.
import type {
OpenAIForm,
OpenAIFormOption,
} from "@openai/mcp-extensions/server";
function partSelectionSchema(parts: OpenAIFormOption[]): OpenAIForm {
return {
type: "object",
properties: {
part: {
type: "string",
title: "Part",
oneOf: parts,
},
},
required: ["part"],
};
}Pasa este esquema como requestedSchema en la solicitud del formulario. Cada opción usa const y title y puede incluir un ícono en x-openai-thumbnail.
Los servidores MCP registrados en OpenAI requieren solicitudes con múltiples intercambios de ida y vuelta (MRTR).
Extensiones en la práctica
Descubre cómo aprovechan las extensiones algunos complementos que ya conoces.
Canva
Las pestañas de la barra lateral permiten a los usuarios de Canva crear diseños y previsualizarlos directamente en la barra lateral de ChatGPT, como parte de su interfaz nativa.
Figma
Las menciones en el editor permiten a los usuarios de Figma buscar y mencionar archivos directamente en la app de escritorio de ChatGPT.
Adobe
Los controladores de extensiones de archivo permiten a los usuarios de Adobe editar archivos con Acrobat y Photoshop directamente en ChatGPT.