Um aplicativo desktop multiplataforma para gerenciar configurações de servidores MCP no Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLI e outros.
## Sumário
- [Recursos](#recursos)
- [Instalação](#instalação)
- [Clientes compatíveis](#clientes-compatíveis)
- [Linha de comando (prévia)](#linha-de-comando-prévia)
- [Privacidade e rede](#privacidade-e-rede)
- [Desenvolvimento](#desenvolvimento)
- [Star History](#star-history)
- [Aviso legal](#aviso-legal)
## Recursos
- **Um único espaço de trabalho** para todos os servidores MCP, importados das configurações que seus clientes já têm
- **Catálogo online**: encontre servidores no GitHub MCP Registry, no MCP Registry oficial ou em qualquer registro compatível, e adicione-os com poucos cliques
- Edição no **modo formulário ou JSON bruto**
- **Aplique a vários clientes de uma vez**, com revisão de gravações arriscadas, backups automáticos e rollback
- Tema claro / escuro e interface em 11 idiomas que segue o idioma do sistema
## Instalação
Baixe o pacote para a sua plataforma na [release mais recente](https://github.com/xjeway/mcp-manager/releases/latest):
| Plataforma | Pacote |
| --- | --- |
| macOS | `.dmg` ou `brew install --cask xjeway/mcp-manager/mcp-manager` |
| Windows | `setup.exe` (x64 / arm64) ou `.msi` (x64) |
| Linux | `.deb`, `.rpm` ou `.AppImage` |
Escolha `arm64` / `aarch64` para Apple Silicon e dispositivos ARM; caso contrário, `x64` / `x86_64` / `amd64`.
O macOS diz que o app está danificado ou não pode ser aberto?
As builds de release têm assinatura ad hoc, mas ainda não são notarizadas pela Apple. Na primeira abertura:
1. Mova o app para `/Applications`, abra-o e feche o aviso.
2. Abra **Ajustes do Sistema → Privacidade e Segurança**, clique em **Abrir Mesmo Assim** perto do final e confirme.
Se o macOS ainda disser que o app está danificado (versões antigas sem assinatura), execute:
```bash
xattr -dr com.apple.quarantine "/Applications/MCP Manager.app"
```
## Clientes compatíveis
Todos os clientes abaixo oferecem suporte tanto a **importação** (ler os servidores MCP existentes da sua configuração) quanto a **aplicação** (gravar de volta a configuração unificada).
## Linha de comando (prévia)
O `mcpmgr` compartilha a lista de servidores do aplicativo desktop, então as alterações feitas em um aparecem no outro.
```bash
npx @mcpmgr/cli list # ou: npm i -g @mcpmgr/cli / brew install xjeway/mcp-manager/mcpmgr
mcpmgr add context7 -- npx -y @upstash/context7-mcp@latest
mcpmgr add linear --url https://mcp.linear.app/mcp -a cursor,claude-code
mcpmgr remove context7 -a codex
mcpmgr rollback
```
Em um terminal, `add` guia você na escolha dos servidores, dos clientes e do escopo, e mostra uma prévia de cada arquivo antes de gravar. Cada etapa também tem uma flag (`--yes`, `--dry-run`, `--json`, …); dentro de um agente de programação com IA, como Claude Code ou Codex, ele pula as perguntas e tem como alvo o cliente desse agente.
## Privacidade e rede
O MCP Manager só se conecta à internet para verificar atualizações e, enquanto a página do catálogo está aberta, para consultar registros MCP (em cache por 6 horas, utilizável offline). Desative o catálogo em **Configurações → Catálogo online** para interromper totalmente essas solicitações.
## Desenvolvimento
Requer Node.js 20+, Rust stable e os [pré-requisitos do Tauri](https://tauri.app/start/prerequisites/) para a sua plataforma.
```bash
make install # instala as dependências
make tauri-dev # executa o aplicativo desktop
make test && make check
```
A lógica central (adaptadores de clientes, parsing, gravações seguras) fica em `crates/mcp-manager-core`, compartilhada pelo app Tauri em `src-tauri/` e pela CLI em `crates/mcp-manager-cli/`. As releases são descritas em [`docs/releasing.md`](../../docs/releasing.md).
Issues e pull requests são bem-vindos; para mudanças maiores, abra primeiro uma issue. Ao alterar a documentação voltada aos usuários, mantenha o [`README.md`](../../README.md), o [`README.zh-CN.md`](../../README.zh-CN.md) e [`docs/readme/`](./) sincronizados.
## Star History
## Aviso legal
Este projeto é desenvolvido principalmente com assistência de IA e revisado por um mantenedor humano, portanto ainda pode conter erros. O MCP Manager reescreve os arquivos de configuração de outras ferramentas; backups e rollback já vêm integrados, mas mantenha seus próprios backups das configurações importantes. Fornecido "no estado em que se encontra" sob a [Licença MIT](../../LICENSE).
MCP Manager
Claude Code
Claude Desktop
Codex
Cursor
OpenCode
GitHub Copilot
Gemini CLI
Antigravity
iFlow
Qwen Code
Cline
Devin (Desktop / CLI)
Kiro
Qoder
Kilo Code
Factory Droid
Kimi CLI
Zed
Mistral Vibe
Hermes Agent
Goose
Amp
Grok Build
VS Code