Gemini CLI

Conecta Crow a Gemini CLI, el asistente de IA de Google para la terminal.

Requisitos previos

• Node.js 18 o posterior
• Crow clonado y configurado localmente (para stdio) o un gateway desplegado (para remoto)
• Gemini CLI instalado (npm install -g @google/gemini-cli)

Opción A: Local (stdio)

Ideal para desarrollo — ejecuta los servidores de Crow directamente en tu máquina. No requiere gateway ni red.

Pasos de configuración

1. Clona y configura Crow:

   git clone https://github.com/kh0pper/crow.git
   cd crow
   npm run setup

2. Edita ~/.gemini/settings.json y agrega los servidores de Crow bajo mcpServers:

   {
     "mcpServers": {
       "crow-memory": {
         "command": "node",
         "args": ["/path/to/crow/servers/memory/index.js"],
         "env": {
           "CROW_DB_PATH": "/path/to/crow/data/crow.db"
         }
       },
       "crow-projects": {
         "command": "node",
         "args": ["/path/to/crow/servers/research/index.js"],
         "env": {
           "CROW_DB_PATH": "/path/to/crow/data/crow.db"
         }
       },
       "crow-sharing": {
         "command": "node",
         "args": ["/path/to/crow/servers/sharing/index.js"],
         "env": {
           "CROW_DB_PATH": "/path/to/crow/data/crow.db"
         }
       },
       "crow-blog": {
         "command": "node",
         "args": ["/path/to/crow/servers/blog/index.js"],
         "env": {
           "CROW_DB_PATH": "/path/to/crow/data/crow.db"
         }
       },
       "crow-storage": {
         "command": "node",
         "args": ["/path/to/crow/servers/storage/index.js"],
         "env": {
           "CROW_DB_PATH": "/path/to/crow/data/crow.db",
           "MINIO_ENDPOINT": "localhost",
           "MINIO_PORT": "9000",
           "MINIO_ROOT_USER": "crowadmin",
           "MINIO_ROOT_PASSWORD": "your-secure-password"
         }
       }
     }
   }

   Reemplaza /path/to/crow con la ruta absoluta donde clonaste Crow. Omite crow-storage si no estás ejecutando MinIO.

3. Reinicia Gemini CLI — detectará los servidores MCP automáticamente.

Transporte

• Tipo: stdio
• Autenticación: Ninguna (proceso local)

Servidor combinado (huella más ligera)

Si prefieres un único punto de entrada en lugar de cinco servidores separados, usa el servidor combinado crow-core. Inicia con las herramientas de memoria activas y carga los demás servidores bajo demanda:

{
  "mcpServers": {
    "crow-core": {
      "command": "node",
      "args": ["/path/to/crow/servers/core/index.js"],
      "env": {
        "CROW_DB_PATH": "/path/to/crow/data/crow.db"
      }
    }
  }
}

O genera la configuración automáticamente:

cd /path/to/crow
npm run mcp-config -- --combined

Luego copia la entrada crow-core del .mcp.json generado a ~/.gemini/settings.json.

Opción B: Gateway (HTTP)

Conéctate a un gateway de Crow desplegado para acceso remoto — útil para configuraciones con Tailscale o despliegues en la nube.

Requisitos previos

• Gateway de Crow desplegado y accesible (guía de Primeros pasos o Configuración de Tailscale)

Pasos de configuración

1. Edita ~/.gemini/settings.json:

   {
     "mcpServers": {
       "crow-memory": {
         "url": "https://your-crow-server/memory/mcp"
       },
       "crow-projects": {
         "url": "https://your-crow-server/projects/mcp"
       },
       "crow-tools": {
         "url": "https://your-crow-server/tools/mcp"
       }
     }
   }

   Para un gateway accesible por Tailscale, usa la dirección de Tailscale en su lugar:

   {
     "mcpServers": {
       "crow": {
         "url": "http://100.x.x.x:3001/router/mcp"
       }
     }
   }

2. Inicia Gemini CLI — descubrirá automáticamente los metadatos de OAuth y solicitará la autorización en el primer uso.

Transporte

• Tipo: Streamable HTTP
• Protocolo: 2025-03-26
• Autenticación: OAuth 2.1 (descubrimiento automático)

Verificación

Inicia Gemini CLI y pide:

Guarda un recuerdo de que Gemini CLI está conectado a Crow.

Luego verifica que se guardó:

Busca en mis recuerdos "Gemini".

Contexto multiplataforma

Crow entrega automáticamente contexto de comportamiento cuando Gemini CLI se conecta vía MCP — los protocolos de memoria, la gestión de sesiones y las reglas de transparencia están activos desde el primer mensaje.

Para obtener orientación más detallada, pídele a Gemini que use los prompts de MCP: session-start, crow-guide (acepta el argumento platform: "gemini"), project-guide, blog-guide o sharing-guide.

Los recuerdos y proyectos almacenados a través de Gemini CLI están disponibles de inmediato en todas las demás plataformas conectadas. Consulta la Guía multiplataforma.

Consejos

• Gemini CLI busca ~/.gemini/settings.json de forma global — no existe un archivo de configuración por proyecto como el .mcp.json de Claude Code
• Ejecuta npm run mcp-config en el directorio de Crow para generar una configuración completa, y luego copia las entradas relevantes a settings.json
• El servidor crow-storage requiere MinIO; omítelo si no usas almacenamiento de archivos