MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti

Aggiungere un server

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

I server stdio sono programmi che Claude Code avvia per te: la maggior parte dei server della community sono pacchetti npm o Python eseguiti in questo modo. I server remoti sono URL; si autenticano con OAuth (esegui /mcp in una sessione e segui la procedura nel browser) oppure con un'intestazione che passi al momento dell'aggiunta, come nell'esempio di PostHog. Consulta la documentazione di ciascun fornitore per l'URL attuale: gli endpoint remoti possono cambiare.

Ambiti e .mcp.json

• local (predefinito) — salvato nelle tue impostazioni utente, solo per questo progetto. Server personali e privati.
• project (--scope project) — scritto in .mcp.json nella radice del repository e condiviso con chiunque lo cloni. La prima volta, Claude Code chiede conferma prima di considerare attendibili i server di un progetto.
• user (--scope user) — disponibile in ogni progetto sul tuo computer.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json supporta l'espansione delle variabili d'ambiente, quindi il repository può includere la definizione del server mentre ogni sviluppatore fornisce le proprie credenziali.

Usare un server in una sessione

Una volta stabilita la connessione, gli strumenti del server sono subito disponibili: chiedi «gli errori delle ultime 24 ore da PostHog» e Claude Code richiama lo strumento. Le risorse esposte dal server possono essere richiamate con menzioni con @ (@github:issue://123), che le inseriscono nel contesto su richiesta. I prompt definiti da un server compaiono come comandi slash sotto /mcp__<server>__<prompt>. /mcp mostra lo stato della connessione, consente di riconnetterti o autenticarti ed elenca ogni strumento con la relativa descrizione.

Esempi da copiare

• PostHog MCP — analisi del prodotto direttamente dall'agente: «quale feature flag controlla questo codice e qual è il suo stato di rollout?» PostHog pubblica un server MCP remoto; aggiungilo con --transport http e la tua chiave API personale come intestazione bearer.
• GitHub — issue e pull request come contesto; abbinalo all'Action della guida a GitHub per il ciclo di revisione.
• Playwright — un browser reale per i test end-to-end e per verificare l'interfaccia che hai appena modificato; consulta la guida all'automazione del QA.
• Postgres / SQLite — query e migrazioni che tengono conto dello schema; assegna un utente con accesso in sola lettura, a meno che tu non intenda consentire modifiche.
• Filesystem esterno al repository — --add-dir è più semplice per le directory aggiuntive; MCP serve per ciò che non è un file.

Costi e contesto

Ogni risultato restituito da uno strumento di un server MCP entra nella conversazione e viene reinviato a ogni turno successivo. Un server che restituisce 5,000 righe fa esplodere il contesto. Preferisci strumenti con limiti, chiedi riepiloghi e /compact dopo una query pesante. I server vengono eseguiti localmente o presso il fornitore; non passano attraverso l'endpoint del modello, quindi ANTHROPIC_BASE_URL=https://aiprimetech.io non viene influenzato: vengono fatturati solo i token consumati dai risultati.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.