Connetti Claude Code ai tuoi strumenti tramite MCP

​

Cosa puoi fare con MCP

• Implementare funzionalità da issue tracker: “Aggiungi la funzionalità descritta nel ticket JIRA ENG-4521 e crea una PR su GitHub.”
• Analizzare dati di monitoraggio: “Controlla Sentry e Statsig per verificare l’utilizzo della funzionalità descritta in ENG-4521.”
• Interrogare database: “Trova gli indirizzi email di 10 utenti casuali che hanno utilizzato la funzionalità ENG-4521, in base al nostro database PostgreSQL.”
• Integrare design: “Aggiorna il nostro modello di email standard in base ai nuovi design Figma che sono stati pubblicati su Slack”
• Automatizzare flussi di lavoro: “Crea bozze Gmail invitando questi 10 utenti a una sessione di feedback sulla nuova funzionalità.”
• Reagire a eventi esterni: Un server MCP può anche agire come un canale che invia messaggi nella tua sessione, in modo che Claude reagisca ai messaggi Telegram, chat Discord o eventi webhook mentre sei assente.

​

Trovare e costruire server MCP

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

Installazione di server MCP

​

Opzione 1: Aggiungere un server HTTP remoto

# Sintassi di base
claude mcp add --transport http <name> <url>

# Esempio reale: Connessione a Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

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

​

Opzione 2: Aggiungere un server SSE remoto

# Sintassi di base
claude mcp add --transport sse <name> <url>

# Esempio reale: Connessione ad Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Esempio con intestazione di autenticazione
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

​

Opzione 3: Aggiungere un server stdio locale

# Sintassi di base
claude mcp add [options] <name> -- <command> [args...]

# Esempio reale: Aggiungere server Airtable
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

Opzione 4: Aggiungere un server WebSocket remoto

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

Aggiungere un server da istruzioni di configurazione scritte per un altro client

• Un URL come https://mcp.example.com/mcp: il server è remoto.
• Un comando di avvio come npx -y @example/mcp-server: il server viene eseguito sulla vostra macchina.
• Un blocco JSON mcpServers: configurazione scritta per il file di impostazioni di un altro client.

​

Da un URL

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

​

Da un comando npx, uvx, o binario

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

Da un blocco JSON mcpServers

• Un url senza type: aggiungete "type": "http", "type": "sse", o "type": "ws" per corrispondere all’endpoint. Claude Code legge una voce senza type come server stdio, quindi una voce url senza type fallisce.
• Una chiave con caratteri diversi da lettere, numeri, trattini e sottolineature: scegliete un nome di server che utilizza solo quei caratteri. Altrimenti la chiave è il nome del server.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

​

Gestione dei vostri server

# Elencare tutti i server configurati
claude mcp list

# Ottenere dettagli per un server specifico
claude mcp get notion

# Rimuovere un server
claude mcp remove notion

# (all'interno di Claude Code) Controllare lo stato del server
/mcp

​

Stato del server

• ⏸ Pending approval (run `claude` to approve): un server con ambito di progetto da .mcp.json che non avete ancora approvato. Claude Code lo mostra sia in claude mcp list che in claude mcp get <name>. Eseguite claude in modo interattivo per rivederlo e approvarlo.
• ✘ Rejected (see disabledMcpjsonServers in settings): un server .mcp.json che una voce disabledMcpjsonServers rifiuta. Claude Code lo mostra solo in claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp): un server che l’elenco disabledMcpServers del progetto nomina. Claude Code lo mostra sia in claude mcp list che in claude mcp get <name>. Riattivate il server dal pannello /mcp. Prima della v2.1.238, entrambi i comandi si connettevano a un server disabilitato per verificarne lo stato di salute e segnalano il risultato della connessione.

​

Approvazioni del server di progetto e fiducia dell’area di lavoro

• il vostro ~/.claude/settings.json utente
• impostazioni gestite
• impostazioni passate con --settings

​

Dettaglio dello stato del server

