Generatore di configurazioni MCP
Crea la configurazione del server MCP per Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI o Devin Desktop (in precedenza Windsurf): inserisci un comando o l'URL di un server e copia il JSON o il TOML insieme al percorso del file in cui inserirlo.
Input
Output
| Posizione | File |
|---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
Server remoti | Impostazioni > Connettori > Aggiungi connettore personalizzato |
Leggimi
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
- Scegli il tuo client: l'assistente o l'editor che usi.
- Assegna al server un nome composto da lettere, numeri, trattini e trattini bassi.
- Per un server locale, inserisci il comando che lo avvia (ad esempio
npx,uvxodocker), i suoi argomenti, uno per riga, ed eventuali variabili d'ambiente, come le chiavi API, nel formatoKEY=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. - Per un server remoto, scegli URL remoto e inserisci l'URL del server ed eventuali intestazioni, come
Authorization: Bearer <token>. - 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. - 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.