Gestire e condividere i server MCP

Organizzare i server con gli scope e condividerli col team

⏱ Stima ~5 min

01 · Leggi

Quando aggiungi un server MCP, scegli uno scope per decidere chi può vederlo e dove viene salvato.

Local (default) — privato, solo nel progetto corrente. Salvato in ~/.claude.json sotto il percorso del tuo progetto. Usalo per server di sviluppo personali o server con credenziali sensibili.

Project — condiviso col team tramite .mcp.json nella root del repo. Si committa su git, e chiunque faccia il clone del repo ottiene gli stessi server. Usalo per gli strumenti standard del team.

User — disponibile in tutti i tuoi progetti. Salvato in ~/.claude.json. Ideale per strumenti personali che usi ovunque (come GitHub o database personali).

Punti chiave

Local (default): privato, solo nel progetto corrente
Project: condiviso col team tramite .mcp.json nel repo, committato su git
User: personale, disponibile in tutti i tuoi progetti
Scegli con --scope local|project|user

02 · Esempio di codice

Il flag --scope controlla dove viene salvata la configurazione del server.

Scope local (default — solo tu, questo progetto)

claude mcp add --transport http stripe https://mcp.stripe.com

Scope project (condiviso col team via git)

claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

Scope user (tu, tutti i progetti)

claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

Local è il default — non hai bisogno di --scope local. Lo scope project crea un file .mcp.json nel tuo repo, che i colleghi ricevono quando fanno il pull. Lo scope user lo salva nella configurazione della home directory, così ti segue ovunque.

03 · Esempio di codice

Quando usi --scope project, Claude Code crea un file .mcp.json nella root del tuo repo. Ecco com'è — puoi committarlo su git.

.mcp.json (da committare nel repo)

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Nota la sintassi ${DATABASE_URL} — le variabili d'ambiente vengono espanse a runtime, così puoi condividere la configurazione senza esporre i segreti. Ogni collega imposta DATABASE_URL nel proprio ambiente. La struttura del file segue il formato standard che Claude Code legge in automatico.

04 · Leggi

Una volta configurati i server, li gestisci con pochi comandi semplici.

claude mcp list mostra tutti i server. claude mcp get <name> mostra i dettagli di un server. claude mcp remove <name> rimuove un server.

Dentro Claude Code, scrivi /mcp per vedere lo stato dei server, autenticarti con server OAuth o risolvere problemi di connessione. Quando un server non risponde, /mcp è il primo posto dove guardare per diagnosticare.

Punti chiave

claude mcp list — vedi tutti i server configurati
claude mcp get <name> — dettagli di un server
claude mcp remove <name> — rimuovi un server
/mcp in Claude Code — stato, autenticazione, risoluzione problemi

05 · Quiz

Tutto il tuo team deve usare lo stesso server MCP Sentry. Vuoi fare il commit su git così i nuovi membri lo ricevono in automatico. Quale scope usi?

Local (predefinito)
Project
User
Global

06 · Trascina per ordinare

Hai tre server MCP diversi da configurare. Abbina ciascuno allo scope corretto in base a chi ne ha bisogno.

(Questa sezione è interattiva — attiva JavaScript per usarla.)

Altre lezioni di questo capitolo

⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.

※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.