---
title: "Configuração MCP do Gemini CLI: caminho, chave e exemplo · DotsAgent"
description: "Adicione servidores MCP de Google ao Gemini CLI: veja onde fica o arquivo de configuração, a chave de nível superior e o formato, o suporte a OAuth remoto e um exemplo de configuração."
url: https://dotsagent.io/pt/mcp/clients/gemini-cli
---

Google

# 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**: 

## Exemplo de configuração

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

`.gemini/settings.json`

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

`shell`

```
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 →](https://dotsagent.io/pt/mcp/config#client=gemini-cli)

## Outros clientes

[Claude Desktop](https://dotsagent.io/pt/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/pt/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/pt/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/pt/mcp/clients/vscode-copilot)

[Windsurf / Devin Desktop](https://dotsagent.io/pt/mcp/clients/windsurf)

[Zed](https://dotsagent.io/pt/mcp/clients/zed)

[OpenAI Codex CLI](https://dotsagent.io/pt/mcp/clients/codex-cli)

[ChatGPT](https://dotsagent.io/pt/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/pt/mcp/clients/openclaw)

[Cline](https://dotsagent.io/pt/mcp/clients/cline)

[Continue](https://dotsagent.io/pt/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/pt/mcp/clients/jetbrains-ai)

## Fontes

1. [geminicli.com](https://geminicli.com/docs/tools/mcp-server/)/docs/tools/mcp-server/
2. [raw.githubusercontent.com](https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/tools/mcp-server.md)/google-gemini/gemini-cli/main/docs/tools/mcp-server.md

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026