--- title: "Configurare il MCP in Claude Code" description: "Connetti server MCP in Claude Code con il comando claude mcp add: trasporti HTTP, SSE e stdio, scope, verifica con /mcp e server comuni per iniziare." type: "guide" locale: "it" category: "Claude Code" canonical: "https://agenticschool.dev/it/guide/claude-code-mcp-setup" datePublished: "2026-06-13" dateModified: "2026-06-13" --- # Configurare il MCP in Claude Code - Category: Claude Code - Keywords: claude code mcp setup, connect claude to mcp, mcp server claude code, claude mcp tutorial, claude mcp add - Canonical URL: https://agenticschool.dev/it/guide/claude-code-mcp-setup - Locale: it > Connetti server MCP in Claude Code con il comando claude mcp add: trasporti HTTP, SSE e stdio, scope, verifica con /mcp e server comuni per iniziare. Il MCP (Model Context Protocol) e uno standard aperto che connette Claude Code a tool, database e servizi esterni tramite un'interfaccia comune, cosi l'agente puo leggere e agire direttamente su questi sistemi invece che tu copi dati nella chat. Questa guida ti mostra esattamente come configurare il MCP in Claude Code: cosa ti porta connettere un server, come aggiungerne uno con il comando claude mcp add per ogni trasporto, gli scope che decidono chi condivide la connessione, come verificare e autenticare con /mcp, e quali server comuni valgono la pena per iniziare. Ogni comando qui e aggiornato a giugno 2026. ## 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. ```bash # 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 ``` Aggiungere server MCP HTTP remoti e stdio locali con claude mcp add. SSE esiste ancora ma e deprecato. ## 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. ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"] }, "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] } } } ``` Un .mcp.json con scope project (committato nel repo) che connette un server filesystem e un server browser Playwright. 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 " mostra i dettagli di uno di essi, e "claude mcp remove " 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. ```bash # 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 ``` Gestire e verificare i server MCP. Usa /mcp in una sessione per autenticare via OAuth. ## 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. ## Steps ### 1. 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. Aggiungere con claude mcp add Esegui claude mcp add con il trasporto giusto: --transport http per il remoto o --transport stdio -- per il locale. Passa le credenziali con --env, mai scritte a mano. ### 3. 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. 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. 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. ## FAQ ### Come aggiungo un server MCP a Claude Code? Usa il comando claude mcp add. Per un server remoto: "claude mcp add --transport http ". Per un server locale: "claude mcp add --transport stdio -- ". Aggiungi le credenziali con flag --env e usa --scope project per condividere via un .mcp.json committato. ### Cos'e il MCP in Claude Code? Il MCP (Model Context Protocol) e uno standard aperto che connette Claude Code a tool, database e servizi esterni tramite un'interfaccia comune. Un server MCP connesso espone tool, resource e prompt che l'agente puo usare direttamente, cosi puo agire su questi sistemi invece che tu copi dati nella chat. ### Quali sono gli scope MCP in Claude Code? Tre scope, definiti con --scope. Local (il default) limita il server a te nel progetto corrente. Project lo condivide con la squadra via un .mcp.json committato alla radice del repo. User lo rende disponibile su tutti i tuoi progetti. ### Come verifico che il mio server MCP sia connesso? Esegui "claude mcp list" dallo shell per vedere tutti i server e il loro stato, oppure "claude mcp get " per un server. All'interno di una sessione Claude Code, il pannello /mcp mostra i server connessi, il loro numero di tool, e ti lascia autenticare con i server OAuth. ### Quale trasporto dovrei usare per un server MCP? Usa HTTP per i server remoti basati su cloud; e il trasporto consigliato e piu ampiamente supportato. Usa stdio per i server locali che girano come processo sulla tua macchina. SSE esiste ancora ma e deprecato a favore di HTTP. ### E sicuro connettere molti server MCP? Sii selettivo. Ogni server aggiunge le sue definizioni di tool alla tua context window, quindi ha un costo continuo, e un server e codice di terze parti con accesso ai tuoi sistemi, quindi verificalo come una dipendenza. Spesso, un tool CLI nominato nel tuo CLAUDE.md fa il lavoro con meno sovraccarico. Connettine pochi, connetti cose di cui ti fidi.