Aggiungi il tuo primo server MCP
Un solo comando per connettere Claude Code a GitHub, database e molto altro
⏱ Stima ~6 min
01 · Leggi
Aggiungere un server MCP a Claude Code è un singolo comando. Usi claude mcp add seguito dal nome e dall'URL (HTTP) o dal comando (stdio).
Dopo averlo aggiunto, Claude può usare ogni strumento esposto da quel server — in automatico. Nessuna modifica al codice, nessun file di configurazione, nessun riavvio. Aggiungilo e inizia subito a chiedere a Claude di usarlo.
Punti chiave
- claude mcp add è il comando principale per aggiungere un server
- I server HTTP richiedono nome e URL
- I server Stdio richiedono nome e comando da eseguire
- Le opzioni come --transport, --env, --scope vanno prima del nome del server
02 · Esempio di codice
Ecco come aggiungere un server HTTP remoto — il tipo più comune. Questo esempio connette Claude a GitHub.
Aggiungere il server MCP GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Aggiungere il server MCP Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp
Aggiungere un header di autenticazione
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
Il pattern è sempre lo stesso: claude mcp add --transport http <name> <url>. Name è il nome con cui ti riferirai a questo server in seguito. URL è dove si trova il server MCP. Quando il server richiede un token, usa --header per aggiungere l'header di autenticazione.
03 · Esempio di codice
I server Stdio fanno girare processi locali. Questo esempio usa il pacchetto dbhub per connettere Claude a un database PostgreSQL.
Aggiungere il server PostgreSQL
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/mydb"
Aggiungere con variabili d'ambiente
claude mcp add --transport stdio airtable \
--env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server
-- (doppio trattino) separa le opzioni di Claude dal comando e dai parametri del server. Tutto ciò che viene dopo -- è il comando per avviare il server MCP. Usa --env per passare le API key come variabili d'ambiente in modo sicuro, senza scriverle nel codice.
04 · Passo dopo passo
1. Scegli il server
Decidi quale server MCP aggiungere. Per i server HTTP ti serve l'URL del server. Per i server Stdio ti serve il nome del pacchetto npm o il comando. Consulta la lista ufficiale dei server MCP o la documentazione del tuo servizio.
2. Esegui claude mcp add
Per i server remoti usa claude mcp add --transport http <name> <url>, per quelli locali usa claude mcp add --transport stdio <name> -- <command>. Ricorda: tutte le opzioni vanno prima del name, -- separa il comando del server.
3. Verifica la connessione
Esegui claude mcp list per vedere tutti i server configurati, oppure usa /mcp dentro Claude Code per vedere lo stato e verificare. Lo stato verde indica che il server è connesso e pronto.
4. Chiedi a Claude di usarlo
Avvia una conversazione con Claude Code e fai una domanda che richiede quel server. GitHub: "Mostrami le mie PR aperte." Database: "Quali tabelle ci sono?" Claude scopre automaticamente gli strumenti del server.
05 · Quiz
Vuoi aggiungere un server database locale che richiede la variabile d'ambiente DATABASE_URL. L'ordine dei flag è importante. Quale comando è corretto?
- claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
- claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
- claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
- claude mcp add -- npx dbhub --transport stdio db
06 · Completa
Per elencare tutti i server MCP configurati, esegui claude mcp _____
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.