# Collegare Claude Code a Nodary

Claude Code legge dal terminale la documentazione che il tuo team tiene in Nodary, e vi scrive decisioni e note, con i tuoi permessi.

Verificato sulla documentazione di ogni fornitore il 22 ottobre 2026.

## Prima di iniziare

- Claude Code, con accesso tramite un account Pro, Max, Team, Enterprise o Console, oppure usato tramite un fornitore cloud come Amazon Bedrock. Il piano gratuito di claude.ai non include Claude Code.
- 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. Claude Code 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

1. Esegui questo comando in un terminale:

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. Per usare Nodary in tutti i progetti, aggiungilo invece al tuo ambito utente:

   ```
   claude mcp add --transport http --scope user nodary https://nodary.ai/api/mcp
   ```
3. In Claude Code, digita /mcp, scegli nodary e accedi: la pagina di consenso di Nodary si apre nel browser. Se non si apre, copia l’indirizzo mostrato da Claude Code, oppure esegui:

   ```
   claude mcp login nodary
   ```

**Ambiti:** local, il predefinito, riserva Nodary a te in questo progetto; user, a te in tutti i progetti; project scrive .mcp.json nella radice del progetto perché tutto il team lo condivida.

## 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 Claude Code potrà raggiungere: con un solo spazio lo selezioni; con più spazi nessuno è spuntato in partenza, quindi spunta ciascuno di quelli che Claude Code 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 Claude Code.

Claude Code 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 Claude Code lo rinnova da solo.

## Usare Nodary dal terminale

Chiedi con parole tue. Claude Code chiama gli strumenti di Nodary quando la richiesta ne ha bisogno, e chiede prima di usarli a meno che tu non li abbia consentiti. 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

Invia la chiave in un’intestazione:

```sh
claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."
```

Per condividere il server in .mcp.json senza condividere una chiave, leggila da una variabile d’ambiente: Claude Code sostituisce ${NODARY_API_KEY} nelle intestazioni di un server.

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${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.

## Se qualcosa non funziona

- claude mcp add non verifica una chiave: una chiave sbagliata compare come server non riuscito in /mcp.
- Per accedere di nuovo, scegli Clear authentication nel menu /mcp, oppure esegui claude mcp logout nodary, poi accedi.
- Un documento lungo arriva troncato: Claude Code avvisa oltre 10.000 token di output degli strumenti e si ferma a 25.000 per impostazione predefinita. Alza il limite con la variabile d’ambiente MAX_MCP_OUTPUT_TOKENS, oppure chiedi una sola sezione.
- 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 Claude Code costa qualcosa?

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

### È la stessa connessione di Claude sul web?

Può esserlo: quando accedi a Claude Code con il tuo account claude.ai, i connettori aggiunti su claude.ai, Nodary compreso, compaiono in Claude Code. Con una chiave Console o un fornitore cloud, aggiungi Nodary con il comando qui sopra.

### Il team può condividere la configurazione?

Sì: aggiungi Nodary con --scope project e versiona .mcp.json. Claude Code chiede a ciascuno prima di usare i server di un progetto, e ognuno accede con il proprio account Nodary.

### Claude Code 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 Claude Code, claude mcp remove nodary rimuove il server e l’accesso che aveva salvato. 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 Claude Code fa con quello che legge dipende dalle condizioni del suo produttore.

## Da leggere dopo

- [Collegare Claude a Nodary](https://nodary.ai/it/docs/mcp/claude): Aggiungi Nodary a claude.ai e a Claude Desktop come connettore personalizzato, con accesso OAuth.
- [Collegare Cursor a Nodary](https://nodary.ai/it/docs/mcp/cursor): Aggiungi Nodary al file mcp.json di Cursor, poi accedi da Cursor.
- [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.
- [Context window](https://nodary.ai/glossary/context-window) (in inglese): A context window is how much text, counted in tokens, a language model takes into account at once, instructions and documents included.

https://nodary.ai/it/docs/mcp/claude-code