Conectar Gemini CLI con tu estudio

Qué es

Gemini CLI es Gemini de Google, que se ejecuta en la terminal de la computadora. Con el conector de IA, consulta los datos de tu estudio (ventas, clientes, agenda y finanzas) cuando haces una pregunta, con los permisos del usuario de la clave. Solo consulta: no modifica nada en el sistema.

Cuándo usarlo

Ya usas Gemini en la terminal y quieres preguntar sobre la actividad del estudio sin abrir el sistema.
Quieres combinar los datos del sistema con otras tareas que Gemini hace por ti.

Antes de empezar

Ten a mano la dirección del conector, copiada según el artículo Conecta tu IA, y una clave de API con “Permitir uso como conector de IA”. Gemini CLI debe estar instalado en la computadora. También puedes iniciar sesión en el sistema: sin el encabezado de la clave, escribe /mcp auth heya en Gemini CLI e inicia sesión en la pantalla que se abra.

Paso a paso

Paso 1 — Agregar el conector

En la terminal, ejecuta el siguiente comando y reemplaza la dirección por la que copiaste en Copiar dirección y hk_... por tu clave:

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

Para usarlo en todas las carpetas de la computadora, agrega -s user. Si prefieres editar el archivo de configuración (~/.gemini/settings.json), este es el fragmento:

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Usa httpUrl, no url: en Gemini CLI, url es el formato de conexión antiguo y no funciona con el conector.

Paso 2 — Comprobar la conexión

Abre Gemini CLI y escribe /mcp. El conector heya debe aparecer como CONNECTED, con las herramientas listar_areas, buscar_ferramentas y executar_consulta.

Paso 3 — Hacer una pregunta

Por ejemplo, pregunta: “¿qué gastos vencen esta semana en el estudio?”.

Qué pasa después

Gemini busca la consulta adecuada para la pregunta, la ejecuta y responde con los datos del sistema.
La clave aparece en la pestaña Clave de API con Último uso actualizado.
Para retirar el acceso, revoca la clave en la pestaña Clave de API: Gemini perderá el acceso en un máximo de 30 segundos.

Errores comunes y dudas

P: ¿Funciona en Gemini del navegador (gemini.google.com)? R: Todavía no. Gemini del navegador requiere un inicio de sesión propio en lugar de una clave de API. Usa Gemini CLI.

P: /mcp muestra DISCONNECTED. ¿Qué hago? R: Comprueba que hayas usado httpUrl (y no url), que la dirección termine en /mcp y que hayas pegado la clave completa, con Bearer y un espacio después.

P: Gemini dice que la clave debe tener “Permitir uso como conector de IA”. ¿Por qué? R: La clave se creó sin esa opción. Edita la clave en la pestaña Clave de API y marca Permitir uso como conector de IA.

P: Mi Gemini CLI se convirtió en Antigravity CLI. ¿Estos pasos sirven? R: Google reemplazó Gemini CLI por Antigravity CLI en algunas cuentas. Busca la opción para agregar un servidor MCP por HTTP con encabezado: la dirección y el encabezado Authorization: Bearer hk_... son los mismos.

P: ¿Puedo guardar la clave en un archivo del proyecto? R: Evítalo. El archivo .gemini/settings.json de la carpeta del proyecto suele incluirse en el control de versiones y la clave quedaría expuesta. Es mejor usar el archivo de tu usuario (~/.gemini/settings.json).