Guida

File di configurazione MCP: Claude, Cursor, VS Code e altri

6 min di letturaA cura del team di Delta MCP

Una griglia di dodici app di IA, tra cui Claude, Cursor, VS Code e Windsurf, con l’icona di Delta MCP, accanto alle chiavi di configurazione mcpServers, servers e context_servers.

La risposta breve

La maggior parte delle app di IA tiene i server MCP in un unico file JSON, sotto la chiave mcpServers. VS Code usa servers, Zed context_servers e Codex una tabella TOML. Trova la tua app qui sotto, modifica il suo file, poi chiudila e riaprila. I limiti sono rari: VS Code ammette 128 strumenti per richiesta, Windsurf 100.

In questa guida

Dove si trova il file di configurazione MCP di ogni app?

La maggior parte delle app ha un file per tutti i tuoi progetti e uno per un singolo progetto. La tabella indica entrambi, come aprirli e la chiave sotto cui vanno i tuoi server.

Dove si trova il file di configurazione MCP di ogni app?
AppFile di configurazioneChiave
Claude Codeclaude mcp add, oppure /mcp in una sessione
  • Tutti i progetti~/.claude.json
  • Un progetto.mcp.json
I tuoi server e quelli di ogni progetto sono entrambi in ~/.claude.json. Il .mcp.json di un progetto è pensato per essere condiviso con il tuo team.
mcpServers
Claude DesktopSettings (Impostazioni), Developer, Edit Config
  • macOS~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows%APPDATA%\Claude\claude_desktop_config.json
Solo server locali. Claude Desktop è disponibile su macOS e Windows.
mcpServers
Cursor
  • Tutti i progetti~/.cursor/mcp.json
  • Un progetto.cursor/mcp.json
mcpServers
VS CodeComando: MCP: Open User Configuration
  • macOS~/Library/Application Support/Code/User/mcp.json
  • Windows%APPDATA%\Code\User\mcp.json
  • Linux~/.config/Code/User/mcp.json
  • Un progetto.vscode/mcp.json
serversIl formato proprio di VS Code. Un .mcp.json portabile nella radice del progetto usa mcpServers.
WindsurfLa documentazione di Windsurf ora si trova su Devin Desktop
  • macOS · Linux~/.config/devin/mcp_config.json
  • Windows%APPDATA%\devin\mcp_config.json
  • ~/.codeium/windsurf/mcp_config.json
Il primo percorso è quello attuale, sotto Devin Desktop. Le versioni precedenti di Windsurf usano l’ultimo.
mcpServers
Gemini CLI
  • Tutti i progetti~/.gemini/settings.json
  • Un progetto.gemini/settings.json
mcpServers
Codexcodex mcp add <name> -- <command>
  • Tutti i progetti~/.codex/config.toml
  • Un progetto.codex/config.toml
Il file di progetto vale solo per i progetti attendibili.
[mcp_servers.<name>]Una tabella TOML per server.
LM StudioScheda Program, Install, Edit mcp.json
  • ~/.lmstudio/mcp.json
mcpServers
ClineIcona MCP Servers, scheda Configure, Configure MCP Servers
  • ~/.cline/data/settings/cline_mcp_settings.json
  • …/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Imposta CLINE_MCP_SETTINGS_PATH per spostare il file. Dentro VS Code si trova nella cartella delle impostazioni utente.
mcpServers
Roo CodeMCP settings, Edit Global MCP o Edit Project MCP
  • Tutti i progetti…/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  • Un progetto.roo/mcp.json
Il file di progetto ha la precedenza su quello globale.
mcpServers
Amazon QPannello della chat, icona degli strumenti
  • Tutti i progetti~/.aws/amazonq/default.json
  • Un progetto.amazonq/default.json
Il pannello scrive default.json. I più vecchi ~/.aws/amazonq/mcp.json e .amazonq/mcp.json vengono ancora letti di default.
mcpServersNel vecchio mcp.json.
ZedComando: zed: open settings file
  • macOS · Linux~/.config/zed/settings.json
  • Windows%APPDATA%\Zed\settings.json
context_servers

~ è la tua cartella home: C:\Users\you su Windows.

Come configuri un server MCP remoto in ogni app?

Un server remoto (HTTP) ha bisogno di un URL, ma ogni app dà nomi diversi ai campi. La stessa voce non si può incollare da un’app all’altra.

Come configuri un server MCP remoto in ogni app?
AppCampiDa sapere
Claude Code
  • "type": "http"
  • "url"
Claude Desktop — Non si scrive in questo file. Aggiungilo come connettore personalizzato in Connectors, nelle impostazioni dell’app.
Cursor
  • "url"
  • "headers"facoltativo
VS Code
  • "type": "http"
  • "url"
Windsurf
  • "serverUrl"
  • "url"
  • "headers"facoltativo
Per l’indirizzo va bene uno qualsiasi dei due nomi.
Gemini CLI
  • "httpUrl"
  • "url"
  • "headers"facoltativo
httpUrl è HTTP in streaming, url è SSE.
Codex
  • url
  • bearer_token_env_varfacoltativo
  • http_headersfacoltativo