• Il percorso e la query non appaiono mai in quel messaggio.
• Per un server nell’ambito locale, di progetto, o utente scope o nella configurazione MCP gestita, l’origine mostra l’host come scritto in quella configurazione, quindi un riferimento ${VAR} nell’host non viene espanso nel messaggio.
• Per un fallimento senza codice di stato o di errore, Claude Code mostra il testo di errore senza l’origine.

​

Avvisi di configurazione

• Spazi bianchi nascosti: Claude Code avverte quando un valore di configurazione MCP contiene spazi bianchi nascosti iniziali o finali, che spesso provengono dall’incollamento di un token con una nuova riga finale. Claude Code controlla command, url, ogni voce args, e i valori e i nomi delle chiavi sotto env e headers. Claude Code mostra l’avviso nell’output di claude mcp list e in /mcp, nominando i campi interessati senza echeggiare i loro valori, ad esempio Leading or trailing whitespace in: headers.Authorization. Claude Code non taglia gli spazi bianchi e utilizza i valori esattamente come scritti, quindi modificate la configurazione per rimuoverli.
• Stesso nome in più di un ambito: se definite lo stesso nome di server in più di un scope con endpoint diversi, Claude Code avverte del conflitto nell’output di claude mcp list e in /mcp. Claude Code memorizza gli accessi OAuth per endpoint, quindi quando autenticate la definizione che si carica in un progetto, dovete comunque accedere separatamente in un progetto dove si carica una definizione diversa. Mantenete l’endpoint che desiderate e rimuovete gli altri con claude mcp remove <name> --scope <scope>. Nell’avviso, Claude Code cita l’endpoint di ogni ambito come scritto nella vostra configurazione, con i riferimenti ${VAR} non espansi, quindi non mostra mai un valore risolto come una chiave API.
• Nomi riservati: Claude Code riserva i nomi dei suoi server integrati, inclusi workspace, claude-in-chrome, computer-use, Claude Preview, e Claude Browser. Se la vostra configurazione definisce un server con un nome riservato, Claude Code lo salta al momento del caricamento e mostra un avviso chiedendovi di rinominarlo. claude mcp add rifiuta un nome riservato con un errore. Claude Preview e Claude Browser entrambi nominano il server integrato che il pannello di anteprima dell’app desktop Claude Code utilizza. Prima della v2.1.205, Claude Browser non era riservato, quindi un server configurato dall’utente poteva registrarsi con quel nome.
• Variabile di ambiente mancante: se un riferimento ${VAR} nella configurazione di un server nomina una variabile che non è impostata e non ha :-default, Claude Code avverte nell’output di claude mcp list e in /mcp, nominando la variabile, e carica comunque il server con il testo ${VAR} non espanso. Impostate la variabile o aggiungete un fallback ${VAR:-default}. In un url e headers di un server remoto, alcune variabili di credenziali leggono come vuote invece, senza avviso.

​

Disponibilità degli strumenti

• Con ricerca degli strumenti, l’impostazione predefinita: l’attesa avviene all’interno della chiamata ToolSearch.
• Senza ricerca degli strumenti: Claude utilizza lo strumento WaitForMcpServers invece. Le configurazioni senza ricerca degli strumenti includono un ANTHROPIC_BASE_URL personalizzato, ENABLE_TOOL_SEARCH=false, e un modello precedente alla generazione Claude 4.5 su Google Cloud’s Agent Platform.
• Su una distribuzione Microsoft Foundry ospitata su Azure: Claude inizia sul percorso di ricerca degli strumenti piuttosto che con WaitForMcpServers, poiché Claude Code scopre il rifiuto lato server della distribuzione solo dall’API. Dopo che Claude Code passa quella distribuzione al caricamento anticipato, gli strumenti da un server che finisce di connettersi diventano disponibili sulla richiesta successiva di Claude.

​

Disabilitare un server senza rimuoverlo

