Un'app desktop multipiattaforma per gestire le configurazioni dei server MCP in Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLI e altri ancora.
## Indice
- [Funzionalità](#funzionalità)
- [Installazione](#installazione)
- [Client supportati](#client-supportati)
- [Riga di comando (anteprima)](#riga-di-comando-anteprima)
- [Privacy e rete](#privacy-e-rete)
- [Sviluppo](#sviluppo)
- [Star History](#star-history)
- [Esclusione di responsabilità](#esclusione-di-responsabilità)
## Funzionalità
- **Un unico workspace** per tutti i server MCP, importati dalle configurazioni che i tuoi client hanno già
- **Catalogo online**: trova server nel GitHub MCP Registry, nel MCP Registry ufficiale o in qualsiasi registro compatibile, e aggiungili in pochi clic
- Modifica in **modalità modulo o JSON grezzo**
- **Applica a più client contemporaneamente**, con controllo delle scritture rischiose, backup automatici e rollback
- Tema chiaro / scuro e un'interfaccia in 11 lingue che segue la lingua di sistema
## Installazione
Scarica il pacchetto per la tua piattaforma dall'[ultima release](https://github.com/xjeway/mcp-manager/releases/latest):
| Piattaforma | Pacchetto |
| --- | --- |
| macOS | `.dmg`, oppure `brew install --cask xjeway/mcp-manager/mcp-manager` |
| Windows | `setup.exe` (x64 / arm64) o `.msi` (x64) |
| Linux | `.deb`, `.rpm` o `.AppImage` |
Scegli `arm64` / `aarch64` per Apple Silicon e i dispositivi ARM, altrimenti `x64` / `x86_64` / `amd64`.
macOS dice che l'app è danneggiata o non può essere aperta?
Le build di rilascio hanno una firma ad hoc, ma non sono ancora notarizzate da Apple. Al primo avvio:
1. Sposta l'app in `/Applications`, aprila e chiudi l'avviso.
2. Apri **Impostazioni di Sistema → Privacy e sicurezza**, fai clic su **Apri comunque** in fondo alla pagina e conferma.
Se macOS dice ancora che l'app è danneggiata (versioni precedenti non firmate), esegui:
```bash
xattr -dr com.apple.quarantine "/Applications/MCP Manager.app"
```
## Client supportati
Ogni client qui sotto supporta sia l'**importazione** (lettura dei server MCP esistenti dalla sua configurazione) sia l'**applicazione** (riscrittura della configurazione unificata).
## Riga di comando (anteprima)
`mcpmgr` condivide l'elenco dei server dell'app desktop, quindi le modifiche fatte in uno compaiono anche nell'altro.
```bash
npx @mcpmgr/cli list # oppure: 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
```
In un terminale, `add` ti guida nella scelta di server, client e ambito, e mostra un'anteprima di ogni file prima di scrivere. Ogni passaggio ha anche un flag (`--yes`, `--dry-run`, `--json`, …); all'interno di un agente di programmazione AI come Claude Code o Codex, salta le domande e prende come destinazione il client di quell'agente.
## Privacy e rete
MCP Manager si connette a Internet solo per verificare gli aggiornamenti e, mentre la pagina del catalogo è aperta, per interrogare i registri MCP (risultati nella cache per 6 ore, utilizzabile offline). Disattiva il catalogo in **Impostazioni → Catalogo online** per interrompere completamente queste richieste.
## Sviluppo
Richiede Node.js 20+, Rust stable e i [prerequisiti di Tauri](https://tauri.app/start/prerequisites/) per la tua piattaforma.
```bash
make install # installa le dipendenze
make tauri-dev # avvia l'app desktop
make test && make check
```
La logica principale (adattatori dei client, parsing, scritture sicure) si trova in `crates/mcp-manager-core`, condivisa dall'app Tauri in `src-tauri/` e dalla CLI in `crates/mcp-manager-cli/`. I rilasci sono descritti in [`docs/releasing.md`](../../docs/releasing.md).
Issue e pull request sono benvenute; per modifiche più ampie, apri prima una issue. Quando modifichi la documentazione rivolta agli utenti, mantieni sincronizzati [`README.md`](../../README.md), [`README.zh-CN.md`](../../README.zh-CN.md) e [`docs/readme/`](./).
## Star History
## Esclusione di responsabilità
Questo progetto è sviluppato principalmente con l'assistenza dell'AI e revisionato da un maintainer umano, quindi potrebbe comunque contenere errori. MCP Manager riscrive i file di configurazione di altri strumenti; backup e rollback sono integrati, ma conserva comunque i tuoi backup delle configurazioni importanti. Viene fornito "così com'è" secondo la [licenza MIT](../../LICENSE).