dotsagent.io
Idioma:Português
Conectar · ferramenta

Gerador de configuração MCP

Escolha um cliente e os servidores que você quer usar. Você recebe a configuração no formato exato esperado pelo cliente, os comandos de CLI correspondentes, quando disponíveis, e um aviso sobre o que ele não consegue executar.

Cliente
Sistema operacional
Escopo
Servidores (3)
  • GitHub
  • Context7
  • PlaywrightLocal

O Claude Code obtém os servidores pelo comando claude mcp add ou por um arquivo .mcp.json na raiz do repositório.

.mcp.json
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Ou adicione pela linha de comando

shell
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Instruções completas de configuração do Claude Code →

Como funciona a saída

Hospedado ou local

Um servidor hospedado é uma URL à qual o cliente se conecta por Streamable HTTP; o fornecedor o executa, sem necessidade de instalação. Um servidor local é iniciado como processo filho por npx, uvx ou docker e é executado com os mesmos acessos da sua máquina. Quando um servidor oferece as duas opções, o gerador escolhe hospedado primeiro, mas permite alternar.

Segredos não são gravados no arquivo

O gerador nunca grava uma chave real. Ele usa a sintaxe de referência própria de cada cliente: ${VAR} no Claude Code, ${env:VAR} no Cursor e no Windsurf, uma solicitação de inputs no VS Code, $VAR no Gemini CLI, env_vars no Codex e ${{ secrets.VAR }} no Continue. Para os outros clientes, ele usa o marcador <VAR>, que você deve preencher.

OAuth no primeiro uso

A maioria dos servidores hospedados nesta página usa OAuth para autenticar você. O cliente abre um navegador na primeira conexão ou quando você executa a etapa de login: /mcp no Claude Code, codex mcp login, devin mcp login ou openclaw mcp login. Slack, Asana e HubSpot aceitam apenas clientes pré-registrados; verifique se o seu é compatível.

Recarregue após editar

O Claude Desktop lê o arquivo ao iniciar. Portanto, feche e abra o aplicativo novamente após fazer alterações; no macOS, os logs ficam em ~/Library/Logs/Claude. Se um novo servidor não aparecer em outro cliente, reinicie o aplicativo ou recarregue a janela. No OpenClaw, openclaw mcp doctor <name> --probe testa um único servidor.

Dúvidas sobre configuração

Onde colocar o mcp.json no Cursor e no Claude Code?

O Cursor lê .cursor/mcp.json no projeto ou ~/.cursor/mcp.json para todos os projetos. O Claude Code lê .mcp.json na raiz do repositório para o escopo do projeto e mantém as configurações locais e do usuário em ~/.claude.json. O VS Code usa .vscode/mcp.json, e o Codex usa ~/.codex/config.toml em vez de JSON.

Por que um servidor remoto não carrega de claude_desktop_config.json?

O Claude Desktop aceita apenas servidores locais desse arquivo. Para adicionar servidores remotos, use conectores personalizados em Settings > Connectors: cole a URL e faça login. Por isso, o gerador lista essas URLs separadamente.

Como evitar que chaves de API sejam incluídas em um .mcp.json commitado?

Use uma variável de ambiente em vez de colar a chave. O Claude Code expande ${VAR} e ${VAR:-default}, o Cursor expande ${env:NAME}, e o VS Code pode solicitar um segredo por meio de uma entrada inputs. Defina a variável no shell ou no gerenciador de segredos antes de iniciar o cliente.

Posso reutilizar uma configuração MCP em vários clientes?

Não sem alterações: a chave de nível superior é mcpServers na maioria dos clientes, mas em .vscode/mcp.json é servers, no Zed é context_servers e no Codex são tabelas mcp_servers. Alguns clientes importam arquivos de outros: o VS Code detecta configurações do Claude Desktop, Cursor e Windsurf; o Continue aceita um mcp.json adicionado diretamente; e o JetBrains AI Assistant tem uma opção Import from Claude.

Por que o npx falha no Claude Desktop no Windows?

O README dos servidores MCP executa o npx pelo cmd no Windows: command cmd, com /c, npx e o pacote como argumentos. O gerador aplica esse wrapper automaticamente quando você seleciona Claude Desktop e Windows.

Devo usar a versão hospedada ou local de um servidor?

A versão hospedada é mais simples: não é preciso instalar um runtime, e o OAuth substitui tokens de longa duração armazenados em disco. A versão local faz sentido quando o servidor precisa acessar arquivos ou credenciais na sua máquina, ou quando não há um endpoint hospedado, como no Filesystem, Playwright ou servidor de API da AWS.

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