• disabledMcpServers: un elenco di esclusione per server configurati dall’utente, server di plugin, server che la vostra organizzazione fornisce tramite impostazioni gestite, i connettori claude.ai che Claude Code recupera da solo, e server integrati che sono attivati per impostazione predefinita. Claude Code non si connette a un server che elencate qui. Quando disabilitate un connettore claude.ai con l’attivazione/disattivazione /mcp per progetto descritta in Disabilitare connettori claude.ai, Claude Code lo scrive in questo elenco con il suo nome di visualizzazione, ad esempio claude.ai Slack.
• enabledMcpServers: un elenco di consenso per server integrati che sono disabilitati per impostazione predefinita, come computer-use. Claude Code si connette a un server disabilitato per impostazione predefinita solo quando lo elencate qui.

​

Runtime client MCP

• Sessioni su Amazon Bedrock, Claude Platform su AWS, Google Cloud’s Agent Platform, o Microsoft Foundry, a meno che una piattaforma host che incorpora Claude Code non imposti CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sessioni accedute tramite un gateway di app Claude
• Sessioni in cui disattivate la telemetria o il recupero dei flag di funzionalità, ad esempio con DISABLE_TELEMETRY

• Chiede ai server HTTP se supportano la revisione più recente, e la utilizza con quelli che lo fanno. Chiede anche ai server connettori claude.ai nelle sessioni in cui recupera flag di funzionalità. Per fargli chiedere ai server stdio, o ai server connettori in ogni sessione, impostate MCP_PROTOCOL_NEGOTIATION su auto. Si connette a ogni altro server come v1 fa.
• Riceve notifiche list_changed dai server sulla revisione più recente su un flusso che mantiene aperto.
• Non registra un server channel che si connette sulla revisione più recente, perché quella revisione non può portare messaggi di canale.
• Fallisce un accesso OAuth MCP la cui risposta di autorizzazione nomina un emittente inaspettato.

​

Aggiornamenti dinamici degli strumenti

​

Flussi di notifica sul runtime v2

• Il flusso si chiude di nuovo entro 10 secondi: Claude Code lo riapre fino a tre volte, quindi si ferma per quella connessione.
• Il flusso rimane aperto più a lungo di 10 secondi, poi si chiude, come i flussi agli host serverless comunemente fanno: dopo cinque riaperture in un’ora, Claude Code attende circa sei ore prima della prossima.

​

Riconnessione automatica

​

Cadute a metà sessione di un server remoto

• In una sessione interattiva: /mcp mostra il server come in sospeso mentre Claude Code si riconnette. Dopo cinque tentativi falliti, Claude Code contrassegna il server come fallito, o come necessitante di autenticazione quando il server ha bisogno di autorizzazione di nuovo. Quando lo contrassegna come fallito, vedete una notifica MCP server "<name>" disconnected · open /mcp to reconnect. Potete ritentare manualmente da /mcp.
• In esecuzioni claude -p e sessioni Agent SDK: Claude Code si riconnette sulla stessa pianificazione, senza pannello /mcp per mostrare i tentativi.

​

Connessioni iniziali fallite

• La prima connessione di un server WebSocket
• Un errore di autenticazione o non trovato, perché richiede una modifica della configurazione per risolvere. Quando un headersHelper è l’unica fonte dell’intestazione Authorization del server, Claude Code ritenta comunque un errore di autenticazione, perché riesegue l’helper ad ogni tentativo e può raccogliere una credenziale fresca

​

Richieste di scoperta fallite

​

Come Claude apprende che un server è fallito

• Con ricerca degli strumenti, Claude Code dice a Claude quale server è fallito e il suo errore di connessione, quindi Claude segnala il fallimento della connessione nella sua risposta. Claude Code include le stesse informazioni nei risultati di ToolSearch che non trovano strumenti corrispondenti.
• In qualsiasi configurazione senza ricerca degli strumenti, Claude Code non segnala i fallimenti di connessione del server remoto a Claude.

​

Inviare messaggi con canali

​

Backgrounding automatico di lunghe chiamate di strumento

• Chiamate da subagenti; Claude Code mette in background solo le chiamate della conversazione principale
• Chiamate ai server IDE
• Chiamate in modalità non interattiva, a meno che CLAUDE_AUTO_BACKGROUND_TASKS non sia impostato su 1, poiché un’esecuzione una tantum può terminare prima che il risultato arrivi