Scritto nella tabella TOML del server.
LM Studio
  • "url"
  • "headers"facoltativo
Cline
  • "type": "streamableHttp"
  • "url"
  • "headers"facoltativo
Usa sse per il trasporto più vecchio.
Roo Code
  • "type": "streamable-http"
  • "url"
  • "headers"facoltativo
Usa sse per il trasporto più vecchio.
Amazon Q — Si imposta nel pannello MCP: scegli http come trasporto, poi l’URL e le intestazioni facoltative.
Zed
  • "url"
  • "headers"facoltativo

Qual è il limite di strumenti MCP in ogni app?

I limiti di strumenti sono rari. Due app ne dichiarano uno. Le altre gestiscono a modo loro gli elenchi lunghi di strumenti.

Qual è il limite di strumenti MCP in ogni app?
AppLimiteCosa fa con gli elenchi lunghi di strumenti
VS Code 128 strumenti per richiesta Oltre questa soglia, VS Code segnala Cannot have more than 128 tools per request. Deseleziona strumenti o interi server nel selettore degli strumenti, oppure imposta github.copilot.chat.virtualTools.threshold perché VS Code raggruppi gli strumenti simili.
Windsurf 100 strumenti alla volta Disattiva gli strumenti uno a uno con disabledTools nella voce del server.
Cursor Nessuno dichiarato Spesso citato a 40 strumenti. La documentazione di Cursor non indica alcun limite, e il suo post di gennaio 2026 descrive il caricamento su richiesta delle descrizioni degli strumenti MCP.
Claude Code Nessuno dichiarato Tool Search è attivo di default: nel tuo contesto entrano solo i nomi degli strumenti finché non ne viene usato uno.
Codex Nessuno dichiarato Ogni server accetta elenchi enabled_tools e disabled_tools.
Amazon Q Nessuno dichiarato Ogni strumento è impostato su Ask, Always allow o Deny.

Claude Desktop, Gemini CLI, LM Studio, Cline, Roo Code e Zed non dichiarano alcun limite di strumenti.

Un limite riguarda quanti strumenti ci stanno. Il costo di quegli strumenti in token è un’altra questione, e la guida qui sotto risponde. Perché MCP consuma così tanti token

Perché il tuo server MCP non compare?

Scorri questo elenco. Segue la guida alla risoluzione dei problemi del progetto MCP, scritta per Claude Desktop. I primi quattro passi valgono per qualsiasi app.

  1. Chiudi completamente l’app, poi riaprila

    La guida di Claude Desktop dice di chiuderlo completamente e riavviarlo dopo aver modificato il suo file. Altre app possono ricaricarsi da sole: riapri la tua se il server non compare.

  2. Controlla il JSON e la chiave

    Un errore di sintassi, come una virgoletta mancante o una virgola di troppo, può impedire all’app di leggere il file. Poi controlla la chiave: mcpServers nella maggior parte delle app, servers in VS Code, context_servers in Zed.

  3. Usa percorsi assoluti

    I percorsi in args devono essere assoluti, non relativi.

  4. Esegui tu il comando

    Incolla il comando del server e i suoi argomenti in un terminale. Se fallisce lì, nemmeno l’app può avviarlo.

  5. Leggi i log

    Claude Desktop scrive mcp.log e un mcp-server-NAME.log per ogni server, in ~/Library/Logs/Claude su macOS e %APPDATA%\Claude\logs su Windows.

  6. Su Windows, controlla APPDATA

    Se un log mostra ${APPDATA} dentro un percorso, aggiungi APPDATA all’env del server con il suo valore completo, come C:\Users\you\AppData\Roaming\.

Devi modificare questi file a mano?

Non per vederli tutti in un posto solo. Delta MCP legge le impostazioni MCP di dodici app di IA, quelle delle tabelle qui sopra, senza cambiare nulla, ed elenca ogni server che trova.

Per usare quei server tramite Delta MCP, passa un’app a Delta MCP aggiungendo una sola voce, chiamata mcpdelta. Disattiva la voce diretta di ogni server che sposta e conserva l’originale, per rimetterla com’era. Dieci app vengono configurate al posto tuo; Codex e Zed per ora si configurano a mano. Prima di ogni modifica salva una copia datata del file.

App supportate, nel dettaglio

Domande

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ù rapido è Settings, Developer, Edit Config, che crea il file se non esiste. Claude Desktop è disponibile su macOS e Windows.

Dove si trova il mcp.json di Cursor?

~/.cursor/mcp.json contiene i server di tutti i tuoi progetti, e .cursor/mcp.json dentro un progetto contiene quelli di quel progetto. Entrambi usano la chiave mcpServers.

Dove si trova il mcp.json di VS Code?

Quello di un progetto è .vscode/mcp.json. Il tuo è nella cartella del tuo profilo utente: esegui MCP: Open User Configuration per aprirlo. VS Code scrive i server sotto servers, non mcpServers.

Qual è il limite di strumenti MCP in VS Code?

