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 Gemini CLI como tu cliente. La página te muestra entonces la URL del endpoint de este servidor, lista para copiar.
Gemini CLI corre en tu máquina, así que aquí localhost sí funciona: a diferencia del conector remoto de Claude, el endpoint no tiene que ser público ni alcanzable desde internet.
Agrega el servidor
Escribe esto en ~/.gemini/settings.json para todos los proyectos, o en .gemini/settings.json dentro de uno:
{
"mcpServers": {
"weblabor": {
"httpUrl": "<el endpoint que muestra la página MCP>",
"headers": { "Authorization": "Bearer ${WEBLABOR_ANALYZER_TOKEN}" },
"timeout": 30000
}
}
}
El timeout va en milisegundos.
httpUrl, no url
Esto es lo único que hay que atinar aquí. Los dos campos son direcciones, y significan transportes distintos:
| Campo | Transporte |
|---|---|
httpUrl |
Streamable HTTP — lo que habla este servidor |
url |
SSE |
Todos los demás clientes le llaman url a su campo de dirección, así que el copiar y pegar natural deja el endpoint bajo url y le apunta el transporte equivocado. No conecta nada, y la URL, el encabezado y el token están todos bien — que es justo lo que hace que éste te lleve una tarde encontrarlo.
Deja el token fuera del archivo
Gemini CLI sustituye $VAR y ${VAR} dentro de los valores de texto, así que el encabezado de arriba lee el token del entorno en lugar de cargarlo. ~/.gemini/.env es el lugar más limpio para tenerlo, porque las variables de un .gemini/.env nunca se filtran:
WEBLABOR_ANALYZER_TOKEN="<tu-token>"
Aplica un cambio
Reinicia la CLI después de editar cualquiera de los dos archivos. Ésa es la instrucción que siempre funciona.
No limites las herramientas
Deja el servidor con todas sus herramientas. Recortarlo 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
Corre /mcp: lista los servidores y el estado de cada uno. Luego pide 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 la CLI, 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 |
|---|---|---|
/mcp muestra el servidor desconectado y todo en el archivo se ve bien |
el endpoint está bajo url, que significa SSE |
muévelo a httpUrl |
| Toda llamada falla como si el token estuviera mal | la variable no está donde la CLI puede leerla | ponla en ~/.gemini/.env y reinicia la CLI |
| Nada cambia después de editar el archivo | la CLI sigue corriendo con lo que leyó al arrancar | reiníciala |
Qué sirve desde aquí
El analizador, los estándares y las guías sirven hoy desde Gemini CLI: se leen a través de las herramientas del servidor y no se escribe nada en tu disco, así que no hay nada que instalar para eso.
Los agentes y los comandos son archivos, y todavía no se escriben para Gemini CLI — ve Instala el toolkit para saber qué clientes los reciben.
Siguiente
Analiza un archivo — qué pedir y qué regresa.
