Source: https://claudetutorial.com/guides/it-it/come-aggiungere-un-server-mcp-a-claude-code-comandi-ambiti-soluzioni [Torna a Guide](https://claudetutorial.com/guides/it-it) Builder # Come aggiungere un server MCP a Claude Code: comandi, ambiti e soluzioni 27 ottobre 2026 11 min di lettura --- 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. > Ogni server MCP che aggiungi a Claude Code si riduce a un comando: claude mcp add, seguito da come si collega. 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?](https://claudetutorial.com/guides/it-it/cos-e-mcp-il-model-context-protocol-spiegato-semplice). ## Cosa ti serve - Claude Code installato e funzionante. Se non lo è, vedi [Claude Code per principianti](https://claudetutorial.com/guides/it-it/claude-code-per-principianti-installa-accedi-primo-compito) - L'indirizzo del server (per uno remoto) o il suo comando di avvio (per uno locale), dalla documentazione del servizio - Un account sul servizio che stai collegando 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. | Tipo | Come si collega | A cosa serve | | --- | --- | --- | | **HTTP remoto** | Un indirizzo web su internet | La maggior parte dei servizi cloud. La scelta consigliata | | **SSE remoto** | Un indirizzo web con un metodo più vecchio | Servizi che offrono solo questo. Deprecato, quindi preferisci HTTP dove possibile | | **stdio locale** | Un programma che gira sulla tua macchina | File, database e strumenti locali | ### Server HTTP remoto La forma base è la stessa per ogni servizio: ``` claude mcp add --transport http ``` 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] -- [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 ``` Non dimenticare il doppio trattino Tutto ciò che segue `--` viene passato al server senza modifiche. Senza, Claude Code prova a leggere le opzioni del server come proprie, e il comando fallisce in modi confusi. ## Verifica che abbia funzionato Dopo aver aggiunto un server, controlla dal terminale o da dentro Claude Code. Terminale ``` $ claude mcp list$ claude mcp get notion$ claude mcp remove notion ``` Elenca tutti i server configurati, vedi i dettagli di uno o rimuovine uno. Dentro una sessione, digita `/mcp` per vedere lo stato di ogni server. Vedrai uno di tre stati: collegato, richiede autenticazione o collegamento fallito. | Stato | Cosa significa | Cosa fare | | --- | --- | --- | | Collegato | Il server è pronto | Chiedi a Claude di usarlo | | Richiede autenticazione | Non hai ancora effettuato l'accesso | Esegui `/mcp` e segui il login nel browser | | Collegamento fallito | Claude Code non è riuscito a raggiungerlo o ad avviarlo | Vedi le soluzioni più sotto | ## Accedi con OAuth Molti server cloud usano OAuth 2.0, il flusso "accedi con il tuo account". Il percorso più semplice ha due passaggi. 1. Aggiungi il server Per esempio: `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` 2. Autenticati In Claude Code, esegui `/mcp` e segui i passaggi di accesso nel browser. Dalla shell puoi anche eseguire `claude mcp login ` e `claude mcp logout `. 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. | Ambito | Disponibile in | Condiviso con il team | Salvato in | | --- | --- | --- | --- | | **Local** (predefinito) | Solo il progetto corrente | No | `~/.claude.json` | | **Project** | Solo il progetto corrente | Sì, tramite il controllo di versione | `.mcp.json` nella radice del progetto | | **User** | Tutti i tuoi progetti | No | `~/.claude.json` | 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. Vince per primo Vince per ultimo 1. Local Solo questo progetto, solo tu, salvato in ~/.claude.json 2. Project Condiviso con il team tramite .mcp.json 3. User Tutti i tuoi progetti, solo tu, salvato in ~/.claude.json Usa l'ambito project per gli strumenti che servono a tutto il team, user per i tuoi strumenti personali e local quando stai facendo delle prove. 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. | Servizio | Comando | | --- | --- | | Sentry (errori) | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` | | Stripe (pagamenti) | `claude mcp add --transport http stripe https://mcp.stripe.com` | | GitHub (revisioni del codice) | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"` | | Notion | `claude mcp add --transport http notion https://mcp.notion.com/mcp` | | PostgreSQL tramite DBHub | `claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"` | 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. Verifica di fidarti di ogni server I server che recuperano contenuti esterni possono esporti alla prompt injection: testo scritto per ingannare un'IA e farle fare qualcosa che non hai chiesto. Aggiungi solo server di fonti di cui ti fidi e guarda cosa Claude intende farci. - Il server viene dalla documentazione del servizio, non da un post a caso - I database usano un account in sola lettura - I token vanno negli header o nelle variabili d'ambiente, mai in un file di cui fai il commit - Lavori in una modalità di permessi in cui vedi cosa Claude fa con gli strumenti L'ultimo punto riguarda quanto Claude fa senza chiedere. Vedi [Modalità di permessi e Plan Mode di Claude Code spiegate](https://claudetutorial.com/guides/it-it/modalita-permessi-claude-code-e-modalita-plan-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 [DISPONIBILE SU Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## 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 | Cosa vedi | Causa probabile | Soluzione | | --- | --- | --- | | Il server manca da `claude mcp list` | È stato aggiunto in un altro ambito o progetto | Esegui `claude mcp list` dal progetto in cui l'hai aggiunto, oppure aggiungilo con `--scope user` | | `/mcp` mostra che richiede autenticazione | Non hai effettuato l'accesso | Esegui `/mcp` e segui i passaggi nel browser, oppure `claude mcp login ` | | `/mcp` mostra collegamento fallito | Indirizzo sbagliato, server fuori uso o comando di avvio che fallisce | Controlla l'URL nella documentazione del servizio. Per un server locale, esegui il suo comando nel terminale per vedere l'errore | | Le opzioni di un server locale vengono rifiutate | Manca il doppio trattino | Aggiungi `--` prima del comando del server | | Funziona in un progetto ma non in un altro | L'ambito local vale per un solo progetto | Aggiungilo di nuovo con `--scope user`, oppure con l'ambito project per un team | | Claude ignora un server del progetto | L'approvazione del `.mcp.json` è stata rifiutata | Esegui `claude mcp reset-project-choices` e approva di nuovo | | L'output viene tagliato | Il limite predefinito di 25.000 token | Alza `MAX_MCP_OUTPUT_TOKENS` | 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 ` per un server remoto, oppure `claude mcp add -- ` 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 `. Per uscire da un server senza rimuoverlo, usa `claude mcp logout `. ### 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 - `claude mcp list` mostra il server e `/mcp` lo mostra come collegato - Hai scelto l'ambito di proposito: local per provare, project per il team, user per te - Le credenziali stanno negli header o nelle variabili d'ambiente, non in file di cui fai il commit - Tutto ciò che tocca dati che non puoi ripristinare usa l'accesso in sola lettura ## Continua a leggere - [Cos'è MCP? Il Model Context Protocol spiegato semplice](https://claudetutorial.com/guides/it-it/cos-e-mcp-il-model-context-protocol-spiegato-semplice) per l'idea alla base. - [Come aggiungere connettori in Claude: directory, URL personalizzato e sicurezza](https://claudetutorial.com/guides/it-it/come-aggiungere-connettori-in-claude-directory-url-e-sicurezza) per la stessa cosa nelle app di Claude. - [Claude Code, le buone pratiche: abitudini che danno risultati migliori](https://claudetutorial.com/guides/it-it/buone-pratiche-claude-code-abitudini-per-risultati-migliori) per lavorare bene una volta collegati gli strumenti. - [CLAUDE.md spiegato: insegna il tuo progetto a Claude Code una volta sola](https://claudetutorial.com/guides/it-it/claude-md-spiegato-insegna-il-tuo-progetto-a-claude-code) per dire a Claude come usare gli strumenti collegati nel tuo progetto.