Una richiesta di chat può avere al massimo 128 strumenti abilitati alla volta, e VS Code segnala Cannot have more than 128 tools per request quando li superi. Deseleziona strumenti o server nel selettore degli strumenti, oppure imposta github.copilot.chat.virtualTools.threshold perché VS Code raggruppi gli strumenti simili.

Cursor ha un limite di strumenti MCP?

La sua documentazione non ne indica nessuno; la cifra spesso citata è 40 strumenti. A gennaio 2026 Cursor ha descritto il caricamento su richiesta delle descrizioni degli strumenti MCP.

Perché la mia configurazione MCP non funziona in un’altra app?

La chiave e i campi dei server remoti sono diversi. La maggior parte delle app usa mcpServers; VS Code usa servers, Zed context_servers e Codex una tabella TOML. Un server remoto è url in Cursor, serverUrl o url in Windsurf, httpUrl o url in Gemini CLI, e type più url in Claude Code e VS Code.

Claude Desktop può usare server MCP remoti dal suo file di configurazione?

No. I server remoti si aggiungono come connettori personalizzati nelle impostazioni dell’app. I server in claude_desktop_config.json sono un meccanismo separato, e non sono disponibili in Cowork né su claude.ai.

Dove salva Claude Code i server MCP?

I tuoi server, e quelli di ogni progetto, sono in ~/.claude.json. Il .mcp.json di un progetto, nella sua radice, è pensato per essere condiviso con il tuo team. Aggiungi un server con claude mcp add, oppure con /mcp in una sessione. Entrambi i file usano la chiave mcpServers.

Dove si trova il mcp_config.json di Windsurf?

La documentazione di Windsurf ora si trova su Devin Desktop e indica ~/.config/devin/mcp_config.json su macOS e Linux, e %APPDATA%\devin\mcp_config.json su Windows. Le versioni precedenti di Windsurf usano ~/.codeium/windsurf/mcp_config.json. I server vanno sotto mcpServers, e Windsurf consente 100 strumenti alla volta.

Fonti

  1. Claude Code, Connect Claude Code to tools via MCP (documentation) I file ~/.claude.json e .mcp.json, la chiave mcpServers, il tipo http, Tool Search attivo di default.
  2. Model Context Protocol, Connect to local MCP servers I percorsi dei file di Claude Desktop, Edit Config, il riavvio, i passi di risoluzione dei problemi e le cartelle dei log.
  3. Claude Help Center, Get started with custom connectors using remote MCP I server remoti sono connettori personalizzati, separati da claude_desktop_config.json.
  4. Cursor, Model Context Protocol (documentation) I file mcp.json globale e di progetto, mcpServers, url e headers; nessun limite di strumenti dichiarato.
  5. Cursor, Dynamic context discovery (6 gen 2026) Descrizioni degli strumenti MCP caricate su richiesta.
  6. Cursor forum, About limitation of the number of MCP tools La segnalazione di un utente su un limite di 40 strumenti.
  7. VS Code, Add and manage MCP servers in VS Code (documentation) I file mcp.json di workspace e utente, la chiave servers, il .mcp.json portabile, il tipo http.
  8. VS Code, Use tools with agents (documentation) Il limite di 128 strumenti e il suo errore, il selettore degli strumenti, gli strumenti virtuali.
  9. Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) Il percorso di configurazione, mcpServers, serverUrl o url, il limite di 100 strumenti, disabledTools.
  10. Gemini CLI, MCP servers with Gemini CLI (documentation) I file settings.json, mcpServers, httpUrl e url.
  11. OpenAI Codex, Model Context Protocol (documentation) config.toml, la tabella mcp_servers, url, enabled_tools e disabled_tools, codex mcp add.
  12. LM Studio, Use MCP Servers (documentation) Edit mcp.json, mcpServers, url e headers.
  13. Cline, MCP (documentation) cline_mcp_settings.json e la sua cartella, la scheda Configure, streamableHttp.
  14. Roo Code, Using MCP in Roo Code (documentation) Il mcp_settings.json globale e il .roo/mcp.json di progetto, streamable-http.
  15. AWS, MCP configuration for Q Developer in the IDE default.json e il vecchio mcp.json, il trasporto http, i permessi degli strumenti.
  16. Zed, Model Context Protocol (documentation) I percorsi di settings.json, context_servers, url e headers.
  17. Delta MCP, Supported AI apps (documentation) Le dodici app che Delta MCP riconosce, i file che legge e come passa ciascuna a Delta MCP.

Continua a leggere

Prova Delta MCP sui tuoi task

Gratis, due minuti per configurarlo e con un clic rimetti tutto com’era.

Scarica per Mac Disponibile anche perWindowsLinux
Scarica per Windows Disponibile anche perMacLinux
Scarica per Linux Disponibile anche perMacWindows

Gratis · Nessun account · Chip Apple o Intel

Gratis · Nessun account

Gratis · Nessun account

Segui il lancio

Per Mac, Windows e Linux. Nessun account necessario.

In arrivo

Delta MCP sta per arrivare

L’app gratuita per Mac, Windows e Linux arriva a breve. Lascia la tua email e saprai subito quando esce. Non serve nessun account.

Usiamo la tua email solo per avvisarti una volta, quando esce Delta MCP. Niente newsletter. Privacy