Configurare il MCP in Claude Code

Cosa ti porta il MCP in Claude Code

Connetti un server quando ti sorprendi a copiare dati da un altro tool nella chat, come un issue tracker, un database o una dashboard di monitoring. Una volta connesso, Claude puo leggere e agire direttamente su quel sistema. Un server MCP espone tool (azioni che l'agente puo eseguire), resource (dati read-only che puo recuperare) e prompt (template riutilizzabili), e poiche il MCP e uno standard comune, un'integrazione si scrive una volta per tool e funziona su ogni client compatibile MCP. Ecco perche il supporto si e diffuso cosi in fretta e perche esiste ormai un server MCP per quasi tutto cio che vorresti connettere.

• Implementare da un issue tracker: "Costruisci la funzionalita descritta in JIRA ENG-4521 e apri una PR."
• Interrogare un database direttamente, piuttosto che copiare righe nella chat.
• Integrare design, dati di monitoring e altri servizi che l'agente non potrebbe vedere altrimenti.
• Tool, resource e prompt: azioni da eseguire, dati da leggere, template riutilizzabili.

Aggiungere un server con claude mcp add

Il modo piu rapido di connettere un server e il comando claude mcp add. Ci sono tre trasporti. HTTP e la scelta consigliata per i server remoti basati su cloud. Stdio esegue un server come processo locale sulla tua macchina, ideale per i tool che hanno bisogno di accesso diretto al sistema. SSE esiste ancora ma e deprecato a favore di HTTP. Per i server stdio, il doppio trattino separa le opzioni proprie di Claude dal comando che avvia il server, e tutto cio che segue viene passato cosi com'e al server.

# Remote HTTP server (recommended for cloud services)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# HTTP server with a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server (note the -- before the command)
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server

Scegliere uno scope

Il flag --scope decide chi puo usare il server e dove viene salvata la configurazione. Local (il default) lo limita a te nel progetto corrente. Project lo condivide con tutti tramite un file .mcp.json committato alla radice del repo, quindi un server con scope project e la scelta giusta per le connessioni di cui tutta la tua squadra ha bisogno. User lo rende disponibile su tutti i tuoi progetti. I server che hanno bisogno di credenziali dovrebbero riceverle tramite variabili d'ambiente (il flag --env), mai come chiavi scritte a mano, cosi la stessa disciplina .env si applica e i segreti restano fuori dalla configurazione committata.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

I server con scope project da .mcp.json non sono approvati automaticamente: appaiono come "pending approval" finche non li verifichi e li approvi quando lanci Claude interattivamente, il che ti protegge dall'eseguire codice server non affidabile che un collega avrebbe aggiunto.

Verificare e autenticare

Dopo aver aggiunto un server, conferma che funziona. Dallo shell, "claude mcp list" mostra tutti i server configurati e il loro stato, "claude mcp get <nome>" mostra i dettagli di uno di essi, e "claude mcp remove <nome>" lo rimuove. All'interno di una sessione Claude Code, il pannello /mcp mostra ogni server connesso, il suo numero di tool, e ti lascia autenticare con i server che richiedono OAuth 2.0 guidandoti nel login via browser. Se una richiesta ha bisogno di un server ancora in fase di connessione, Claude lo aspetta prima di continuare.

# List all configured servers and their status
claude mcp list

# Details for one server
claude mcp get notion

# Remove a server
claude mcp remove notion

# Inside a session: check status and authenticate (OAuth)
/mcp

Server comuni e connettere con criterio

Buone prime connessioni sono il server filesystem (limitato a una cartella), il server Playwright (perche l'agente possa pilotare un vero browser) e un server database per il tuo stack. Ma connetti con criterio: ogni server aggiunge le sue definizioni di tool alla tua context window, quindi ognuno ha un costo reale e continuo. Un server MCP e anche codice di terze parti con accesso ai tuoi sistemi, quindi verificalo come faresti con una dipendenza. Spesso, un tool CLI che hai gia e che nomini nel tuo CLAUDE.md fa il lavoro con meno sovraccarico di un server dedicato. Tre server che usi battono quindici che gonfiano il tuo contesto.

Passo dopo passo

1. 01

   Scegliere un server da connettere

   Decidi cosa l'agente deve raggiungere e non puo attualmente, come un database, un browser o un issue tracker, e trova il suo server MCP (HTTP per i servizi cloud, stdio per i tool locali).

2. 02

   Aggiungere con claude mcp add

   Esegui claude mcp add con il trasporto giusto: --transport http <nome> <url> per il remoto o --transport stdio <nome> -- <command> per il locale. Passa le credenziali con --env, mai scritte a mano.

3. 03

   Scegliere lo scope

   Usa --scope project per condividere via un .mcp.json committato, --scope user per tutti i tuoi progetti, oppure lascia lo scope predefinito local solo per questo progetto. Approva i server project in attesa quando richiesto.

4. 04

   Verificare la connessione

   Esegui "claude mcp list" per confermare il server e il suo stato, poi apri /mcp in una sessione per vedere il suo numero di tool e autenticare via OAuth se il server lo richiede.

5. 05

   Usare, e potare cio di cui non hai bisogno

   Chiedi all'agente di usare i tool del server. Rimuovi i server che non usi con "claude mcp remove" per mantenere il tuo contesto leggero, e preferisci un CLI nominato in CLAUDE.md se un CLI farebbe il lavoro.

Domande frequenti

Continua a imparare