​

Server MCP forniti da plugin

• I plugin definiscono i server MCP in .mcp.json alla radice del plugin o inline in plugin.json
• Quando abilitate un plugin, Claude Code avvia automaticamente i suoi server MCP
• Claude Code offre gli strumenti MCP del plugin insieme agli strumenti MCP configurati manualmente
• Aggiungete e rimuovete i server del plugin installando o disinstallando il plugin, non con i comandi /mcp. Potete comunque attivare/disattivare un server del plugin installato in /mcp, che impedisce a Claude Code di connettersi ad esso senza rimuovere il plugin

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• Ciclo di vita automatico: i server si connettono e disconnettono in questi punti:
  • All’avvio della sessione, Claude Code connette automaticamente i server per i plugin abilitati. In /mcp, un server plugin remoto (HTTP o SSE) che avete usato prima può mostrare lo stato cached invece; Claude Code lo connette quando Claude chiama per la prima volta uno dei suoi strumenti
  • Se abilitate o disabilitate un plugin durante una sessione, Claude Code connette o disconnette i suoi server MCP quando il cambiamento si applica. Applicare i cambiamenti del plugin senza riavviare descrive quando è. In una sessione senza un terminale interattivo, /reload-plugins non connette o disconnette i server MCP del plugin; quei cambiamenti hanno effetto nella vostra prossima sessione
  • Quando ricaricate, Claude Code mantiene le connessioni live dei server del plugin la cui configurazione è invariata, e fa lo stesso quando sostituite l’elenco dei server MCP della sessione dall’Agent SDK senza nominarli
  • Quando spostate la sessione con /cd su v2.1.246 o successivo, Claude Code connette i server dei plugin che le impostazioni della nuova directory abilitano e disconnette i server dei plugin che non sono più abilitati, quindi non dovete eseguire /reload-plugins dopo lo spostamento
  • Nelle sessioni cloud, una chiamata MCP a un server del plugin che non è ancora connesso, come subito dopo il risveglio di una sessione inattiva, avvia il server su richiesta e attende che si connetta
• Segnaposti di percorso: ${CLAUDE_PLUGIN_ROOT} si risolve nella directory di installazione del plugin, ${CLAUDE_PLUGIN_DATA} nella sua directory di stato persistente, e ${CLAUDE_PROJECT_DIR} nella radice del progetto stabile. La sostituzione si applica a:
  • server stdio: command, args, env
  • server http, sse, e ws: url, headers, e headersHelper
• Accesso all’ambiente utente: accesso alle stesse variabili di ambiente dei server configurati manualmente
• Tipi di trasporto multipli: supporto per trasporti stdio, SSE, HTTP, e WebSocket, anche se il supporto del trasporto può variare per server

mcp__plugin_my-plugin_database-tools__query

​

Ambiti di installazione MCP

​

Ambito locale

# Aggiungi un server con ambito locale (predefinito)
claude mcp add --transport http stripe https://mcp.stripe.com

# Specifica esplicitamente l'ambito locale
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

Ambito del progetto

# Aggiungi un server con ambito del progetto
claude mcp add --transport http shared-server --scope project https://example.com/mcp

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

• Aggiungilo a disabledMcpjsonServers, che lo blocca in ogni modalità di autorizzazione.
• Escludi completamente le impostazioni del progetto con --setting-sources o l’opzione settingSources dell’SDK.
• Avvia la sessione con --strict-mcp-config. Claude Code utilizza quindi solo i server MCP che passi con --mcp-config. Saltare il prompt di approvazione per i server con ambito del progetto che Claude Code non sta caricando richiede Claude Code v2.1.246 o successivo; prima di v2.1.246, una sessione ristretta attendeva comunque l’approvazione per loro, il che lasciava le sessioni in background in attesa all’avvio. Vedi Controllo esclusivo con managed-mcp.json per quello che il flag fa sotto un file MCP gestito.

​

Ambito utente

# Aggiungi un server utente
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

