Ajouter des serveurs MCP à Gemini CLI

Gemini CLI lit mcpServers dans settings.json, dans ~/.gemini/ ou dans le dossier .gemini/ du projet.

macOS

~/.gemini/settings.json

Windows

~/.gemini/settings.json

Linux

~/.gemini/settings.json

Fichier de projet

.gemini/settings.json

Clé de premier niveau

mcpServers

Format

json

OAuth pour les serveurs distants

●Oui

Exemple de configuration

Cet exemple ajoute le serveur hébergé de GitHub et Playwright en tant que serveur local, selon le format attendu par ce client.

{
  "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

Notes et particularités

• Le nom du champ détermine le transport : httpUrl pour Streamable HTTP, url pour SSE et command pour stdio.
• gemini mcp add écrit dans la configuration du projet, sauf si vous passez -s user.
• includeTools et excludeTools filtrent les outils visibles par le modèle.
• Les tokens OAuth sont enregistrés dans ~/.gemini/mcp-oauth-tokens.json.

Créer une configuration pour Gemini CLI →

Autres clients