Gemini CLIにMCPサーバーを追加

Gemini CLI は ~/.gemini/ またはプロジェクトの .gemini/ フォルダーにある settings.json から mcpServers を読み込みます。

macOS

~/.gemini/settings.json

Windows

~/.gemini/settings.json

Linux

~/.gemini/settings.json

プロジェクトファイル

.gemini/settings.json

トップレベルキー

mcpServers

形式

json

リモートサーバーのOAuth

●はい

設定例

この例では、GitHub のホスト型サーバーと Playwright のローカルサーバーを、このクライアントが想定する形式で追加します。

{
  "mcpServers": {
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

gemini mcp add -s project -t http github https://api.githubcopilot.com/mcp/
gemini mcp add -s project playwright npx @playwright/mcp@latest

注意点と仕様

• フィールド名でトランスポートが決まります。Streamable HTTP は httpUrl、SSE は url、stdio は command を使います。
• gemini mcp add は、-s user を指定しない限り、プロジェクトスコープに設定を書き込みます。
• includeTools と excludeTools で、モデルに表示するツールを絞り込めます。
• OAuth トークンは ~/.gemini/mcp-oauth-tokens.json に保存されます。

Gemini CLIの設定を作成 →

その他のクライアント