Connetti Claude Code agli strumenti tramite MCP

Claude Code può connettersi a centinaia di strumenti esterni e fonti di dati attraverso il Model Context Protocol (MCP), uno standard open-source per le integrazioni AI-strumento. I server MCP danno a Claude Code accesso ai tuoi strumenti, database e API.

​

Cosa puoi fare con MCP

Con i server MCP connessi, puoi chiedere a Claude Code di:

• Implementare funzionalità dai tracker di problemi: “Aggiungi la funzionalità descritta nel problema 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 le email di 10 utenti casuali che hanno utilizzato la funzionalità ENG-4521, basandoti sul nostro database Postgres.”
• Integrare design: “Aggiorna il nostro template email standard basandoti sui 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:

​

Installazione dei server MCP

I server MCP possono essere configurati in tre modi diversi a seconda delle tue esigenze:

​

Opzione 1: 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.

# Sintassi di base
claude mcp add <nome> <comando> [args...]

# Esempio reale: Aggiungi server Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

​

Opzione 2: Aggiungi un server SSE remoto

I server SSE (Server-Sent Events) forniscono connessioni di streaming in tempo reale. Molti servizi cloud usano questo per aggiornamenti live.

# Sintassi di base
claude mcp add --transport sse <nome> <url>

# Esempio reale: Connetti a Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Esempio con header di autenticazione
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: your-key-here"

​

Opzione 3: Aggiungi un server HTTP remoto

I server HTTP usano pattern standard di richiesta/risposta. La maggior parte delle API REST e dei servizi web usa questo trasporto.

# Sintassi di base
claude mcp add --transport http <nome> <url>

# Esempio reale: Connetti a Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Esempio con token Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

Gestire i tuoi server

Una volta configurati, puoi gestire i tuoi server MCP con questi comandi:

# Elenca tutti i server configurati
claude mcp list

# Ottieni dettagli per un server specifico
claude mcp get github

# Rimuovi un server
claude mcp remove github

# (all'interno di Claude Code) Controlla lo stato del server
/mcp

# Questo crea command="cmd" che Windows può eseguire
claude mcp add my-server -- cmd /c npx -y @some/package

​

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 memorizzati nelle tue 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.

# Aggiungi un server con ambito locale (predefinito)
claude mcp add my-private-server /path/to/server

# Specifica esplicitamente l'ambito locale
claude mcp add my-private-server --scope local /path/to/server

​

Ambito progetto

I server con ambito progetto abilitano la collaborazione del team memorizzando le configurazioni in un file .mcp.json nella directory radice del tuo progetto. Questo file è progettato per essere inserito nel controllo 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 automaticamente o aggiorna questo file con la struttura di configurazione appropriata.

# Aggiungi un server con ambito progetto
claude mcp add shared-server --scope project /path/to/server

Il file .mcp.json risultante segue un formato standardizzato:

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

Per ragioni di sicurezza, Claude Code richiede approvazione prima di usare server con ambito progetto dai file .mcp.json. Se hai bisogno di reimpostare queste scelte di approvazione, usa il comando claude mcp reset-project-choices.

​

Ambito utente

I server con ambito utente forniscono accessibilità cross-progetto, rendendoli disponibili in tutti i progetti sulla tua macchina rimanendo privati al tuo account utente. Questo ambito funziona bene per server di utilità personali, strumenti di sviluppo o servizi che usi frequentemente in diversi progetti.

# Aggiungi un server utente
claude mcp add my-user-server --scope user /path/to/server

​

Scegliere l’ambito giusto

Seleziona il tuo ambito basandoti su:

• Ambito locale: Server personali, configurazioni sperimentali o credenziali sensibili specifiche per 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 usati frequentemente

​

Gerarchia degli ambiti e precedenza

Le configurazioni dei server MCP seguono una chiara gerarchia di precedenza. Quando esistono server con lo stesso nome a più ambiti, il sistema risolve i conflitti dando priorità prima ai server con ambito locale, 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 d’ambiente in .mcp.json

Claude Code supporta l’espansione delle variabili d’ambiente nei file .mcp.json, permettendo ai team di condividere configurazioni mantenendo flessibilità per percorsi specifici della macchina e valori sensibili come chiavi API.

Sintassi supportata:

• ${VAR} - Si espande al valore della variabile d’ambiente VAR
• ${VAR:-default} - Si espande a VAR se impostata, altrimenti usa default

Posizioni di espansione: Le variabili d’ambiente possono essere espanse in:

• command - Il percorso dell’eseguibile del server
• args - Argomenti della riga di comando
• env - Variabili d’ambiente passate al server
• url - Per tipi di server SSE/HTTP
• headers - Per l’autenticazione dei server SSE/HTTP

Esempio con espansione di variabili:

{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Se una variabile d’ambiente richiesta non è impostata e non ha un valore predefinito, Claude Code fallirà nel parsing della configurazione.

​

Esempi pratici

​

Esempio: Monitorare errori con Sentry

# 1. Aggiungi il server MCP Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Usa /mcp per autenticarti con il tuo account Sentry
> /mcp

# 3. Debug problemi di produzione
> "Quali sono gli errori più comuni nelle ultime 24 ore?"
> "Mostrami lo stack trace per l'errore ID abc123"
> "Quale deployment ha introdotto questi nuovi errori?"

​

Autenticarsi con server MCP remoti

Molti server MCP basati su cloud richiedono autenticazione. Claude Code supporta OAuth 2.0 per connessioni sicure.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp

​

Aggiungere server MCP da configurazione JSON

Se hai una configurazione JSON per un server MCP, puoi aggiungerla direttamente:

# Sintassi di base
claude mcp add-json <nome> '<json>'

# Esempio: Aggiungere un server stdio con configurazione JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Importare server MCP da Claude Desktop

Se hai già configurato server MCP in Claude Desktop, puoi importarli:

# Sintassi di base 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Usare Claude Code come server MCP

Puoi usare Claude Code stesso come server MCP a cui altre applicazioni possono connettersi:

# Avvia Claude come server MCP stdio
claude mcp serve

Puoi usarlo in Claude Desktop aggiungendo questa configurazione a claude_desktop_config.json:

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

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 prevenire il sovraccarico del contesto della tua conversazione:

• Soglia di avviso output: Claude Code mostra un avviso quando qualsiasi output di strumento MCP supera i 10.000 token
• Limite configurabile: Puoi regolare il massimo di token di output MCP consentiti usando la variabile d’ambiente MAX_MCP_OUTPUT_TOKENS
• Limite predefinito: Il massimo predefinito è 25.000 token

Per aumentare il limite per strumenti che producono output di grandi dimensioni:

# Imposta un limite più alto per gli output degli strumenti MCP
export MAX_MCP_OUTPUT_TOKENS=50000
claude

Questo è particolarmente utile quando lavori con server MCP che:

• Interrogano grandi dataset o database
• Generano report dettagliati o documentazione
• Processano file di log estesi o informazioni di debug

​

Usare risorse MCP

I server MCP possono esporre risorse che puoi referenziare usando menzioni @, similmente a come referenzi i file.

​

Referenziare risorse MCP

> Puoi analizzare @github:issue://123 e suggerire una correzione?

> Per favore rivedi la documentazione API su @docs:file://api/authentication

> Confronta @postgres:schema://users con @docs:file://database/user-model

​

Usare prompt MCP come comandi slash

I server MCP possono esporre prompt che diventano disponibili come comandi slash in Claude Code.

​

Eseguire prompt MCP

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug nel flusso di login" high