Guide pratiche

Come configurare un server MCP in Claude Code, Cursor e VS Code

Che cos'è il Model Context Protocol, come aggiungere un server a Claude Code, Cursor e VS Code, i server di riferimento e le regole di sicurezza, secondo la documentazione ufficiale.

Di Audryk · 20 ottobre 2026

• Guide pratiche
• Agenti di programmazione
• Nuove tecnologie di IA
• #guide
• #MCP
• #Claude Code

Un server MCP dà a un agente di codice accesso a uno strumento esterno: un repository GitHub, un database, un browser, la documentazione di una libreria. Questa guida spiega il protocollo, poi la configurazione in tre client comuni. Comandi e file sono tratti dalla documentazione ufficiale, verificata il 2026-10-20.

Che cos'è MCP?

Il Model Context Protocol (MCP) è uno standard open source per collegare le applicazioni di IA a sistemi esterni: file locali, database, strumenti come un motore di ricerca, o flussi di lavoro. I suoi autori lo paragonano a una porta USB-C per le applicazioni di IA (modelcontextprotocol.io). Vedere anche la voce MCP del glossario.

• Cosa espone un server: tool (azioni che il modello può eseguire), risorse (dati di contesto) e prompt (modelli di istruzioni) (architettura MCP).
• Due trasporti: stdio, quando il client avvia il server come processo locale sulla stessa macchina; Streamable HTTP, per un server remoto, che supporta bearer token, chiavi API e header personalizzati.

Aggiungere un server a Claude Code

Claude Code si configura dalla riga di comando (Anthropic). Se l'agente non è ancora installato, vedere la nostra guida Come installare e iniziare con Claude Code.

Server remoto (HTTP), l'opzione raccomandata per i servizi online:

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

Server locale (stdio): tutto ciò che segue -- è il comando che avvia il server.

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Il trasporto SSE è deprecato: Anthropic raccomanda HTTP dove il server lo supporta. Per gestire i server:

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/mcp

Tre ambiti (opzione --scope):

• local (predefinito): il progetto corrente, solo per voi, memorizzato in ~/.claude.json;
• project: condiviso con il team tramite un file .mcp.json alla radice del repository, da sottoporre a commit;
• user: tutti i vostri progetti, memorizzato in ~/.claude.json.

Un repository clonato non può approvare da solo i server del proprio .mcp.json: restano in sospeso finché non accettate la finestra di fiducia dello spazio di lavoro. Esempio ufficiale con il server remoto di GitHub, autenticato con un personal access token dai permessi ristretti:

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

claude mcp add salva la configurazione senza convalidare il token: verificate la connessione con /mcp.

Aggiungere un server a Cursor

Cursor offre l'installazione con un clic dal suo Marketplace (pagina Customize, pulsante «Add to Cursor», accesso OAuth), oppure la configurazione manuale in un file mcp.json (Cursor):

• .cursor/mcp.json nel progetto, per gli strumenti specifici del progetto;
• ~/.cursor/mcp.json nella vostra home, per gli strumenti disponibili ovunque.

Un server locale avviato con Node.js, come mostrato nella documentazione di Cursor:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Per un server remoto, la voce usa una chiave url (e facoltativamente headers) al posto di command. Cursor supporta stdio, SSE e Streamable HTTP e risolve la sintassi ${env:NAME}, così potete leggere un segreto da una variabile d'ambiente invece di scriverlo in chiaro.

Aggiungere un server a VS Code

In VS Code, aprite la Command Palette (⇧⌘P su Mac, Ctrl+Shift+P su Windows e Linux) ed eseguite MCP: Add Server (Microsoft). Scegliete HTTP se l'editore del server fornisce un URL, Command (stdio) se fornisce un comando. L'esempio della documentazione, il server Playwright, richiede Node.js 18 o successivo:

node --version
npx --version

Scegliete Command (stdio) e inserite:

npx -y @playwright/mcp@latest

Date al server un ID (per esempio playwright), poi scegliete dove memorizzarlo:

• Global > Copilot Global: ~/.copilot/mcp-config.json, per tutti i vostri spazi di lavoro;
• **.mcp.json alla radice dello spazio di lavoro**: da condividere con il team (impostazione sperimentale chat.mcp.workspaceRootConfig.enabled);
• **.vscode/mcp.json o l'mcp.json del profilo utente**: ancora disponibili, ma etichettati come deprecati nel flusso guidato.

Attenzione al formato: i file portabili usano la chiave mcpServers, il formato di VS Code usa servers. La galleria dei server (anteprima) si apre digitando @mcp nella vista Estensioni. Microsoft raccomanda inoltre di verificare che uno strumento del server sia stato effettivamente chiamato nella vostra sessione: una configurazione aggiunta non è la prova che l'agente la usi.

Server di riferimento

Il progetto MCP mantiene server di riferimento per provare il protocollo: Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking e Time (esempi ufficiali). I server TypeScript si eseguono con npx, quelli Python con uvx:

npx -y @modelcontextprotocol/server-memory

uvx mcp-server-git

I server mantenuti dalle aziende per le proprie piattaforme sono elencati nel repository modelcontextprotocol/servers.

Sicurezza: le regole da seguire

Un server MCP locale non è un plugin in sandbox: è un normale processo che eredita le vostre variabili d'ambiente, può leggere tutto ciò che il vostro account può leggere (chiavi SSH, credenziali cloud, directory home) e può aprire connessioni di rete (modelcontextprotocol.io). Le raccomandazioni ufficiali:

• Fare l'inventario: rimuovere i server che non usate più e sapere da dove viene ciascuno di quelli rimasti;
• Preferire la versione remota quando un server non ha bisogno di nulla della vostra macchina;
• Verificare l'editore e fissare la versione invece di usare latest, con un'abitudine di aggiornamento deliberata. L'esempio Playwright di VS Code usa @latest: adattatelo alla vostra policy;
• Isolare i server di terze parti (container, sandbox o macchina virtuale);
• Limitare l'accesso: credenziali per singolo server, accesso al filesystem ristretto a una directory specifica, sola lettura dove possibile, traffico di rete in uscita limitato;
• Leggere le descrizioni degli strumenti: il modello le legge come istruzioni, il che apre la porta alla prompt injection.

Anthropic chiede inoltre di verificare di fidarsi di ciascun server prima di collegarlo, soprattutto dei server che recuperano contenuti esterni (Anthropic). Cursor raccomanda chiavi API con permessi minimi e, per le integrazioni critiche, la revisione del codice sorgente (Cursor).

Per andare oltre

• Le pagine degli strumenti indicano quali supportano MCP: Claude Code, Cursor, GitHub Copilot, Cline.
• Confrontare gli editor: Cursor, Devin Desktop o Copilot.
• I rischi del codice generato: cosa dicono gli studi sulla sicurezza.

Fonti

• Model Context Protocol: What is MCP?, verificato il 2026-10-20
• Model Context Protocol: Architecture overview, verificato il 2026-10-20
• Model Context Protocol: Example Servers, verificato il 2026-10-20
• Model Context Protocol: Local Server Security, verificato il 2026-10-20
• Claude Code Docs: Connect Claude Code to tools via MCP, verificato il 2026-10-20
• Cursor Docs: Model Context Protocol, verificato il 2026-10-20
• VS Code Docs: Add MCP servers in VS Code, verificato il 2026-10-20

In sintesi: un server MCP si aggiunge con un comando o poche righe di JSON, ma un server locale gira con i vostri permessi: installate solo server di editori identificati, con versioni fissate e accesso limitato.

Avete notato un errore in questo articolo? Segnalatelo · La nostra politica sulle correzioni