Collegare VS Code a Nodary

Prima di iniziare

• VS Code con GitHub Copilot. Su Copilot Free, Pro, Pro+ e Max, nessun criterio dell’organizzazione regola i server MCP.
• Su Copilot Business ed Enterprise, il criterio MCP servers in Copilot dell’organizzazione deve essere attivo; è disattivato per impostazione predefinita. Un elenco di server consentiti dell’azienda può anche limitare i server che aggiungi.
• 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. Copilot non consuma Comete: usa il proprio modello.

Aggiungere Nodary

1. Apri la palette dei comandi (Ctrl+Maiusc+P, o Cmd+Maiusc+P su Mac) ed esegui MCP: Add Server.
2. Scegli HTTP (HTTP or Server-Sent Events) e inserisci l’indirizzo del server:

   https://nodary.ai/api/mcp

   Copia
3. Inserisci nodary come ID del server.
4. Scegli Global, poi Copilot Global, per usare Nodary in tutti i tuoi spazi di lavoro. VS Code lo scrive in ~/.copilot/mcp-config.json:

   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }

   Copia
5. All’avvio del server, accetta le richieste di attendibilità e di accesso: la pagina di consenso di Nodary si apre nel browser.

Configurazioni precedenti: VS Code legge ancora .vscode/mcp.json e il mcp.json del tuo profilo utente, che usano servers invece di mcpServers, e li segna come deprecati.

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

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

Usare Nodary in Copilot Chat

In Copilot Chat, verifica che gli strumenti di Nodary siano attivi (Configure Tools, oppure Chat: Open Customizations, poi Tools), poi chiedi con parole tue. 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

Aggiungi l’intestazione a ~/.copilot/mcp-config.json, un file della tua cartella personale che non versioni mai:

{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}

In chiaro: VS Code non legge da questo file variabili richieste all’utente, quindi la chiave vi resta scritta così com’è. Dalle una scadenza di 30 o 90 giorni e revocala in Nodary se perdi il computer.

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

• VS Code dice che una restrizione aziendale blocca il server: chiedi al tuo amministratore del criterio MCP servers in Copilot e dell’elenco di server consentiti dell’azienda.
• Non compare nessun accesso: esegui MCP: List Servers, riavvia nodary e accetta le richieste. Se l’accesso continua a non concludersi, usa una chiave API.
• 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

Da leggere dopo