Le due cose da sapere prima

Sono i due dettagli che distinguono VS Code dagli altri strumenti.

  • Solo in modalità Agent. Copilot ha più modalità; gli strumenti MCP rispondono unicamente quando la chat è in modalità Agent. In chiacchierata normale non li vedrai, anche se li hai configurati bene.
  • La voce si chiama servers. Mentre in Claude Desktop e in Cursor il contenitore è mcpServers, in VS Code è servers. Copiare una configurazione da un'altra guida senza cambiare questo nome è l'errore più comune.

Come si fa

  1. Apri la configurazione MCP. Nelle impostazioni di VS Code cerca "copilot mcp", oppure apri la chat di Copilot e usa l'icona degli strumenti ("Configure your MCP server"): porta al file mcp.json giusto.
  2. Aggiungi il server con la voce corretta. La sintassi operativa:
{
  "servers": {
    "documenti": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/tuonome/progetti"]
    }
  }
}

Nota servers come prima parola: è la chiave giusta per VS Code. documenti è il nome che scegli tu, l'ultimo valore è la cartella accessibile.

  1. Passa alla modalità Agent. Apri la chat di Copilot e seleziona Agent tra le modalità. Senza questo passaggio gli strumenti restano invisibili.
  2. Attiva e verifica. Dall'icona degli strumenti nella chat controlla che il tuo server sia elencato e attivo. Poi chiedi a Copilot di usarlo ("leggi i file nella cartella e...").

Esempio concreto

Sofia programma in VS Code e vuole che Copilot legga i file di documentazione del suo progetto. Cerca "copilot mcp" nelle impostazioni, apre il file e incolla il blocco del server filesystem. La prima volta usa per abitudine mcpServers e non funziona nulla: ricontrolla la guida, cambia la voce in servers, e al salvataggio il server compare.

Poi si accorge che in chat non vede gli strumenti: era in modalità normale. Passa ad Agent e l'icona degli strumenti mostra il filesystem. Chiede "riassumi il file README del progetto" e Copilot lo legge davvero. I due intoppi — la voce sbagliata e la modalità — sono esattamente quelli che la guida segnala, e una volta sistemati funziona.

Quando NON funziona (e come rimediare)

Se gli strumenti non compaiono in chat

Controlla la modalità: gli strumenti MCP esistono solo in modalità Agent. Se sei in chiacchierata normale o in un'altra modalità, non li vedrai. Passa ad Agent e ricontrolla l'icona degli strumenti.

Se il server non si carica

Verifica la voce principale: in VS Code deve essere servers, non mcpServers. È l'errore più frequente quando si copia una configurazione pensata per un altro strumento. Poi controlla che il JSON (il formato a parentesi e virgole) sia valido: fallo verificare a Copilot stesso.

Se Copilot legge i file ma non li modifica

Dipende dai permessi del server e dalle conferme che VS Code chiede prima di scrivere. Per le azioni che cambiano file, l'editor di solito chiede il tuo via libera: cerca la richiesta di conferma nella chat invece di pensare che sia bloccato.

Un consiglio da chi lo usa davvero

Tieni a portata un appunto con le tre differenze di VS Code rispetto agli altri strumenti: voce servers, solo modalità Agent, configurazione via "copilot mcp". Sono le tre cose che ti faranno perdere tempo ogni volta che configuri un server nuovo, e averle scritte ti evita di ricominciare da capo la caccia all'errore.

Domande frequenti

Perché la mia configurazione di Claude non funziona in VS Code?

Perché la voce principale è diversa: Claude usa mcpServers, VS Code usa servers. Il resto della struttura è simile, ma se non cambi quel nome il server non viene caricato. È la differenza da ricordare quando passi da uno strumento all'altro.

Serve l'abbonamento a Copilot per usare MCP?

Gli strumenti MCP in modalità Agent fanno parte delle funzionalità di Copilot in VS Code. La disponibilità dipende dal tuo piano Copilot; il protocollo MCP e i server in sé restano gratuiti.

Posso usare gli stessi server di Cursor anche qui?

Lo stesso server (per esempio il filesystem) funziona in entrambi, perché MCP è uno standard. Cambia solo come lo dichiari nel file: voce servers in VS Code, mcpServers in Cursor. Il server è lo stesso, l'involucro della configurazione no.