Gerarchia e precedenza dell’ambito

1. Ambito locale
2. Ambito del progetto
3. Ambito utente
4. Server forniti da plugin
5. Connettori claude.ai

​

Espansione delle variabili di ambiente in .mcp.json

​

Sintassi supportata

• ${VAR}: si espande al valore della variabile di ambiente VAR
• ${VAR:-default}: si espande a VAR se impostato, altrimenti utilizza default

​

Posizioni di espansione

• command: il percorso dell’eseguibile del server
• args: argomenti della riga di comando
• env: variabili di ambiente passate al server
• url: per i tipi di server HTTP
• headers: per l’autenticazione del server HTTP

​

Esempio con espansione di variabili

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

​

Variabili non impostate senza un valore predefinito

​

Variabili di credenziali che leggono come vuote

• Le credenziali di Claude Code stesso, come ANTHROPIC_API_KEY e ANTHROPIC_AUTH_TOKEN
• Le credenziali del tuo provider cloud, come AWS_BEARER_TOKEN_BEDROCK
• Altre credenziali che il tuo ambiente contiene, come HTTPS_PROXY e NPM_TOKEN

​

Come i riferimenti appaiono in /mcp e nell’output CLI

• L’URL o la riga di comando nella vista dettagli /mcp di un server
• Output di claude mcp list e claude mcp get

​

Esempi pratici

​

Esempio: Connettiti a GitHub per le revisioni del codice

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Rivedi la PR #456 e suggerisci miglioramenti

Crea un nuovo issue per il bug che abbiamo appena trovato

Mostrami tutte le PR aperte assegnate a me

​

Esempio: Interroga il tuo database PostgreSQL

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

Qual è il nostro ricavo totale questo mese?

Mostrami lo schema per la tabella orders

Trova i clienti che non hanno effettuato un acquisto negli ultimi 90 giorni

​

Autenticazione con server MCP remoti

• Per un server a cui non hai effettuato l’accesso, uno di questi codici di stato lo contrassegna in /mcp in modo che tu possa completare il flusso OAuth.
• Per un connettore claude.ai, un 401 causato dal rifiuto di claude.ai del tuo token di sessione non contrassegna il connettore, perché la riautorizzazione del connettore non può risolvere il tuo accesso. Claude Code mostra invece lo stato di rifiuto del token di sessione.
• Per un server il cui header Authorization hai configurato, in headers o tramite un headersHelper, un 401 o 403 durante la connessione non contrassegna il server, perché la credenziale da correggere è quella che hai configurato. Claude Code segnala invece la connessione come non riuscita. Se hai impostato quell’header da un riferimento ${VAR}, verifica se quella variabile è una che Claude Code legge come vuota.
• Per un connettore consegnato a una sessione cloud, Claude Code non esegue un flusso di accesso, perché il proxy della sessione si autentica al connettore con l’autorizzazione che hai concesso in claude.ai. Quando un connettore lì ha bisogno di autorizzazione di nuovo, riconnettilo su claude.ai/customize/connectors piuttosto che dalla sessione.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

/mcp

​

Autenticazione dalla riga di comando

claude mcp login sentry

claude mcp login sentry --no-browser

​

Utilizza una porta di callback OAuth fissa

# Porta di callback fissa con registrazione dinamica del client
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Utilizza credenziali OAuth pre-configurate

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Sovrascrivi la scoperta dei metadati OAuth

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

Limita gli ambiti OAuth

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

Utilizza intestazioni dinamiche per l’autenticazione personalizzata

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• Il comando deve scrivere un oggetto JSON di coppie chiave-valore stringa su stdout
• Claude Code esegue il comando in una shell e rinuncia dopo 10 secondi
• Claude Code sceglie la directory di lavoro del comando in base a dove hai configurato il server, quindi fornisci lo script come percorso assoluto o mettilo su PATH
• Le intestazioni dinamiche sovrascrivono qualsiasi headers statico con lo stesso nome

​

Dove l’helper viene eseguito

​

Quali variabili un helper può leggere

