Cargando…

Esto está tardando más de lo esperado.

Conecta Gemini CLI

Agrega el servidor a Gemini CLI, bajo el campo que de verdad significa Streamable HTTP.

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.

La página MCP con Gemini CLI elegido, con el bloque de settings.json y el aviso sobre httpUrl

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.