Come aggiungere un server MCP a Claude Code: comandi, ambiti e soluzioni

Di solito, per collegare Claude Code a uno strumento si leggono tre pagine di configurazione diverse, si copia un comando leggermente sbagliato per il proprio sistema e ci si chiede perché non compaia nulla. La procedura vera è un comando e un controllo, a patto di sapere che tipo di server stai aggiungendo.

Questa guida ti dà i comandi per i tre tipi di server, spiega gli ambiti che decidono chi riceve il server e copre accesso, sicurezza e soluzioni ai problemi. Se MCP ti è nuovo, parti da Cos'è MCP?.

Cosa ti serve

Collega un server quando ti accorgi di copiare dati in chat da un altro strumento. Una volta collegato, Claude può leggere da quel sistema e agire al suo interno direttamente.

Tre tipi di server

Il comando da usare dipende da come il server si collega a te.

Server HTTP remoto

La forma base è la stessa per ogni servizio:

claude mcp add --transport http <name> <url>

Un esempio reale collega Notion:

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

Se il server richiede un token, passalo come header:

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

Server SSE remoto (deprecato)

Il metodo SSE è deprecato, quindi usa HTTP quando il servizio lo offre. Se un servizio ha solo SSE, il comando usa un trasporto diverso:

claude mcp add --transport sse asana https://mcp.asana.com/sse

Server stdio locale

Un server stdio è un programma che gira sulla tua macchina, avviato da Claude Code. La forma base ha un doppio trattino, e tutto ciò che segue è il comando che avvia il server:

claude mcp add [options] <name> -- <command> [args...]

Un esempio che aggiunge un server Airtable con una chiave API:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Verifica che abbia funzionato

Dopo aver aggiunto un server, controlla dal terminale o da dentro Claude Code.

$ claude mcp list$ claude mcp get notion$ claude mcp remove notion

Dentro una sessione, digita /mcp per vedere lo stato di ogni server. Vedrai uno di tre stati: collegato, richiede autenticazione o collegamento fallito.

Accedi con OAuth

Molti server cloud usano OAuth 2.0, il flusso "accedi con il tuo account". Il percorso più semplice ha due passaggi.

Dalla shell puoi anche eseguire claude mcp login <name> e claude mcp logout <name>. I token vengono conservati in modo sicuro e rinnovati automaticamente. Per revocare l'accesso, usa Clear authentication (Cancella autenticazione) nel menu /mcp.

Ambiti: chi riceve il server

Quando aggiungi un server, ne scegli l'ambito. L'ambito decide quali progetti lo vedono e se il tuo team lo condivide.

Scegline uno con l'opzione --scope:

# Project scope: shared with your team
claude mcp add --transport http shared-server --scope project https://example.com/mcp

# User scope: available in all your projects
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Un server con ambito project scrive un file .mcp.json nella radice del progetto, di cui fai il commit così tutti ricevono lo stesso collegamento:

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Se lo stesso nome di server compare in più ambiti, Claude Code si collega una sola volta, usando la definizione della fonte con la precedenza più alta: prima local, poi project, poi user.

Quando apri un progetto con un .mcp.json di qualcun altro, Claude Code chiede la tua approvazione prima di usarne i server in una sessione interattiva. Per azzerare queste scelte di approvazione, esegui claude mcp reset-project-choices.

Server popolari che puoi aggiungere oggi

Questi esempi vengono dalla documentazione ufficiale. Leggi sempre la pagina del servizio per l'indirizzo aggiornato.

Per il database, guarda il nome utente: readonly. Dai a Claude un account del database che può solo leggere. Questa scelta elimina l'errore più costoso che potresti fare.

Puoi anche sfogliare i connettori verificati nella directory di Anthropic su claude.ai/directory. E se hai aggiunto un connettore in claude.ai, è già disponibile in Claude Code quando accedi con il tuo account Claude.

Resta al sicuro

Un server MCP dà a Claude l'accesso a un sistema, e alcuni server recuperano contenuti dall'esterno, come pagine web o ticket scritti da sconosciuti.

L'ultimo punto riguarda quanto Claude fa senza chiedere. Vedi Modalità di permessi e Plan Mode di Claude Code spiegate per deciderlo.

Dentro Claude Tutorial

Fidarsi di uno strumento è una decisione, non un'impostazione predefinita

Giudicare quali sistemi meritano accesso, e per quali azioni, è una competenza che vale ben oltre il codice, e l'app la esercita con scenari reali.

In arrivo

Scarica suApp Store

DISPONIBILE SUGoogle Play

Limiti e regolazioni

Due limiti aiutano a spiegare comportamenti che altrimenti sembrano strani.

• Risultati grandi. Claude Code mostra un avviso quando l'output di uno strumento supera i 10.000 token e limita l'output a 25.000 token per impostazione predefinita. Per alzare il limite, imposta la variabile MAX_MCP_OUTPUT_TOKENS, per esempio MAX_MCP_OUTPUT_TOKENS=50000.
• Server lenti. Per cambiare quanto Claude Code aspetta l'avvio di un server, imposta MCP_TIMEOUT. Per esempio, MCP_TIMEOUT=10000 claude concede dieci secondi.

La ricerca degli strumenti è attiva per impostazione predefinita, così il tuo contesto non si riempie subito con la descrizione di ogni strumento. Esegui /context per vedere cosa occupa spazio.

Quando non funziona

Quando niente di tutto questo corrisponde, chiedi aiuto a Claude Code: incolla l'errore e chiedi cosa significa. Anche eseguire /doctor controlla la tua configurazione.

Domande frequenti

Come aggiungo un server MCP a Claude Code?

Esegui claude mcp add --transport http <name> <url> per un server remoto, oppure claude mcp add <name> -- <command> per uno locale. Poi esegui /mcp dentro Claude Code per controllarne lo stato e accedere.

Dove salva Claude Code i server MCP?

I server con ambito local e user sono salvati in ~/.claude.json. I server con ambito project sono salvati in un file .mcp.json nella radice del progetto, di cui puoi fare il commit.

Che differenza c'è tra ambito local, project e user?

Local vale per il progetto corrente e solo per te. Project vale per il progetto corrente ed è condiviso con il tuo team. User vale per tutti i tuoi progetti e solo per te.

Come rimuovo un server MCP?

Esegui claude mcp remove <name>. Per uscire da un server senza rimuoverlo, usa claude mcp logout <name>.

Cosa significa il doppio trattino in claude mcp add?

Separa le opzioni di Claude Code dal comando che avvia il server. Tutto ciò che segue viene passato al server senza modifiche.

I server MCP sono sicuri?

Sicuri quanto i server che scegli e l'accesso che concedi. Usa server affidabili, account di database in sola lettura e una modalità di permessi in cui puoi vedere cosa fa Claude.

Posso usare i miei connettori di claude.ai in Claude Code?

Sì. I connettori che aggiungi in claude.ai sono disponibili in Claude Code, nel terminale e nelle sessioni cloud, quando accedi con il tuo account Claude.

La tua checklist su MCP in Claude Code

Continua a leggere

• Cos'è MCP? Il Model Context Protocol spiegato semplice per l'idea alla base.
• Come aggiungere connettori in Claude: directory, URL personalizzato e sicurezza per la stessa cosa nelle app di Claude.
• Claude Code, le buone pratiche: abitudini che danno risultati migliori per lavorare bene una volta collegati gli strumenti.
• CLAUDE.md spiegato: insegna il tuo progetto a Claude Code una volta sola per dire a Claude come usare gli strumenti collegati nel tuo progetto.