Globale o di progetto: quale scegliere

Cursor ti dà due posti dove mettere un server, ed è la scelta che conta di più.

  • Globale (~/.cursor/mcp.json, nella cartella utente): il server è disponibile in tutti i tuoi progetti. Adatto a strumenti che usi sempre, come la ricerca web.
  • Di progetto (.cursor/mcp.json dentro la cartella del progetto): il server vale solo lì. Adatto a un server filesystem puntato sui file di quel progetto, o quando lavori in team e vuoi condividere la stessa configurazione. Se lo stesso server è in entrambi, vince quello di progetto.

Come si fa

Da qui in poi il file ha la stessa forma nei due casi; cambia solo dove lo metti.

  1. Attiva MCP nelle impostazioni. Apri le impostazioni di Cursor e cerca "MCP": verifica che l'opzione per abilitare i server sia accesa. In alcune installazioni è spenta di default, ed è il motivo numero uno per cui "non funziona niente".
  2. Aggiungi il server nel file. La sintassi operativa:
{
  "mcpServers": {
    "documenti": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/tuonome/progetti/sito"]
    }
  }
}

documenti è il nome che scegli tu; l'ultimo valore è la cartella che il server potrà vedere. Per un server di progetto, punta alla cartella di quel progetto.

  1. Salva e controlla l'indicatore. Cursor rilegge il file e mostra lo stato del server: un pallino verde (o simile) segnala che è connesso. Se resta rosso o grigio, qualcosa nella configurazione non va.
  2. Usalo in chat. Apri l'assistente di Cursor e chiedigli di usare lo strumento ("leggi i file del progetto e..."). Se è connesso, lo userà.

Esempio concreto

Davide usa Cursor per un sito che sta costruendo e vuole che l'assistente legga i file del progetto senza che lui li apra a uno a uno. Crea un file .cursor/mcp.json dentro la cartella del sito, incolla il blocco del server filesystem puntato su quella cartella, e in impostazioni controlla che MCP sia attivo.

Salva e vede il pallino verde accanto al server. Da quel momento, quando chiede all'assistente "controlla se la pagina dei contatti ha il modulo giusto", Cursor legge i file reali del progetto e risponde sul contenuto vero, non a indovinare. Avendolo messo come server di progetto, quel collegamento vale solo per questo sito e non si porta dietro negli altri.

Quando NON funziona (e come rimediare)

Se i server non partono affatto

Controlla per prima cosa l'interruttore: se l'opzione per abilitare i server MCP è spenta nelle impostazioni, nessun server si carica, per quanto sia scritto bene il file. Accendila e ricontrolla.

Se l'indicatore resta rosso

Il file ha un errore. Cursor non connette un server se il JSON (il formato a parentesi e virgole) non è valido. Fatti validare il contenuto dall'assistente di Cursor stesso ("questo JSON è corretto?") e correggi la riga segnalata.

Se alcuni strumenti spariscono

Cursor ha un tetto al numero di strumenti attivi insieme (intorno alla quarantina): oltre quella soglia, l'assistente smette silenziosamente di vedere alcuni strumenti. Se hai collegato molti server, disattiva quelli che non ti servono per quel lavoro, così resti sotto il limite.

Un consiglio da chi lo usa davvero

Usa i server di progetto per i file e tieni globali solo gli strumenti generici. Così, aprendo un progetto, l'assistente vede esattamente i file di quel lavoro e niente di estraneo. È anche più sicuro: ogni progetto resta una scatola separata, e non rischi che l'AI peschi in cartelle di un cliente diverso.

Domande frequenti

Devo riavviare Cursor dopo aver aggiunto un server?

Di solito Cursor rilegge il file al salvataggio e aggiorna l'indicatore senza riavvio. Se però non vedi cambiamenti, chiudere e riaprire l'app risolve quasi sempre: è il primo tentativo da fare quando qualcosa resta bloccato.

Posso condividere la configurazione MCP con il mio team?

Sì, ed è uno dei vantaggi del file di progetto: mettendo .cursor/mcp.json nella cartella del progetto condivisa, chi lavora con te ha gli stessi server. Attenzione a non metterci dentro chiavi o password: quelle vanno gestite a parte.

La configurazione di Cursor è uguale a quella di altri editor?

La forma del file è simile ma non identica tra strumenti diversi: cambiano la posizione e a volte il nome della voce principale. Una configurazione che funziona in Cursor non si incolla tale e quale altrove: verifica sempre il formato richiesto dallo strumento che stai usando.