# Collegare Cursor a Nodary

L’agente di Cursor può leggere le specifiche, le decisioni e i piani che il tuo team tiene in Nodary mentre scrive codice, e annotare ciò che impara, con i tuoi permessi.

Verificato sulla documentazione di ogni fornitore il 22 ottobre 2026.

## Prima di iniziare

- L’app desktop di Cursor. Quando abbiamo controllato, la pagina dei prezzi di Cursor non diceva quali piani includono i server MCP; su Enterprise gli amministratori controllano l’accesso MCP, e un team può tenere un elenco di server consentiti.
- Un account Nodary. Il server MCP è incluso in tutti i piani; su Free, finché lo spazio di lavoro resta nei limiti del piano: 1 progetto, 10 documenti e cartelle, 2 membri. Cursor non consuma Comete: usa il proprio modello.

Non hai ancora uno spazio? Creane uno, poi torna qui per collegarti. [Crea uno spazio gratuito](https://nodary.ai/sign-up)

## Aggiungere Nodary a mcp.json

1. Apri ~/.cursor/mcp.json nella tua cartella personale (Nodary in tutti i progetti) o .cursor/mcp.json in un progetto (solo quel progetto) e aggiungi il server:

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Apri Customize nella barra laterale di Cursor, trova nodary tra i server MCP, attivalo e accedi quando Cursor lo chiede: la pagina di consenso di Nodary si apre nel browser.
3. Approva l’accesso. Cursor mostra allora gli strumenti di Nodary come disponibili.

**Condividere il file:** un .cursor/mcp.json versionato nel repository dà lo stesso server a tutto il team; ognuno accede comunque con il proprio account. Non versionare mai una chiave API.

## Accedere e scegliere gli spazi

La pagina di consenso di Nodary indica l’app che chiede l’accesso e l’indirizzo a cui verrà rimandata. Accedi se serve, poi scegli gli spazi di lavoro che Cursor potrà raggiungere: con un solo spazio lo selezioni; con più spazi nessuno è spuntato in partenza, quindi spunta ciascuno di quelli che Cursor potrà usare. Se hai effettuato l’accesso più di 10 minuti fa, Nodary ti chiede di nuovo la password. Approva, e il browser ti riporta a Cursor.

Cursor agisce allora come te: vede e modifica solo ciò che il tuo ruolo consente, negli spazi spuntati. Il suo accesso dura 60 minuti alla volta e Cursor lo rinnova da solo.

## Usare Nodary dall’agente

Chiedi all’agente con parole tue. Cursor usa gli strumenti di Nodary quando la richiesta ne ha bisogno e, per impostazione predefinita, chiede la tua approvazione prima di eseguirne uno. Qualche richiesta per iniziare:

- Leggi il documento di design delle API in Nodary e verifica questo endpoint rispetto a esso.
- Scrivi un record di decisione per il passaggio a Postgres, archivialo in Architettura e collegalo alla specifica.
- Quali documenti del progetto Backend sono ancora bozze, e chi ne è responsabile?

## Con una chiave API invece

Metti la chiave nella variabile d’ambiente NODARY_API_KEY e inviala in un’intestazione; Cursor legge ${env:NODARY_API_KEY} dal tuo ambiente:

```json
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}
```

Crea la chiave in Nodary, in Profilo, Chiavi API e MCP. Inizia con gdc_, viene mostrata una sola volta, agisce con i tuoi permessi, può essere limitata a un progetto e scade dopo 30, 90 o 365 giorni, oppure mai, come scegli tu.

![La sezione Chiavi API e MCP di un profilo Nodary: l’indirizzo del server MCP da incollare in un client IA e una chiave per agenti con il suo ambito.](https://nodary.ai/marketing/mcp-connect.webp)

## Se qualcosa non funziona

- Gli strumenti di Nodary non compaiono: apri Customize e verifica che nodary sia attivo, poi leggi gli errori nel pannello Output, alla voce MCP Logs.
- L’accesso non si conclude: collegati con una chiave API, come sopra.
- Una prima richiesta con risposta 401 è normale: dice al client dove accedere.
- quota_locked: lo spazio di lavoro supera il piano Free dopo la prova ed è bloccato finché il proprietario non si abbona. Dopo funziona di nuovo subito.
- billing_locked: un pagamento non è andato a buon fine, quindi lo spazio di lavoro è bloccato finché il proprietario non lo salda nella fatturazione dello spazio. Funziona di nuovo appena il pagamento passa.
- workspace_suspended: Nodary ha sospeso lo spazio di lavoro e nulla lo raggiunge, agenti compresi. Il proprietario può scrivere a support@nodary.ai.
- workspace_required: la connessione raggiunge più spazi di lavoro, quindi indica quello in cui lavorare, oppure ricollegati spuntandone uno solo.

## Domande

### Collegare Cursor costa qualcosa?

Non da parte di Nodary. Il server MCP è incluso in tutti i piani, Free compreso nei suoi limiti, e Cursor non consuma Comete: le Comete contano solo Studio AI. Il tuo piano di Cursor decide se puoi aggiungere il server.

### Tutto il team può usare la stessa configurazione?

Sì. Versiona .cursor/mcp.json con il solo indirizzo: ognuno accede con il proprio account Nodary, così Cursor agisce con i suoi permessi. Tieni le chiavi nell’ambiente di ciascuno, mai nel repository.

### Cursor invia il mio codice a Nodary?

Solo ciò che il suo agente mette in una richiesta a Nodary, come un documento che scrive o un passaggio che cerca. Nodary conserva ciò che viene scritto nello spazio, e nient’altro.

### Cursor può eliminare o sovrascrivere i miei documenti?

Solo dove il tuo ruolo lo consente, e una modifica si può annullare: ogni sessione di modifica di dieci minuti al massimo forma una versione, come ogni scrittura di un agente. Un documento conserva le sue 50 versioni più recenti fatte da persone e le 50 più recenti fatte da agenti (quelle degli agenti non scalzano mai quelle delle persone), che confronti e ripristini, e un documento eliminato torna per 30 giorni. Link di condivisione, accessi, membri, ruoli, chiavi, fatturazione ed eliminazione di un progetto restano decisioni umane: nessun agente può prenderle.

### Come lo scollego?

In Nodary, apri Profilo, Sicurezza, App collegate e scollegalo: si ferma subito. In Cursor, disattiva il server in Customize o toglilo da mcp.json. Una chiave si revoca in Profilo, Chiavi API e MCP, e proprietari e amministratori possono revocare qualsiasi chiave dello spazio nelle sue impostazioni, alla voce MCP.

### Nodary usa i miei documenti per addestrare l’IA?

No. Nodary non usa il contenuto degli spazi di lavoro per addestrare modelli di IA. Ciò che Cursor fa con quello che legge dipende dalle condizioni del suo produttore.

## Da leggere dopo

- [Collegare Claude Code a Nodary](https://nodary.ai/it/docs/mcp/claude-code): Un comando aggiunge Nodary a Claude Code, poi /mcp ti fa accedere.
- [Collegare VS Code a Nodary](https://nodary.ai/it/docs/mcp/vs-code): MCP: Add Server in VS Code, poi l’accesso per GitHub Copilot.
- [Il server MCP di Nodary](https://nodary.ai/it/docs/mcp): Il server, l’accesso, i 98 strumenti, la sicurezza e tutti i client in un colpo d’occhio.
- [MCP server](https://nodary.ai/glossary/mcp-server) (in inglese): An MCP server is a program that offers tools, resources and prompts to AI applications over the Model Context Protocol.
- [AI agent](https://nodary.ai/glossary/ai-agent) (in inglese): An AI agent is a language model that pursues a goal in steps, calling tools, reading their results and deciding what to do next.

https://nodary.ai/it/docs/mcp/cursor