• Rimosso: un server in un .mcp.json di progetto o in un plugin, e un server inline in un file agent dal tuo progetto o da una directory --add-dir
• Non rimosso: un server di ambito utente o ambito locale, in MCP gestito, da un connettore claude.ai, o fornito dall’SDK o da --mcp-config, e un server inline in un file agent da ~/.claude/agents/, dalle impostazioni gestite, o passato con --agents

​

Affida una cartella prima che il suo headersHelper venga eseguito

• Fiducia che non conta: la fiducia di una cartella genitore, e la fiducia automatica che una sessione claude -p o SDK ottiene per gli hook nei file di impostazioni
• Fino a quando non affidi la cartella: Claude Code connette il server con i suoi soli headers statici. In una sessione claude -p o SDK stampa anche una riga headersHelper not run per server su stderr, dicendoti come concedere la fiducia.
• Fiducia senza una finestra di dialogo: imposta projects["<path>"].hasTrustDialogAccepted su true in ~/.claude.json. <path> è la cartella su cui Project allow rules and workspace trust dice che Claude Code basa la fiducia.

​

Aggiungi server MCP dalla configurazione JSON

# Sintassi di base
claude mcp add-json <name> '<json>'

# Esempio: Aggiunta di un server HTTP con configurazione JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Esempio: Aggiunta di un server stdio con configurazione JSON
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# Esempio: Aggiunta di un server HTTP con credenziali OAuth pre-configurate
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

Importa server MCP da Claude Desktop

# Sintassi di base 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Utilizzare i server MCP da claude.ai

/mcp

• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, o apiKeyHelper è attivo
• Un provider di terze parti come Amazon Bedrock o Agent Platform di Google Cloud è attivo
• ANTHROPIC_PROFILE, le variabili di federazione, o un profilo Anthropic attivo fornisce le credenziali
• CLAUDE_CODE_OAUTH_TOKEN contiene un token da claude setup-token, che può solo effettuare richieste di modello

1. Esegui /login per accedere di nuovo.
2. Ricollega il connettore da /mcp.

​

Come i connettori raggiungono Claude Code

• Sessioni cloud: le voci allowedMcpServers e deniedMcpServers che raggiungono la sessione, ad esempio attraverso impostazioni gestite dal server, filtrano anche i connettori forniti. Il proxy della sessione riscrive l’URL di ogni connettore, quindi un pattern serverUrl scritto per l’URL del connettore stesso non lo corrisponde. Per ammettere i connettori forniti insieme a un allowlist di URL in un ambiente auto-ospitato, aggiungi le voci serverUrl elencate sotto Connector traffic leaves your network. Claude Code elimina i connettori forniti quando un managed-mcp.json è presente sull’host che esegue la sessione, come un host di runner auto-ospitato, indipendentemente dal fatto che tu imposti allowAllClaudeAiMcps.
• Sessioni locali e SSH dell’app desktop: l’app desktop registra i connettori come server type: "sdk" in-process, e nessuna impostazione MCP o managed-mcp.json li raggiunge. Un utente mantiene un connettore fuori dalle proprie sessioni disconnettendolo su claude.ai/customize/connectors. Un’organizzazione blocca i strumenti di un connettore o disattiva completamente Claude Code nell’app desktop.

​

Controlli dell’organizzazione sugli strumenti del connettore

• Strumento impostato su ask: Claude Code richiede su ogni chiamata con il motivo Your organization requires approval for this tool. Il prompt appare anche in modalità permission acceptEdits, auto, e bypassPermissions, e non offre mai un’opzione per ricordare la tua scelta. Le regole Allow che corrispondono allo strumento non saltano il prompt neanche. In modalità dontAsk, che non richiede mai, Claude Code nega la chiamata.
• Strumento impostato su blocked: Claude Code filtra lo strumento prima che Claude lo veda, quindi non appare mai nell’elenco degli strumenti. L’app desktop e la chat claude.ai applicano la stessa impostazione blocked, quindi Claude non può usare lo strumento neanche lì, e non puoi trattenere uno strumento dalle sessioni dell’app desktop mantenendolo disponibile in chat. L’app desktop salta un connettore i cui strumenti sono tutti bloccati.

