Como Gerencio Configurações MCP em 14 Ferramentas de Codificação de IA
Se você está usando mais de uma ferramenta de codificação AI em 2026, provavelmente já enfrentou este problema: cada ferramenta tem seu próprio formato de configuração MCP, sua própria localização de arquivo de configuração e suas próprias peculiaridades. Adicionar um novo servidor MCP significa editar de 3 a 5 arquivos JSON manualmente.
Eu criei MCP Dock para resolver isso. É um aplicativo de desktop que gerencia as configurações do servidor MCP em todos os seus clientes de IA a partir de uma única interface.
O Problema do Formato de Configuração
Veja como está o cenário de configuração MCP atualmente:
| Cliente | Formato | Caminho de Configuração |
|---|---|---|
| Cursor | JSON | ~/.cursor/mcp.json |
| VS Code | JSONC | settings.json (seção MCP) |
| Claude Code | JSON | ~/.claude/mcp.json |
| Gemini CLI | JSON | ~/.gemini/settings.json |
| Codex CLI | JSON | arquivo de configuração do codex |
| OpenClaw | JSON5 | ~/.openclaw/mcp.json5 |
| Windsurf | JSON | ~/.windsurf/mcp.json |
| Zed | JSON | zed settings.json |
| TRAE | JSON | ~/.trae/mcp.json |
| Kiro (AWS) | JSON | ~/.kiro/mcp.json |
| JetBrains | JSON | caminho específico do IDE |
| Antigravity | JSON | ~/.antigravity/mcp.json |
Isso resulta em mais de 12 locais de arquivos diferentes. Alguns usam JSON, outros usam JSONC (com comentários), um usa JSON5. Uma vírgula final que é válida em JSONC quebrará analisadores JSON estritos.
Quando eu estava usando apenas Cursor e Claude Code, editar manualmente dois arquivos era irritante, mas gerenciável. Agora estou usando Cursor, Claude Code, Gemini CLI e ocasionalmente Codex CLI. Quatro arquivos, quatro formatos, quatro chances de quebrar algo com uma vírgula fora do lugar.
O que o MCP Dock Faz
O MCP Dock é um aplicativo Electron (React + Vite + Tailwind) que:
- Agrega servidores MCP de múltiplos registros — mais de 9.200 servidores do Registro Oficial e Smithery, além de mais de 3.100 Habilidades AI do ecossistema skills.sh
- Gerencia diferenças de formato de configuração — ele conhece o formato esperado de cada cliente e gera a variante correta JSON/JSONC/JSON5
- Escreve em todos os clientes selecionados ao mesmo tempo — escolha um servidor, selecione quais clientes você deseja que ele esteja, um clique
- Faz backup antes de cada alteração — com um visualizador de diferenças e reversão com um clique
Inspetor MCP Integrado
Um recurso que eu uso constantemente é o Inspetor. Antes do MCP Dock, testar um novo servidor MCP significava:
- Editar arquivo de configuração
- Reiniciar IDE
- Tentar usar a ferramenta
- Se não funcionar, verificar logs, editar configuração, reiniciar novamente
O Inspetor se conecta diretamente a um servidor MCP e mostra as ferramentas, prompts e recursos disponíveis em tempo real. Nenhuma reinicialização do IDE é necessária.
Histórico e Reversão
Cada alteração de configuração é automaticamente versionada. Se um novo servidor MCP quebrar algo, você pode ver exatamente o que mudou (visualização de diferenças) e reverter para qualquer estado anterior.
Como Funciona o Pipeline de Dados
Os dados do servidor do MCP Dock vêm de três fontes:
- Registro MCP Oficial — a lista canônica mantida pela comunidade MCP
- Smithery — o maior registro de servidores MCP de terceiros
- Descoberta de Habilidades do GitHub — varredura automatizada para repositórios que seguem o padrão skills.sh
Os dados são sincronizados semanalmente via GitHub Actions, armazenados no Cloudflare R2 e servidos através de um Cloudflare Worker. O aplicativo busca esse índice na inicialização e o armazena em cache localmente.
Instalação
macOS (Homebrew):
brew install --cask OldJii/tap/mcp-dock
Windows / Linux: Baixe de GitHub Releases
Links
- Website: mcp.folay.top
- GitHub: github.com/OldJii/mcp-dock
- Gratuito para uso pessoal
Se você está lidando com várias ferramentas de codificação AI e cansado de editar arquivos de configuração, experimente. Feedback é bem-vindo — abra uma issue ou deixe um comentário abaixo.
Com a crescente adoção de ferramentas de IA, a gestão eficiente de configurações MCP se torna crucial para empresas brasileiras. O MCP Dock oferece uma solução prática, reduzindo erros e otimizando o fluxo de trabalho. Isso pode aumentar a produtividade e a eficiência operacional.
