Gemini CLI

Requisito previo

Utilice las herramientas para desarrolladores de Gemini CLI con su configuración MCP revisada en settings.json y compatibilidad con OAuth en el navegador. El soporte se aplica a la herramienta para desarrolladores Gemini CLI y no implica integración en el chat web de consumo de Gemini (gemini.google.com) ni la aprobación oficial de la galería de extensiones.

• Punto de conexión: https://xmemo.dev/mcp.
• Modo de autenticación: OAuth.
• Archivo de configuración: ~/.gemini/settings.json.
• Transporte: Streamable HTTP (httpUrl para el punto de conexión alojado).
• Repositorio de extensiones: github:yonro/xmemo-gemini-cli (manifiesto 0.1.0; instalación documentada de GitHub, no se infiere aprobación oficial de galería).

Instalación / configuración

Instale la extensión mediante el comando de extensiones de Gemini CLI, o combine manualmente el bloque de configuración de XMemo en ~/.gemini/settings.json bajo mcpServers.

• Comando de extensión: gemini extensions install https://github.com/yonro/xmemo-gemini-cli (anclado a yonro/xmemo-gemini-cli @ 39e25b185b README).
• Alternativa manual: combine el bloque XMemo en ~/.gemini/settings.json, conservando httpUrl y los encabezados de identidad.

gemini extensions install https://github.com/yonro/xmemo-gemini-cli

Configure la credencial

No se necesita ninguna clave: complete el OAuth en el navegador después de reiniciar Gemini CLI. No coloque XMEMO_KEY ni un encabezado Authorization en settings.json.

No XMEMO_KEY
Complete browser OAuth in Gemini CLI

Genere / confirme XMEMO_AGENT_INSTANCE_ID

Genere un valor no secreto por cada instalación local de Gemini CLI, persístalo fuera de git y reutilícelo después de reiniciar para mantener estable la atribución.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'

Conserve el bloque de configuración existente

Use el bloque de configuración de Gemini CLI XMemo que aparece en esta página. Conserve httpUrl y los encabezados de identidad no secretos; no añada Authorization ni XMEMO_KEY.

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "gemini-cli",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Reinicie el cliente

Reinicie Gemini CLI después de guardar settings.json para que cargue el endpoint y la identidad de instancia actual; después complete el consentimiento OAuth.

Pruebe con una llamada real a recall

Haga que la primera llamada MCP sea de sólo lectura. Es una invocación real de recall, no un marcador de health check, y no escribe en la memoria.

recall({ query: "connection check", limit: 1 })

Respuesta esperada (forma literal)

Una llamada correcta devuelve la forma pública de texto clasificado que aparece abajo; la referencia y el contenido son valores reales del espacio de memoria autorizado.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Errores comunes

Los fallos OAuth de Gemini CLI usan el contrato de errores OAuth alojado.

• invalid_grant — el código de autorización OAuth no es válido, ha caducado o ya se utilizó: vuelva a conectar Gemini CLI y autorice de nuevo.
• invalid_target — el recurso OAuth no corresponde a este servidor MCP: use https://xmemo.dev/mcp y vuelva a conectar.
• 403 insufficient_scope — el grant no incluye memory:read: apruebe el scope requerido y vuelva a conectar.