~/tools / MCP Config Checker
MCP Config Checker — Controlla errori in un file di configurazione MCP
Controlla un file di configurazione di un server MCP (.mcp.json o claude_desktop_config.json) alla ricerca di errori: type mancante, chiave di primo livello sbagliata, nomi riservati o non validi, percorsi relativi, variabili non impostate e segreti scritti nel file. Nulla lascia il tuo browser.
Regole verificate rispetto alla documentazione il 2026-10-23.
Documentazione: Claude Code / Model Context Protocol / VS Code
Non verificato: se un comando esiste, se un pacchetto si installa, se un server remoto risponde e le impostazioni che altre applicazioni interpretano in modo diverso.
Tutto viene eseguito nel tuo browser. La configurazione non viene caricata.
I server MCP si configurano in un file JSON e un piccolo errore può far sì che un server non compaia, senza alcun messaggio. Una voce con url ma senza type viene ignorata, un file che usa la chiave servers di VS Code non viene letto da Claude Code né da Claude Desktop, e una variabile d'ambiente non impostata viene passata come semplice testo. Questo strumento legge la configurazione che incolli ed elenca ciò che secondo la documentazione non funzionerà, ciò che vale la pena verificare e ciò che è solo una nota. Segnala inoltre quando un token sembra scritto direttamente nel file, dove può finire nel controllo di versione. Le regole derivano dalla documentazione di Claude Code, del Model Context Protocol e di VS Code, verificata alla data indicata sotto lo strumento.
Casi d'uso
- Capire perché un server MCP non compare dopo aver modificato .mcp.json o claude_desktop_config.json
- Controllare una configurazione copiata da un README prima di aggiungerla a un progetto condiviso
- Individuare token e password scritti in un file di configurazione prima del commit
Utilizzo
- Incolla il contenuto del tuo file di configurazione MCP, oppure carica l'esempio.
- Leggi i server trovati e il tipo di ciascuno, poi l'elenco delle segnalazioni. Correggi significa che secondo la documentazione la voce non funzionerà, Verifica che vale la pena dare un'occhiata, e Nota che è solo un'informazione.
- Modifica il file, incollalo di nuovo e riavvia l'applicazione che lo legge.
FAQ
Quali file e applicazioni copre?
Il formato mcpServers usato dal file di progetto .mcp.json in Claude Code e da claude_desktop_config.json in Claude Desktop. Altre applicazioni possono leggere campi diversi o una chiave di primo livello diversa, quindi consulta la loro documentazione. VS Code, per esempio, usa una chiave di primo livello chiamata servers.
La mia voce ha un url ma nessun type. Perché è un problema?
Claude Code legge una voce senza type come server stdio, quindi una voce con url ma senza type è un errore di configurazione e il server viene ignorato. Aggiungi un type pari a http, sse o ws.
Che cosa succede a una variabile come ${API_KEY} che non è impostata?
Claude Code espande ${VAR} e ${VAR:-default} in command, args, env, url e headers. Se una variabile non è impostata e non ha un valore predefinito, la configurazione viene comunque caricata, Claude Code mostra un avviso e usa il testo ${VAR} così com'è. Aggiungi un valore predefinito con ${VAR:-default} dove è sicuro farlo.
Perché segnala un token nel file?
Un token scritto direttamente in un file di configurazione può essere condiviso quando il file viene sottoposto a commit o inviato a qualcuno. Il controllo è euristico, basato sui formati noti dei token e su nomi come api-key, token e password, quindi può non rilevare un segreto o segnalare un valore innocuo. Usando ${VAR} il valore resta fuori dal file.
Avvia il server o prova la connessione?
No. Legge solo il testo. Non può sapere se un comando esiste, se un pacchetto si può installare o se un server remoto è raggiungibile, quindi prova il server nell'applicazione dopo che il file ha superato il controllo.
La mia configurazione viene inviata a un server?
No. Il controllo viene eseguito nel tuo browser.