Generatore di configurazioni MCP — Claude, Cursor, VS Code, Windsurf e Codex
Definisci un server MCP una volta sola e ottieni il file di configurazione o il comando esatto per Claude Desktop, Claude Code, Cursor, VS Code, Windsurf e Codex.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.githubcopilot.com/mcp/",
"--header",
"Authorization:${MCP_HEADER_1}"
],
"env": {
"MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
}
}
}
}
- File: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json (aprilo da Settings > Developer > Edit Config). Dopo aver salvato, chiudi completamente Claude e riaprilo.
- I server remoti vengono collegati tramite mcp-remote (richiede Node.js). Con i piani a pagamento puoi invece aggiungere l'URL in Settings > Connectors, che gestisce OAuth per te.
- Claude Desktop non espande ${VAR} in questo file; sostituisci questi segnaposto con valori reali.
Funziona interamente nel tuo browser. Le configurazioni contengono spesso token API, quindi nulla di ciò che scrivi o incolli viene caricato o salvato. Sfoglia tutti gli strumenti gratuiti.
Hai trovato un problema o qualcosa che potrebbe andare meglio? Leggiamo ogni messaggio e sistemiamo le cose in fretta.
Questo generatore di configurazioni MCP scrive le impostazioni dei server Model Context Protocol per tutti i principali client IA a partire da un unico modulo. Ogni client vuole un file leggermente diverso: Claude Desktop e Cursor usano un oggetto "mcpServers", VS Code usa "servers" con un "type" obbligatorio, Windsurf chiama l'URL remoto "serverUrl", Claude Code richiede "type" sulle voci remote e Codex usa tabelle TOML. Inserisci il comando o l'URL una volta e copia la versione giusta per lo strumento che usi.
Il validatore fa il contrario: incolla una configurazione che non si carica e ti indica l'errore JSON, il campo mancante o la chiave che il client non legge, poi carica i server nel modulo così puoi convertirli. Verifica la struttura, non se il pacchetto del server esiste o se il token è valido; se un server continua a non funzionare, controlla il log MCP del client.
Come si usa
- Fai clic su un preset come Filesystem o GitHub, oppure aggiungi un server vuoto.
- Per un server locale, imposta il comando (npx, uvx, docker) e metti ogni argomento su una riga a sé. Per un server remoto, imposta l'URL ed eventuali header.
- Facoltativamente, spunta l'opzione che tiene i segreti fuori dal file e sostituisce i valori con riferimenti ${VAR}.
- Scegli il tuo client, poi copia o scarica l'output e salvalo nel percorso indicato sotto.
- Riavvia il client (chiudi completamente Claude Desktop) perché ricarichi la configurazione. Per correggere un file esistente, incollalo in Valida e converti.
Domande frequenti
Dove si trova claude_desktop_config.json?
Su macOS è ~/Library/Application Support/Claude/claude_desktop_config.json e su Windows %APPDATA%\Claude\claude_desktop_config.json. Il modo più semplice per aprirlo è Impostazioni > Sviluppatore > Modifica configurazione in Claude Desktop. Dopo aver salvato chiudi completamente e riapri Claude, perché il file viene letto solo all'avvio.
Qual è la differenza tra .mcp.json di Claude Code e claude mcp add?
claude mcp add registra un server dal terminale. Con l'ambito local predefinito viene salvato in ~/.claude.json solo per te e il progetto corrente; --scope user lo rende disponibile in tutti i tuoi progetti; --scope project lo scrive in .mcp.json nella radice del progetto, così il team lo condivide tramite il controllo di versione. Ogni voce di .mcp.json dovrebbe avere un "type" (stdio, http o sse); una voce con url ma senza type viene letta come stdio e non funziona.
Perché VS Code ignora la mia configurazione mcpServers?
VS Code legge .vscode/mcp.json con una chiave di primo livello "servers", non "mcpServers", e ogni server richiede "type": "stdio", "http" o "sse". Un file copiato dal README di Claude o Cursor quindi non carica nulla. Incollalo nel validatore e convertilo nel formato di VS Code.
Come tengo le chiavi API fuori dalla configurazione MCP?
Fai riferimento a variabili d'ambiente invece di incollare i valori. Claude Code espande ${VAR} e ${VAR:-default}; Cursor e Windsurf usano ${env:VAR}; VS Code supporta ${env:VAR} e i prompt ${input:id}, che memorizzano il segreto in modo sicuro; Codex inoltra le variabili con env_vars, env_http_headers e bearer_token_env_var. Claude Desktop non espande le variabili nella sua configurazione, quindi lì i valori devono essere letterali.
Come si aggiunge un server MCP remoto a Claude Desktop?
Il file di configurazione di Claude Desktop avvia solo comandi locali. Con i piani a pagamento puoi aggiungere l'URL di un server remoto in Impostazioni > Connettori, che gestisce anche l'accesso OAuth. Altrimenti usa mcp-remote come ponte: il comando è npx con gli argomenti -y, mcp-remote e l'URL del server, più le opzioni --header per l'autenticazione. Il generatore scrive questo ponte per te quando scegli Claude Desktop.
Qual è la differenza tra i trasporti stdio, HTTP e SSE?
I server stdio girano come processo locale che il client avvia e con cui comunica tramite standard input e output, adatti agli strumenti che leggono file o lavorano sulla tua macchina. I server Streamable HTTP girano in remoto a un URL e sono lo standard attuale per i server ospitati. SSE è il trasporto remoto più vecchio; Claude Code lo segna come deprecato e Codex supporta solo lo streamable HTTP, quindi preferisci HTTP quando un server offre entrambi.
Percorsi e formati dei file di configurazione MCP
• Claude Desktop: claude_desktop_config.json in ~/Library/Application Support/Claude (macOS) o %APPDATA%\Claude (Windows). Chiave di primo livello "mcpServers"; le voci hanno command, args ed env.
• Claude Code: .mcp.json nella radice del progetto (ambito project) o ~/.claude.json (ambiti local e user, gestiti da claude mcp add). Chiave di primo livello "mcpServers" con "type" su ogni voce.
• Cursor: .cursor/mcp.json nel progetto o ~/.cursor/mcp.json a livello globale. "mcpServers"; le voci remote usano "url" e "headers".
• VS Code: .vscode/mcp.json nel workspace, oppure il file a livello utente aperto con "MCP: Open User Configuration". Chiave di primo livello "servers" più "inputs" facoltativo.
• Windsurf: ~/.codeium/windsurf/mcp_config.json. La documentazione di Windsurf ora si trova sotto Devin Desktop, che usa ~/.config/devin/mcp_config.json (macOS/Linux) o %APPDATA%\devin\mcp_config.json. Le voci remote usano "serverUrl".
• Codex: ~/.codex/config.toml, oppure .codex/config.toml in un progetto attendibile. Una tabella [mcp_servers.<name>] per server, con command/args/env oppure url più bearer_token_env_var e http_headers.
Motivi comuni per cui un server MCP non si carica
• L'intero comando è in "command" ("npx -y @scope/server"). Il client cerca un eseguibile con quel nome completo. Metti npx in command e il resto in args, un elemento ciascuno.
• Una virgola finale o un commento // nel JSON. Solo mcp.json di VS Code accetta commenti; gli altri client richiedono JSON rigoroso.
• npx o uvx non trovati. Su macOS le app con interfaccia grafica non sempre ereditano il PATH della shell; usa come comando il percorso completo restituito da `which npx`.
• La chiave di primo livello sbagliata: "servers" in un file di Claude o Cursor, oppure "mcpServers" in VS Code.
• Una voce remota senza "type" in .mcp.json di Claude Code, che viene quindi trattata come comando locale.
• Il client non è stato riavviato. Claude Desktop legge il file solo all'avvio; Cursor e VS Code mostrano lo stato dei server nei rispettivi pannelli delle impostazioni MCP.
Note di sicurezza prima di aggiungere un server
Un server MCP gira con i tuoi permessi: un server filesystem può leggere e modificare ogni cartella che elenchi, e un server di database può eseguire query con le credenziali che gli fornisci. Concedi l'ambito più ristretto che funziona, come una sola cartella di progetto, un utente di database in sola lettura o un token GitHub a grana fine limitato ai repository che ti servono.
Installa i server dall'editore ufficiale, fissa le versioni per tutto ciò che tocca la produzione e preferisci server remoti con OAuth a token di lunga durata incollati in un file. Tratta l'output degli strumenti come input non attendibile: una pagina web o una issue recuperata da un server può contenere istruzioni rivolte al modello.
Strumenti gratuiti correlati
- Formattatore JSON — Formatta, minifica e valida JSON, con gli errori di parsing localizzati per riga e colonna. Nel tuo browser, senza upload.
- Generatore di template di prompt — Scrivi un prompt con {{variables}}, compilalo da un modulo o da un CSV ed esporta un prompt per riga come testo, CSV o file batch per OpenAI e Anthropic.
- Calcolatore costi API LLM — Confronta il costo del tuo carico di lavoro su oltre 40 modelli, con caching, sconti batch, fasce per contesti lunghi e token di ragionamento. Prezzi con fonte e data.
- Generatore di llms.txt — Crea un llms.txt conforme alla specifica da un modulo, un elenco di URL o la sitemap, valida un file esistente e genera regole robots.txt per i crawler IA.