Cosa puoi fare con MCP
Con i server MCP connessi, puoi chiedere a Claude Code di:- Implementare funzionalità da issue tracker: “Aggiungi la funzionalità descritta nell’issue JIRA ENG-4521 e crea una PR su GitHub.”
- Analizzare dati di monitoraggio: “Controlla Sentry e Statsig per verificare l’utilizzo della funzionalità descritta in ENG-4521.”
- Interrogare database: “Trova gli indirizzi email di 10 utenti casuali che hanno utilizzato la funzionalità ENG-4521, in base al nostro database Postgres.”
- Integrare design: “Aggiorna il nostro modello di email standard in base ai nuovi design Figma che sono stati pubblicati su Slack”
- Automatizzare flussi di lavoro: “Crea bozze Gmail invitando questi 10 utenti a una sessione di feedback sulla nuova funzionalità.”
Server MCP popolari
Ecco alcuni server MCP comunemente utilizzati che puoi connettere a Claude Code:Hai bisogno di un’integrazione specifica? Trova centinaia di altri server MCP su GitHub, oppure crea il tuo utilizzando l’MCP SDK.
Installazione di server MCP
I server MCP possono essere configurati in tre modi diversi a seconda delle tue esigenze:Opzione 1: Aggiungi un server HTTP remoto
I server HTTP sono l’opzione consigliata per connettersi a server MCP remoti. Questo è il trasporto più ampiamente supportato per i servizi basati su cloud.Opzione 2: Aggiungi un server SSE remoto
Opzione 3: Aggiungi un server stdio locale
I server stdio vengono eseguiti come processi locali sulla tua macchina. Sono ideali per strumenti che necessitano di accesso diretto al sistema o script personalizzati.Comprensione del parametro ”—”:
Il
-- (doppio trattino) separa i flag CLI di Claude dai comandi e dagli argomenti che vengono passati al server MCP. Tutto ciò che precede -- sono opzioni per Claude (come --env, --scope), e tutto ciò che segue -- è il comando effettivo per eseguire il server MCP.Ad esempio:claude mcp add --transport stdio myserver -- npx server→ eseguenpx serverclaude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080→ eseguepython server.py --port 8080conKEY=valuenell’ambiente
Gestione dei tuoi server
Una volta configurati, puoi gestire i tuoi server MCP con questi comandi:Server MCP forniti da plugin
I plugin possono raggruppare server MCP, fornendo automaticamente strumenti e integrazioni quando il plugin è abilitato. I server MCP dei plugin funzionano in modo identico ai server configurati dall’utente. Come funzionano i server MCP dei plugin:- I plugin definiscono i server MCP in
.mcp.jsonnella radice del plugin o inline inplugin.json - Quando un plugin è abilitato, i suoi server MCP si avviano automaticamente
- Gli strumenti MCP dei plugin appaiono insieme agli strumenti MCP configurati manualmente
- I server dei plugin sono gestiti tramite l’installazione del plugin (non tramite comandi
/mcp)
.mcp.json nella radice del plugin:
plugin.json:
- Ciclo di vita automatico: I server si avviano quando il plugin si abilita, ma devi riavviare Claude Code per applicare le modifiche del server MCP (abilitazione o disabilitazione)
- Variabili di ambiente: Utilizza
${CLAUDE_PLUGIN_ROOT}per i percorsi relativi al plugin - Accesso alle variabili di ambiente dell’utente: Accesso alle stesse variabili di ambiente dei server configurati manualmente
- Tipi di trasporto multipli: Supporto per trasporti stdio, SSE e HTTP (il supporto del trasporto può variare a seconda del server)
- Distribuzione raggruppata: Strumenti e server confezionati insieme
- Configurazione automatica: Nessuna configurazione MCP manuale necessaria
- Coerenza del team: Tutti ottengono gli stessi strumenti quando il plugin è installato
Ambiti di installazione MCP
I server MCP possono essere configurati a tre diversi livelli di ambito, ognuno dei quali serve scopi distinti per gestire l’accessibilità e la condivisione dei server. Comprendere questi ambiti ti aiuta a determinare il modo migliore per configurare i server per le tue esigenze specifiche.Ambito locale
I server con ambito locale rappresentano il livello di configurazione predefinito e sono archiviati nelle impostazioni utente specifiche del progetto. Questi server rimangono privati per te e sono accessibili solo quando lavori all’interno della directory del progetto corrente. Questo ambito è ideale per server di sviluppo personali, configurazioni sperimentali o server contenenti credenziali sensibili che non dovrebbero essere condivise.Ambito progetto
I server con ambito progetto abilitano la collaborazione del team archiviando le configurazioni in un file.mcp.json nella directory radice del progetto. Questo file è progettato per essere controllato nel controllo di versione, assicurando che tutti i membri del team abbiano accesso agli stessi strumenti e servizi MCP. Quando aggiungi un server con ambito progetto, Claude Code crea o aggiorna automaticamente questo file con la struttura di configurazione appropriata.
.mcp.json risultante segue un formato standardizzato:
.mcp.json. Se hai bisogno di ripristinare queste scelte di approvazione, utilizza il comando claude mcp reset-project-choices.
Ambito utente
I server con ambito utente forniscono accessibilità tra progetti, rendendoli disponibili in tutti i progetti sulla tua macchina mentre rimangono privati per il tuo account utente. Questo ambito funziona bene per server di utilità personali, strumenti di sviluppo o servizi che utilizzi frequentemente in diversi progetti.Scelta dell’ambito giusto
Seleziona il tuo ambito in base a:- Ambito locale: Server personali, configurazioni sperimentali o credenziali sensibili specifiche di un progetto
- Ambito progetto: Server condivisi dal team, strumenti specifici del progetto o servizi richiesti per la collaborazione
- Ambito utente: Utilità personali necessarie in più progetti, strumenti di sviluppo o servizi utilizzati frequentemente
Gerarchia di ambito e precedenza
Le configurazioni del server MCP seguono una chiara gerarchia di precedenza. Quando server con lo stesso nome esistono a più ambiti, il sistema risolve i conflitti dando priorità ai server con ambito locale per primo, seguiti dai server con ambito progetto e infine dai server con ambito utente. Questo design assicura che le configurazioni personali possano sovrascrivere quelle condivise quando necessario.Espansione delle variabili di ambiente in .mcp.json
Claude Code supporta l’espansione delle variabili di ambiente nei file .mcp.json, consentendo ai team di condividere configurazioni mantenendo flessibilità per i percorsi specifici della macchina e i valori sensibili come le chiavi API.
Sintassi supportata:
${VAR}- Si espande al valore della variabile di ambienteVAR${VAR:-default}- Si espande aVARse impostato, altrimenti utilizzadefault
command- Il percorso dell’eseguibile del serverargs- Argomenti della riga di comandoenv- Variabili di ambiente passate al serverurl- Per i tipi di server HTTPheaders- Per l’autenticazione del server HTTP
Esempi pratici
Esempio: Monitora gli errori con Sentry
Esempio: Connettiti a GitHub per le revisioni del codice
Esempio: Interroga il tuo database PostgreSQL
Autenticazione con server MCP remoti
Molti server MCP basati su cloud richiedono autenticazione. Claude Code supporta OAuth 2.0 per connessioni sicure.1
Aggiungi il server che richiede autenticazione
Ad esempio:
2
Utilizza il comando /mcp all'interno di Claude Code
In Claude Code, utilizza il comando:Quindi segui i passaggi nel tuo browser per accedere.
Aggiungi server MCP dalla configurazione JSON
Se hai una configurazione JSON per un server MCP, puoi aggiungerla direttamente:1
Aggiungi un server MCP da JSON
2
Verifica che il server sia stato aggiunto
Importa server MCP da Claude Desktop
Se hai già configurato server MCP in Claude Desktop, puoi importarli:1
Importa server da Claude Desktop
2
Seleziona quali server importare
Dopo aver eseguito il comando, vedrai una finestra di dialogo interattiva che ti consente di selezionare quali server desideri importare.
3
Verifica che i server siano stati importati
Utilizza Claude Code come server MCP
Puoi utilizzare Claude Code stesso come server MCP a cui altre applicazioni possono connettersi:Limiti di output MCP e avvisi
Quando gli strumenti MCP producono output di grandi dimensioni, Claude Code aiuta a gestire l’utilizzo dei token per evitare di sovraccaricare il contesto della conversazione:- Soglia di avviso di output: Claude Code visualizza un avviso quando l’output di qualsiasi strumento MCP supera 10.000 token
- Limite configurabile: Puoi regolare i token di output MCP massimi consentiti utilizzando la variabile di ambiente
MAX_MCP_OUTPUT_TOKENS - Limite predefinito: Il massimo predefinito è 25.000 token
- Interrogano set di dati o database di grandi dimensioni
- Generano report o documentazione dettagliati
- Elaborano file di log estesi o informazioni di debug
Utilizza risorse MCP
I server MCP possono esporre risorse che puoi referenziare utilizzando menzioni @, simile a come referenzi i file.Referenzia risorse MCP
1
Elenca le risorse disponibili
Digita
@ nel tuo prompt per vedere le risorse disponibili da tutti i server MCP connessi. Le risorse appaiono insieme ai file nel menu di completamento automatico.2
Referenzia una risorsa specifica
Utilizza il formato
@server:protocol://resource/path per referenziare una risorsa:3
Referenze a risorse multiple
Puoi referenziare più risorse in un singolo prompt:
Utilizza i prompt MCP come comandi slash
I server MCP possono esporre prompt che diventano disponibili come comandi slash in Claude Code.Esegui prompt MCP
1
Scopri i prompt disponibili
Digita
/ per vedere tutti i comandi disponibili, inclusi quelli dai server MCP. I prompt MCP appaiono con il formato /mcp__servername__promptname.2
Esegui un prompt senza argomenti
3
Esegui un prompt con argomenti
Molti prompt accettano argomenti. Passali separati da spazi dopo il comando:
Configurazione MCP aziendale
Per le organizzazioni che necessitano di un controllo centralizzato sui server MCP, Claude Code supporta configurazioni MCP gestite dall’azienda. Questo consente agli amministratori IT di:- Controllare a quali server MCP i dipendenti possono accedere: Distribuisci un set standardizzato di server MCP approvati in tutta l’organizzazione
- Prevenire server MCP non autorizzati: Facoltativamente limitare gli utenti dall’aggiungere i propri server MCP
- Disabilitare completamente MCP: Rimuovi completamente la funzionalità MCP se necessario
Configurazione della configurazione MCP aziendale
Gli amministratori di sistema possono distribuire un file di configurazione MCP aziendale insieme al file delle impostazioni gestite:- macOS:
/Library/Application Support/ClaudeCode/managed-mcp.json - Windows:
C:\ProgramData\ClaudeCode\managed-mcp.json - Linux:
/etc/claude-code/managed-mcp.json
managed-mcp.json utilizza lo stesso formato di un file .mcp.json standard:
Limitazione dei server MCP con liste di autorizzazione e liste di negazione
Oltre a fornire server gestiti dall’azienda, gli amministratori possono controllare quali server MCP gli utenti possono configurare utilizzandoallowedMcpServers e deniedMcpServers nel file managed-settings.json:
- macOS:
/Library/Application Support/ClaudeCode/managed-settings.json - Windows:
C:\ProgramData\ClaudeCode\managed-settings.json - Linux:
/etc/claude-code/managed-settings.json
allowedMcpServers):
undefined(predefinito): Nessuna restrizione - gli utenti possono configurare qualsiasi server MCP- Array vuoto
[]: Blocco completo - gli utenti non possono configurare alcun server MCP - Elenco di nomi di server: Gli utenti possono configurare solo i server specificati
deniedMcpServers):
undefined(predefinito): Nessun server è bloccato- Array vuoto
[]: Nessun server è bloccato - Elenco di nomi di server: I server specificati sono esplicitamente bloccati in tutti gli ambiti
- Queste restrizioni si applicano a tutti gli ambiti: utente, progetto, locale e persino server aziendali da
managed-mcp.json - La lista di negazione ha assoluta precedenza: Se un server appare in entrambi gli elenchi, sarà bloccato
Precedenza della configurazione aziendale: La configurazione MCP aziendale ha la precedenza più alta e non può essere sovrascritta da configurazioni utente, locale o progetto.