Consigue tu token primero — ve Consigue tu token de acceso. Lo necesitas a la mano, porque se muestra una sola vez.
En la página MCP, elige Codex en "¿Qué cliente de IA usas?". La página te muestra entonces la URL del endpoint de este servidor, lista para copiar.
Codex Desktop
Abre Settings → MCP servers y agrega un servidor Streamable HTTP. Dos campos:
| Campo | Valor |
|---|---|
| URL | el endpoint que muestra la página MCP |
| Encabezados | clave Authorization, valor Bearer <tu-token> |
Deja vacío Variable de entorno del token portador. Codex Desktop se abre desde Finder, así que no hereda las variables que exportas en tu terminal; ese campo sólo funciona en el Codex de línea de comandos.
Codex de terminal
Agrega el servidor a ~/.codex/config.toml:
[mcp_servers.weblabor_code_analyzer]
url = "<el endpoint que muestra la página MCP>"
bearer_token_env_var = "WEBLABOR_ANALYZER_TOKEN"
default_tools_approval_mode = "approve"
El token no queda escrito en el archivo. Expórtalo en la misma shell desde la que lanzas Codex:
export WEBLABOR_ANALYZER_TOKEN="<tu-token>"
No limites las herramientas
No agregues enabled_tools con una lista corta. Recortar el servidor a validate_code bloquea install_toolkit, get_standard y get_guide, que son justo las que hacen que todo lo demás funcione.
Comprueba la conexión
Pídele a Codex que corra list_rules. Debe regresar con las reglas configuradas, lo que confirma a la vez que el token sirve y que el analizador está configurado.
Para probar el token antes de configurar Codex, corre esto en tu terminal. La respuesta contiene serverInfo:
curl -X POST <el endpoint que muestra la página MCP> \
-H "Authorization: Bearer <tu-token>" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
Cuando no conecta
| Lo que ves | Causa | Arreglo |
|---|---|---|
| Toda llamada falla como si el token estuviera mal | el endpoint es la URL http, y la redirección quita el encabezado Authorization y el cuerpo |
usa la URL https |
| La app de escritorio falla pero la terminal sirve | se llenó Variable de entorno del token portador en el escritorio | déjalo vacío y agrega el encabezado Authorization |
| Codex dice que una herramienta no existe | el servidor está limitado a unas cuantas herramientas | quita enabled_tools y pídele a Codex que liste las que ve |
Siguiente
Instala el toolkit — los agentes y comandos caen bajo ~/.codex, escritos por el propio Codex.