Conectar Codex
Codex se conecta al servidor MCP de LanaChat mediante un bloque en su archivo de configuración, config.toml. Necesita Codex instalado (guía) y su token (guía); lleva dos minutos.
La aplicación de escritorio de ChatGPT, el CLI de Codex y la extensión de Codex para editores de código comparten este único archivo, así que configura LanaChat una sola vez para los tres. ChatGPT en el navegador web no lo lee: use la aplicación de escritorio o el CLI.
¿Dónde está el archivo? #
- Mac y Linux:
~/.codex/config.toml(la carpeta oculta.codexen su carpeta personal). - Windows:
%USERPROFILE%\.codex\config.toml.
Si el archivo todavía no existe, créelo. Es un archivo de texto simple.
Añada el bloque #
Abra el archivo en un editor de texto y añada estas líneas al final. Sustituya YOUR_MCP_TOKEN por su token.
[mcp_servers.lanachat]
url = "https://api.lanachat.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_MCP_TOKEN" }
Guarde el archivo.
Más seguro: mantenga el token fuera del archivo #
Codex puede leer el token desde una variable de entorno. Use este bloque en lugar del anterior:
[mcp_servers.lanachat]
url = "https://api.lanachat.ai/mcp"
bearer_token_env_var = "LANACHAT_MCP_TOKEN"
Luego defina la variable antes de iniciar Codex. En Mac o Linux:
read -s LANACHAT_MCP_TOKEN && export LANACHAT_MCP_TOKEN && codex
Pegue el token cuando el cursor espere (no se muestra nada), pulse Intro y Codex se inicia con el token.
¿Cómo compruebo que está conectado? #
- Inicie Codex:
codex. - Escriba
/mcpy pulse Intro. lanachatestá en la lista de servidores activos.
Desde el terminal, codex mcp list muestra los servidores configurados. En la aplicación de escritorio, escriba /mcp en el cuadro de mensajes para ver los servidores conectados.
Pruébelo #
Pregunte a Codex, con palabras simples: List my LanaChat creators. Codex llama a una herramienta de LanaChat y responde con sus creadoras. Si lo hace, está conectado. La prueba completa está en Pruebe la conexión.
Errores frecuentes #
| Lo que ve | Causa probable y solución |
|---|---|
lanachat no está en la lista de /mcp | El bloque está en el archivo equivocado o tiene una errata. Revise la ruta de arriba y los corchetes, guarde y reinicie Codex. |
401 o "invalid or expired MCP grant" | El token es incorrecto, ha caducado o se rotó. Cree o copie de nuevo el token (guía) y actualice el archivo. |
| La variable está vacía | Con bearer_token_env_var, Codex debe iniciarse desde el mismo terminal en el que definió la variable. |
| Falta una herramienta | El token no la permite. Cambie las casillas del token con Edit y reinicie Codex. |
Más ayuda: Solución de problemas.
Nota Estos pasos siguen la documentación oficial de Codex sobre servidores MCP (página "MCP", en la documentación de Codex).
Nota Tras una rotación del token, ponga el token nuevo en el archivo (o en la variable) y reinicie Codex. Después de cambiar las casillas del token con Edit, reinicie Codex también.
Siguiente: pruebe la conexión.
FAQ #
¿Funciona con ChatGPT? #
Sí, con la aplicación de escritorio de ChatGPT, que lee el mismo config.toml. ChatGPT en el navegador web no lo lee.
¿El token debe estar en el archivo o en una variable? #
Una variable es más segura: con bearer_token_env_var, el token nunca queda en el archivo. El archivo también sirve, siempre que nunca vaya a Git ni a una carpeta compartida.
¿Por qué falta lanachat en /mcp? #
El bloque está en el archivo equivocado o tiene una errata. Revise la ruta y los corchetes, guarde y reinicie Codex.