Adicionar servidores MCP ao Gemini CLI

O Gemini CLI lê mcpServers do settings.json em ~/.gemini/ ou na pasta .gemini/ do projeto.

macOS

~/.gemini/settings.json

Windows

~/.gemini/settings.json

Linux

~/.gemini/settings.json

Arquivo do projeto

.gemini/settings.json

Chave de nível superior

mcpServers

Formato

json

OAuth para servidores remotos

●Sim

Exemplo de configuração

Este exemplo adiciona o servidor hospedado do GitHub e o Playwright como servidor local, no formato esperado por este cliente.

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

Observações e particularidades

• O nome do campo define o transporte: httpUrl para Streamable HTTP, url para SSE e command para stdio.
• gemini mcp add grava no escopo do projeto, a menos que você passe -s user.
• includeTools e excludeTools filtram quais ferramentas o modelo vê.
• Os tokens OAuth são salvos em ~/.gemini/mcp-oauth-tokens.json.

Criar uma configuração do Gemini CLI →

Outros clientes