​

Disabilitare i connettori claude.ai

{
  "disableClaudeAiConnectors": true
}

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

Usa Claude Code come server MCP

# Avvia Claude come server MCP stdio
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Limiti di output MCP e avvisi

• Soglia di avviso di output: Claude Code visualizza un avviso quando l’output di qualsiasi strumento MCP supera 10.000 token
• Limite configurabile: è possibile regolare il massimo numero di token di output MCP consentiti utilizzando la variabile di ambiente MAX_MCP_OUTPUT_TOKENS
• Limite predefinito: il massimo predefinito è 25.000 token
• Ambito: la variabile di ambiente si applica agli strumenti che non dichiarano il proprio limite. Gli strumenti che impostano anthropic/maxResultSizeChars utilizzano invece quel valore per il contenuto di testo, indipendentemente da ciò che MAX_MCP_OUTPUT_TOKENS è impostato. Gli strumenti che restituiscono dati di immagine sono comunque soggetti a MAX_MCP_OUTPUT_TOKENS
• Oltre il limite: quando un risultato senza contenuto di immagine supera il limite, Claude Code lo salva in un file e lo sostituisce nella conversazione con un messaggio che nomina il percorso del file, in modo che Claude legga il file quando ha bisogno del contenuto. Il file si trova nella directory tool-results della sessione sotto ~/.claude/projects/.

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

Aumentare il limite per uno strumento specifico

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

Immagini nei risultati degli strumenti

​

Tool input schemas con un combinatore a livello radice

• allOf: le proprietà di ogni ramo vengono unite, e l’elenco required di ogni ramo si applica ancora
• anyOf e oneOf: le proprietà di ogni ramo vengono unite, e l’elenco required di ogni ramo viene descritto nella descrizione dello strumento invece di essere applicato dallo schema

​

Strumenti con schemi di input non validi

• I nomi delle proprietà di primo livello devono essere lunghi da 1 a 64 caratteri e utilizzare solo lettere ASCII e cifre, _, . e -
• Lo schema deve essere valido rispetto al meta-schema JSON Schema draft 2020-12. Claude Code applica questo controllo agli schemi che non dichiarano alcun $schema e agli schemi che dichiarano draft 2020-12. Uno schema che dichiara qualsiasi altro dialetto salta questo controllo, anche se il controllo del nome della proprietà sopra indicato si applica comunque

​

Richiedere approvazione per uno strumento specifico

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

Rispondere alle richieste di elicitazione MCP

• Modalità modulo: Claude Code mostra una finestra di dialogo con campi modulo definiti dal server (ad esempio, un prompt di nome utente e password). Compilate i campi e inviate.
• Modalità URL: Claude Code chiede se aprire un collegamento nel vostro browser e lo apre quando accettate. I server utilizzano questa modalità per un flusso che si conclude al di fuori del terminale, come l’accesso.

​

Utilizzare le risorse MCP

​

Referenziare le risorse MCP

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

Compare @postgres:schema://users with @docs:file://database/user-model

​

Scalare con la ricerca di strumenti MCP

​

Per gli autori di server MCP

• Quale categoria di attività gestiscono i vostri strumenti
• Quando Claude dovrebbe cercare i vostri strumenti
• Capacità chiave che il vostro server fornisce

​

Configurare la ricerca di strumenti

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 e successivi: la ricerca di strumenti è attiva per impostazione predefinita, come su Anthropic API.
• Modelli precedenti di Agent Platform: Claude Code carica tutti gli strumenti MCP in anticipo, perché i loro stack di servizio rifiutano l’intestazione beta richiesta. ENABLE_TOOL_SEARCH=true non ignora questo.

# Usa una soglia personalizzata del 5%
ENABLE_TOOL_SEARCH=auto:5 claude

# Disabilita completamente la ricerca di strumenti
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

​

Esentare un server dal rinvio

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

Usa i prompt MCP come comandi

​

Esegui i prompt MCP

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

Configurazione MCP gestita