Conecta Skillry MCP en Codex (CLI, app de ChatGPT y extensión del IDE)

La respuesta corta

1Ejecuta codex mcp add skillry -- npx --yes skillry-cli@latest mcp una vez; en Windows envuelve el arranque en cmd /c.
2Confirma con codex mcp list, o escribe /mcp en la interfaz de Codex.
3La app de escritorio de ChatGPT y la extensión del IDE comparten la entrada: configúrala una vez, úsala en los tres.

Empieza aquí:Añadirlo Comprobarlo Autorizar No funciona

Antes de empezar

Comprobado con la documentación oficial el 28 de octubre de 2026. Aún no se ha ejecutado en una instalación real de este cliente; si algún paso es distinto en tu equipo, usa Informar de un problema al final de la página.

Codex con sesión iniciada: la CLI, la app de escritorio de ChatGPT con Codex, o la extensión del IDE. Comparten una sola configuración.
Node.js 22 o más reciente (node --version). Codex arranca el servidor con npx.
Un .codex/config.toml a nivel de proyecto también funciona, pero solo en proyectos que hayas marcado como confiables. Esta guía usa el archivo global.

Añadir Skillry a Codex

Lo más rápido cuando usas la Codex CLI

1
Ejecuta esto en cualquier terminal:
macOS
```
codex mcp add skillry -- npx --yes skillry-cli@latest mcp
```
Deberías ver: Sin errores, y codex mcp list ahora incluye skillry.
2
En Windows, ejecuta esto en su lugar para que Windows pueda arrancar npx:
Windows (PowerShell o Símbolo del sistema)
```
codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Vuelve a iniciar Codex, o reinicia la app o la extensión si alguna está abierta.
Deberías ver: skillry en la lista de /mcp dentro de Codex.

Sin terminal

1
En la app de escritorio de ChatGPT abre Settings y luego MCP servers. En la extensión del IDE abre el menú del engranaje y luego MCP servers.
2
Elige Add server. Introduce el nombre skillry, elige STDIO e introduce el comando npx --yes skillry-cli@latest mcp (en Windows cmd /c npx --yes skillry-cli@latest mcp).
3
Guarda y luego elige Restart en la app o Restart extension en el IDE.
Deberías ver: skillry listado como habilitado en la lista de servidores MCP.

Cuando mantienes tus ajustes de Codex en el archivo

1
Abre ~/.codex/config.toml en un editor; créalo si no existe.
2
Añade esta tabla al final. Si ya existe una tabla [mcp_servers.skillry], reemplázala.
macOS
```
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]
```

En Windows usa esta tabla en su lugar.

Windows

[mcp_servers.skillry]
command = "cmd"
args = ["/c","npx","--yes","skillry-cli@latest","mcp"]

4
Si el primer arranque agota el tiempo, añade startup_timeout_sec = 60 bajo la tabla. El valor por defecto es 10 segundos, y la primera ejecución de npx descarga el paquete.
5
Guarda y vuelve a iniciar Codex.
Deberías ver: skillry en codex mcp list y en /mcp.

Comprobar que Codex está conectado

1
En una terminal, lista los servidores configurados:
Terminal
```
codex mcp list
```
Deberías ver: skillry con el comando npx que introdujiste.
2
En la interfaz de Codex, escribe /mcp.
Deberías ver: skillry entre los servidores activos, con sus herramientas.

Prueba tu primera búsqueda

Buscar no requiere cuenta, así que es la forma más rápida de comprobar que la conexión funciona.

1
Abre una conversación nueva en Codex y pega esta petición.
Prompt para tu agente
```
Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.
```
Deberías ver: Tres Skills candidatos, cada uno con enlace de vista previa, las entradas que necesita, sus dependencias y cualquier coste externo. No se instala nada.
2
Si el agente responde que no tiene ninguna herramienta de Skillry, o la petición se queda colgada, ve a No funciona.

Autorizar al instalar

Instalar comprueba tu cuenta de Skillry. No escribes ninguna contraseña ni pegas ninguna clave en el agente: la primera vez, abre una página en tu navegador y la apruebas ahí.

1
Pide a Codex que instale el Skill que elegiste, por ejemplo Instálalo para este proyecto.
Deberías ver: El agente informa de que necesita conectar tu cuenta y abre el navegador. En un cliente de terminal puede imprimir el enlace en su lugar; ábrelo tú.
2
Comprueba que el código de dispositivo de la página coincide con el que muestra el agente, inicia sesión en Skillry si te lo pide y elige Approve.
Deberías ver: Authorization approved, con una nota para volver a tu agente. El agente lo detecta en unos segundos y termina la instalación.

La aprobación dura 7 días y se guarda en el llavero de tu sistema operativo (Keychain en macOS, Administrador de credenciales en Windows). Cuando caduca, el agente simplemente te pide aprobar de nuevo. Para cerrar sesión antes, pide al agente que desconecte tu cuenta de Skillry.

Si Codex no ve Skillry

Qué ves	Causa probable	Qué hacer
`skillry` no aparece en `codex mcp list`	La tabla fue a un archivo de proyecto en un proyecto no confiable, o el nombre de la tabla tiene una errata	Pon la tabla en `~/.codex/config.toml` y comprueba que dice exactamente `[mcp_servers.skillry]`.
El servidor nunca está listo, o Codex informa de un tiempo de arranque agotado	La primera descarga de `npx` tardó más que `startup_timeout_sec` (10 segundos por defecto)	Añade `startup_timeout_sec = 60` a la tabla, o ejecuta el comando de arranque una vez a mano para que el paquete quede en caché.
Funciona en la CLI pero no en la app de ChatGPT	La app estaba abierta mientras cambiaba el archivo	Cierra y vuelve a abrir la app de escritorio de ChatGPT, o elige Restart extension en el IDE.
El servidor aparece en la lista pero marcado como fallido, o nunca arranca	`npx` no está instalado, Node.js es anterior a la versión 22, o el primer arranque agotó el tiempo mientras descargaba el paquete	Ejecuta `node --version` y `npx --version` en una terminal. Luego ejecuta una vez a mano `npx --yes skillry-cli@latest mcp`, espera a que arranque, pulsa Ctrl+C y vuelve a probar el cliente: el paquete ya está en caché.
En Windows el servidor se cierra en cuanto arranca	La entrada lanza `npx` directamente, y Windows necesita un shell para ejecutarlo	Usa la entrada para Windows de esta página: el comando es `cmd` y los argumentos empiezan por `/c`, `npx`.
La página del navegador dice que la solicitud es inválida o ha caducado	El código de dispositivo se aprobó demasiado tarde, o pertenece a un intento anterior	Pide al agente que se conecte de nuevo y aprueba el código nuevo en pocos minutos.
La instalación se detiene con un mensaje de Premium o de compra	El Skill es Premium y tu cuenta no tiene ni plan ni compra para él	Sigue el enlace que muestra el agente para comprar el Skill o suscribirte, y vuelve a pedirlo. No se cobra nada hasta que lo hagas.

Quitar o desconectar

1
Borra la tabla [mcp_servers.skillry] de ~/.codex/config.toml, o usa el comando de eliminación que codex mcp --help liste para tu versión. Para apagarlo sin borrarlo, añade enabled = false a la tabla.
2
Reinicia Codex, la app o la extensión.
Deberías ver: skillry desaparece de codex mcp list.

Quitar la entrada no cierra tu sesión en Skillry. Para revocar también la aprobación guardada, pide primero al agente que desconecte tu cuenta de Skillry, o quita la entrada y deja que la aprobación caduque a los 7 días.

Referencia

Elemento	macOS	Windows
Archivo de configuración global	`~/.codex/config.toml`	`%USERPROFILE%\.codex\config.toml`
Archivo de configuración del proyecto	`.codex/config.toml` (solo proyectos confiables)	igual
Comando de arranque	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Comprobar	`codex mcp list` o `/mcp`	igual

La tabla que guarda Codex (macOS)

[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

Los tiempos de espera, las listas de herramientas permitidas y los modos de aprobación están en la documentación oficial de MCP de Codex.

Preguntas frecuentes

¿Lo configuro por separado para la app de escritorio de ChatGPT?

No. La app, la CLI y la extensión del IDE leen el mismo config.toml. Reinicia la app después de cambiarlo.

¿Puedo usarlo en un solo proyecto?

Sí. En un proyecto confiable, pon la tabla en .codex/config.toml dentro de ese proyecto en lugar del archivo global.

¿Por qué el primer arranque es lento?

La primera ejecución de npx descarga skillry-cli. Sube startup_timeout_sec o ejecuta el comando de arranque una vez a mano; después arranca de inmediato.

Fuentes

¿Te ha sido útil esta guía?

AnteriorClaude Code SiguienteCursor