Gemini CLI

前提条件

レビュー済みの settings.json MCP 設定とブラウザ OAuth サポートを備えた Gemini CLI 開発者ツールを使用します。サポートは Gemini CLI 開発者ツールに適用され、Gemini コンシューマー Web チャット (gemini.google.com) への統合や公式拡張機能ギャラリーの承認を意味するものではありません。

• エンドポイント: https://xmemo.dev/mcp.
• 認証モード: OAuth.
• 設定ファイル: ~/.gemini/settings.json.
• トランスポート: Streamable HTTP (ホストされたエンドポイント用の httpUrl)。
• 拡張機能リポジトリ: github:yonro/xmemo-gemini-cli (マニフェスト 0.1.0、文書化された GitHub インストール、公式ギャラリー承認の推測なし)。

インストール / セットアップ

Gemini CLI の extensions コマンドを使用して拡張機能をインストールするか、mcpServers の下にある ~/.gemini/settings.json に XMemo 設定ブロックを手動でマージします。

• 拡張機能コマンド: gemini extensions install https://github.com/yonro/xmemo-gemini-cli (yonro/xmemo-gemini-cli @ 39e25b185b README に準拠)。
• 手動フォールバック: httpUrl と ID ヘッダーを保持したまま、XMemo ブロックを ~/.gemini/settings.json にマージします。

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

Credentialを設定する

Keyは不要です。Gemini CLIを再起動してからbrowser OAuthを完了してください。settings.jsonにXMEMO_KEYやAuthorization headerを入れないでください。

No XMEMO_KEY
Complete browser OAuth in Gemini CLI

XMEMO_AGENT_INSTANCE_IDを生成 / 確認する

ローカルのGemini CLI installごとに秘密ではない値を1つ生成し、gitの外に保存して再起動後も再利用します。これによりattributionが安定します。

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

既存のconfig blockを保持する

このページに表示された既存のGemini CLI XMemo configuration blockを使います。httpUrlと秘密ではないidentity headerを保持し、Authorizationや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}"
      }
    }
  }
}

Clientを再起動する

settings.jsonを保存したらGemini CLIを再起動し、endpointと現在のinstance identityを読み込ませてからOAuth consentを完了します。

実際のrecall callでテストする

最初のMCP callはread-onlyにします。これはhealth-check placeholderではなく実際のrecall invocationであり、memoryを書き込みません。

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

期待されるresponse（literal shape）

成功したcallは、次の公開ranked text shapeを返します。referenceとcontentは認可されたmemory spaceから得られる実際の値です。

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

よくあるエラー

Gemini CLIのOAuth failureは、ホステッドOAuth error contractを使います。

• invalid_grant — OAuth authorization codeが無効、期限切れ、または使用済みです。Gemini CLIを再接続してもう一度認可してください。
• invalid_target — OAuth resourceがこのMCP serverと一致しません。https://xmemo.dev/mcpを使って再接続してください。
• 403 insufficient_scope — grantにmemory:readが含まれていません。要求されたscopeを承認して再接続してください。