Che cos'è MCP?

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti IA di usare strumenti e dati tramite server. Un server può essere un programma locale che l'assistente avvia sul tuo computer e con cui comunica tramite standard input e output (stdio), oppure un server remoto che l'assistente raggiunge via HTTP. Ogni assistente elenca i propri server in un file di configurazione dedicato, e ogni file è leggermente diverso.

Come si usa

  1. Scegli il tuo client: l'assistente o l'editor che usi.
  2. Assegna al server un nome composto da lettere, numeri, trattini e trattini bassi.
  3. Per un server locale, inserisci il comando che lo avvia (ad esempio npx, uvx o docker), i suoi argomenti, uno per riga, ed eventuali variabili d'ambiente, come le chiavi API, nel formato KEY=value. Se hai incollato un'intera riga di comando nel campo Comando, il pulsante di divisione al suo interno sposta negli argomenti tutto ciò che segue la prima parola.
  4. Per un server remoto, scegli URL remoto e inserisci l'URL del server ed eventuali intestazioni, come Authorization: Bearer <token>.
  5. Copia la configurazione nel file indicato in Dove viene inserito oppure scaricala. Se il file contiene già dei server, aggiungi la nuova voce accanto a quelle esistenti all'interno di mcpServers ([mcp_servers] in Codex) invece di sostituire l'intero file.
  6. Riavvia l'app o ricarica i suoi server MCP.

Per Claude Code, Codex CLI, Gemini CLI e VS Code, la casella Comando fornisce anche il comando da terminale che aggiunge il server al posto tuo.

Client

Client File di configurazione Da sapere
Claude Desktop claude_desktop_config.json Contiene solo server locali. I server remoti si aggiungono nell'app in Impostazioni > Connettori > Aggiungi connettore personalizzato.
Claude Code .mcp.json nella cartella principale del progetto claude mcp add salva invece i server in ~/.claude.json, solo per te.
Cursor .cursor/mcp.json nel progetto, oppure ~/.cursor/mcp.json
VS Code con GitHub Copilot .mcp.json nella cartella principale dell'area di lavoro, oppure ~/.copilot/mcp-config.json Il vecchio formato servers in .vscode/mcp.json serve solo per l'harness locale deprecato di VS Code.
Codex CLI ~/.codex/config.toml Un file TOML. Le intestazioni di un server remoto si possono impostare solo nel file, non con codex mcp add.
Gemini CLI .gemini/settings.json nel progetto, oppure ~/.gemini/settings.json I server remoti usano httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json, oppure .devin/mcp_config.json Windsurf è stato rinominato Devin Desktop. Le chiavi personali vanno in .devin/mcp_config.local.json, che resta fuori dal controllo di versione.

Chrome salva un file scaricato chiamato .mcp.json come mcp.json, quindi aggiungi di nuovo il punto iniziale quando lo sposti nella posizione corretta.

Proteggere le chiavi

I file di configurazione conservano le chiavi API in chiaro. Non eseguire il commit di un file di progetto con chiavi reali in un repository condiviso. La maggior parte dei client può leggere una chiave dalle variabili d'ambiente anziché dal file, ciascuno con una propria sintassi, descritta nella relativa documentazione.

Tutto viene generato nel tuo browser, quindi i comandi, gli URL e le chiavi che inserisci non vengono inviati da nessuna parte.