Pré-requisitos
- Ter o Claude Desktop / Cursor / VS Code instalado
- O runtime exigido pelo servidor que você vai instalar (a maioria requer Node.js ou Python; alguns exigem dependências adicionais)
- Ter as suas credenciais de API prontas (p. ex., o token do GitHub) — você vai precisar delas durante a configuração
Claude Desktop
Fluxo gráfico:
- Abra o Claude Desktop → Settings
- Entre em Developer → clique em Edit Config
- Adicione o seu servidor na seção
mcpServersdoclaude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "seu-token" }
}
}
}
Salve o arquivo e reinicie o Claude Desktop. A sua nova ferramenta aparecerá na lista de ferramentas da barra lateral esquerda. Consulte sempre o README do servidor para o comando e os argumentos exatos.
Cursor
- Abra a paleta de comandos (
Ctrl+Shift+P/Cmd+Shift+P) - Pesquise e selecione Cursor Settings > MCP
- Clique em Add New MCP Server, escolha o tipo de transporte (stdio ou SSE) e preencha o comando/os argumentos
VS Code
- Instale a extensão MCP Client (ou use o Copilot / extensões com suporte a MCP integrado)
- Configure
mcpServersnas configurações da extensão com o mesmo formato JSON do Claude Desktop - Recarregue a janela do VS Code para que as alterações entrem em vigor
As interfaces podem mudar conforme as versões do cliente — consulte sempre a documentação oficial para os passos exatos; a estrutura do comando/JSON sempre segue o README do servidor.
Solução de erros comuns
| Erro | Causa | Solução |
|---|---|---|
| command not found | O runtime Node/Python não está instalado ou não está no PATH | Instale o runtime e reinicie o cliente |
| 401 / 403 | Credenciais de API inválidas ou expiradas | Gere um novo token e verifique duas vezes a configuração do seu ambiente |
| Connection refused | Endereço do servidor SSE incorreto ou o serviço não está em execução | Verifique a URL + a porta e confirme se o servidor está no ar |
| Tool not found | As alterações de configuração não foram carregadas porque o cliente não foi reiniciado | Reinicie completamente o aplicativo do cliente depois de salvar a configuração |
Observações de segurança
- Os tokens ficam apenas no seu arquivo de configuração local — nunca envie o arquivo para o Git (lembre-se de adicionar
.gitignore) - Instale apenas servidores de projetos confiáveis e com muitas estrelas — servidores não verificados poderiam exfiltrar os seus dados
- Conceda servidores com permissões elevadas somente quando for absolutamente necessário