Ferramenta gratuita

Gerador de configuração MCP para Claude Desktop

Cole a URL do seu servidor MCP e receba uma configuração que Claude Desktop vai realmente ler: o arquivo certo, a chave raiz certa, o transporte certo. Nada é enviado.

Cole o endpoint onde o seu servidor está publicado. O nome é opcional: é apenas o rótulo que Claude Desktop mostra.
Roda inteiramente no seu navegador. Nada do que você colar é enviado, armazenado ou registrado.

A configuração funciona. Ninguém continua vendo o que o seu servidor faz.

Um arquivo de configuração conecta o seu servidor. Ele não mostra a um cliente para que serve. O MCP Showcase transforma a mesma URL em um playground ao vivo com documentação para cada ferramenta.

Como funciona

link
Cole a URL do seu servidor

Tudo acontece no seu navegador. A sua URL e qualquer token ficam na sua máquina.

play_circle
Usamos o formato que Claude Desktop realmente lê

O arquivo certo, a chave raiz certa e a forma certa de expressar um endpoint remoto, que varia entre clientes mais do que se imagina.

checklist
Copie para o lugar certo

Cole o resultado no seu arquivo de configuração, reinicie Claude Desktop e o servidor aparece na lista de ferramentas.

Onde fica a configuração MCP do Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)

Acertar o local importa tanto quanto o conteúdo. Uma configuração correta no arquivo errado não faz absolutamente nada, e nenhum cliente relata erro por um arquivo que nunca abriu — por isso o sintoma habitual é «simplesmente não aparece» e não uma mensagem que você possa pesquisar.

O que o Claude Desktop espera

  • Formato: JSON.
  • Chave raiz: mcpServers.
  • Endpoint remoto: não suportado diretamente — um servidor hospedado precisa de ponte por um processo local.

Servidores remotos precisam de uma ponte local

A configuração do Claude Desktop inicia processos locais; ela não aceita uma URL MCP hospedada diretamente. Um servidor remoto é configurado como um comando stdio que executa o proxy mcp-remote e recebe a URL como argumento. Colar a URL em um campo "url" é de longe o erro mais comum aqui, e ele falha em silêncio: o servidor simplesmente nunca aparece.

Por que um gerador e não a documentação

Porque os dez clientes que as pessoas realmente usam discordam nos quatro pontos acima, e cada discordância falha em silêncio. A chave raiz é mcpServers na maioria, mas servers no VS Code e context_servers no Zed. O endpoint remoto é url na maioria, serverUrl no Windsurf e httpUrl no Gemini CLI. Dois clientes não usam JSON de jeito nenhum. Uma configuração copiada entre dois deles normalmente será analisada e não vai conectar com nada.

Depois da configuração

Reinicie o Claude Desktop — a maioria dos clientes lê a configuração MCP apenas na inicialização. Se o servidor aparecer mas não listar ferramentas, o problema saiu do arquivo de configuração e foi para o servidor, e o MCP Inspector vai mostrar se ele completa um handshake e em qual transporte responde.

Ferramentas relacionadas

Uma configuração conecta você. Ela não explica nada.

Tudo nesta página existe para fazer uma máquina conversar com um servidor. Não faz nada pela pessoa que decide se vale a pena conectar o seu servidor: ela também não consegue ler um arquivo de configuração. O MCP Showcase transforma a mesma URL em um playground ao vivo com documentação gerada para cada ferramenta, para que avaliar o seu servidor custe um clique em vez de um arquivo de configuração e um reinício.

Perguntas frequentes

O caminho exato aparece junto da configuração gerada abaixo, porque depende do cliente e do sistema operacional. O local importa tanto quanto o conteúdo: uma configuração correta no arquivo errado não faz absolutamente nada e não gera erro nenhum.

Porque as diferenças falham em silêncio. A chave raiz muda (mcpServers, servers, context_servers), a chave da URL remota muda (url, serverUrl, httpUrl) e dois clientes não usam JSON de jeito nenhum. Uma configuração copiada costuma ser analisada sem problemas e nunca conecta.

Não. Esta ferramenta não faz nenhuma requisição de rede. A configuração é montada no seu navegador, nada é armazenado, e você pode conferir na aba de rede do seu navegador.

Quase sempre sim. A maioria dos clientes lê a configuração MCP na inicialização, então a mudança só vale na próxima abertura. Se o servidor continuar sem aparecer, confira primeiro o caminho do arquivo: é a causa mais comum.

É um problema de conexão ou de transporte, não de formato da configuração. Passe a URL pelo MCP Inspector para confirmar que o servidor responde e ver em qual transporte.

Mais ferramentas MCP gratuitas