dotsagent.io
Lingua:Italiano
Connetti · strumento

Generatore di configurazioni MCP

Scegli un client e i server che vuoi usare. Otterrai la configurazione nel formato esatto richiesto dal client, i comandi CLI corrispondenti, se disponibili, e un avviso per tutto ciò che non può eseguire.

Client
Sistema operativo
Ambito
Server (3)
  • GitHub
  • Context7
  • PlaywrightLocale

Claude Code acquisisce i server dal comando claude mcp add o da un file .mcp.json nella root del repository.

.mcp.json
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Oppure aggiungile dalla riga di comando

shell
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Note complete sulla configurazione di Claude Code →

Come funziona l'output

Ospitato o locale

Un server ospitato è un URL a cui il client si connette tramite Streamable HTTP; lo gestisce il fornitore e non serve installare nulla. Un server locale viene avviato come processo figlio tramite npx, uvx o docker e usa i permessi della tua macchina. Se un server offre entrambe le opzioni, il generatore sceglie prima quella ospitata e ti permette di passare all'altra.

Le chiavi segrete non vengono salvate nel file

Il generatore non inserisce mai una chiave reale. Usa la sintassi di riferimento specifica di ogni client: ${VAR} in Claude Code, ${env:VAR} in Cursor e Windsurf, una richiesta di input in VS Code, $VAR in Gemini CLI, env_vars in Codex e ${{ secrets.VAR }} in Continue. Per gli altri client usa il segnaposto <VAR>, che dovrai compilare.

OAuth al primo utilizzo

La maggior parte dei server ospitati qui ti fa accedere tramite OAuth. Il client apre un browser alla prima connessione oppure quando esegui la procedura di accesso: /mcp in Claude Code, codex mcp login, devin mcp login oppure openclaw mcp login. Slack, Asana e HubSpot accettano solo client preregistrati: verifica che il tuo sia supportato.

Ricarica dopo le modifiche

Claude Desktop legge il file all'avvio: chiudilo e riaprilo dopo ogni modifica. Su macOS, i log si trovano in ~/Library/Logs/Claude. Se un nuovo server non compare in un altro client, riavvialo o ricarica la finestra. In OpenClaw, openclaw mcp doctor <name> --probe verifica un singolo server.

Domande sulla configurazione

Dove va messo mcp.json per Cursor e Claude Code?

Cursor legge .cursor/mcp.json nel progetto oppure ~/.cursor/mcp.json per tutti i progetti. Claude Code legge .mcp.json nella root del repository per l'ambito del progetto e gestisce gli ambiti locale e utente in ~/.claude.json. VS Code usa .vscode/mcp.json, mentre Codex usa ~/.codex/config.toml invece di JSON.

Perché un server remoto non viene caricato da claude_desktop_config.json?

Claude Desktop accetta da quel file solo server locali. I server remoti vanno aggiunti come connettori personalizzati in Settings > Connectors, dove puoi incollare l'URL e accedere. Per questo il generatore mostra separatamente questi URL.

Come posso evitare di includere le API key in un .mcp.json sottoposto a commit?

Fai riferimento a una variabile d'ambiente invece di incollare la chiave. Claude Code espande ${VAR} e ${VAR:-default}, Cursor espande ${env:NAME} e VS Code può chiederti un segreto tramite una voce inputs. Imposta la variabile nella shell o nel gestore di segreti prima di avviare il client.

Posso riutilizzare la stessa configurazione MCP con client diversi?

Non senza modifiche: nella maggior parte dei client la chiave di primo livello è mcpServers, mentre in .vscode/mcp.json è servers, in Zed è context_servers e in Codex sono tabelle mcp_servers. Alcuni client importano i file di altri: VS Code rileva le configurazioni di Claude Desktop, Cursor e Windsurf, Continue accetta un mcp.json trascinato nell'interfaccia e JetBrains AI Assistant offre l'opzione Import from Claude.

Perché npx non funziona in Claude Desktop su Windows?

Il README dei server MCP esegue npx tramite cmd su Windows: command cmd, con /c, npx e il pacchetto come argomenti. Selezionando Claude Desktop e Windows, il generatore applica automaticamente questo wrapper.

È meglio usare la versione ospitata o quella locale di un server?

La versione ospitata è più semplice: non serve installare un runtime e OAuth sostituisce i token di lunga durata salvati su disco. La versione locale è utile quando il server deve accedere a file o credenziali presenti sul tuo computer, oppure quando non esiste un endpoint ospitato, come nel caso di Filesystem, Playwright o del server API AWS.