Los complementos exclusivos para escritorio deben ejecutarse de forma local en la computadora del usuario. Entre ellos se encuentran la mayoría de los complementos que usan un servidor MCP local (stdio) y todos los que invocan programas locales. En el directorio de complementos de OpenAI, llevan la etiqueta Solo para escritorio y solo se pueden instalar desde la aplicación de escritorio de ChatGPT. Los usuarios solo pueden mencionarlos en hilos que se ejecuten de forma local.
Se requiere aprobación: solo los socios aprobados pueden enviar complementos con un servidor MCP local. Ponte en contacto con tu representante de OpenAI para confirmar que cumples los requisitos y gestionar la inclusión de tu organización en la lista de organizaciones autorizadas. Sigue estos pasos solo cuando la organización que enviará el complemento ya figure en esa lista.
Antes de enviarlo, empaqueta tu complemento, prueba una instalación limpia en el escritorio y verifica que funcionen sus principales flujos de trabajo. Cumple los requisitos previos de envío habituales, entre ellos obtener acceso para realizar envíos y verificar tu identidad como desarrollador o empresa.
Configurar un servidor MCP local
Usa la misma estructura de complementos que para cualquier otro complemento. En el archivo mcp.json del directorio raíz, reemplaza la entrada del servidor HTTP dentro de mcpServers por una entrada de stdio que defina el comando para iniciar el servidor de forma local.
El servidor puede usar cualquier lenguaje o entorno de ejecución que admita MCP a través de stdio. Por ejemplo, la entrada de un servidor Node.js podría verse así:
{
"type": "stdio",
"command": "node",
"args": ["${PLUGIN_ROOT}/server/dist/index.js"],
"cwd": "${PLUGIN_ROOT}"
}Incluye el servidor y sus dependencias en el paquete. ${PLUGIN_ROOT} es un marcador de posición predefinido.
Enviar un complemento con un servidor MCP local
- Busca el ID de la organización que enviará el complemento en la configuración de la organización en la plataforma de OpenAI.
- Envía el ID a tu representante de OpenAI y pídele que gestione la inclusión de tu organización en la lista de organizaciones autorizadas para enviar complementos con un servidor MCP local. Espera la confirmación antes de enviar el complemento.
- Abre el portal de envío de complementos, selecciona Crear complemento y elige Solo habilidades. Usa Subir ZIP para subir el paquete del complemento con la configuración del servidor MCP local.
- Cumple los requisitos de envío y envía el complemento a revisión. Una vez aprobado, publícalo desde el portal.
Complementos sin servidor MCP
Si tu complemento contiene solo habilidades y debe ejecutarse en el escritorio, establece requires_local_executor en true dentro de extensions.com.openai en el archivo plugin.json del directorio raíz:
{
"extensions": {
"com.openai": {
"requires_local_executor": true
}
}
}Si tienes un paquete heredado que usa .codex-plugin/plugin.json, agrega "requires_local_executor": true directamente en el nivel superior de ese archivo de manifiesto.
Esta opción marca tu complemento como Solo para escritorio. Sigue el proceso habitual de envío. Si el portal indica que el campo no está permitido, envía el ID de la organización que realiza el envío a tu representante de OpenAI para confirmar que la organización tiene acceso para enviar complementos.