Collegare Claude a Nordlet

Questa guida è rivolta agli utenti che desiderano che Claude interagisca con la propria contabilità su Nordlet. Claude si collega al server MCP di Nordlet all'indirizzo https://api.nordlet.com/mcp. L'autorizzazione alla connessione viene concessa una sola volta tramite un'apposita pagina di Nordlet e non richiede la copia di alcuna chiave.

1. Creare un account Nordlet

1. Apri app.nordlet.com e inserisci il tuo indirizzo email.
2. Accetta i Termini di servizio, l'Informativa sulla privacy e l'Accordo sul trattamento dei dati (Data Processing Agreement). Nordlet invierà un link di accesso valido per 15 minutes e utilizzabile una sola volta. Non è prevista alcuna password.
3. Apri il link ricevuto e seleziona un piano: la tariffa forfettaria, che prevede un periodo di prova gratuito, oppure la formula a consumo (pay per request) con una prima ricarica.
4. Crea la tua azienda inserendo: nome, paese, codice di registrazione e partita IVA. Per effettuare delle prove preliminari, seleziona Sandbox company. L'ambiente di prova (sandbox) contiene dati di test e può essere eliminato in qualsiasi momento.

È possibile appartenere a più aziende, sia quelle di proprietà sia quelle a cui si è stati invitati da altri utenti. Il ruolo assegnato in ciascuna azienda (proprietario, amministratore, contabile, manager, sviluppatore o visualizzatore) determina le azioni consentite. Claude erediterà i medesimi diritti di accesso.

2. Collegare Claude

1. In Claude, aggiungi un connettore personalizzato inserendo l'indirizzo https://api.nordlet.com/mcp. Lascia vuoti i campi relativi all'autenticazione.
2. Claude aprirà una pagina di Nordlet. Se non hai già effettuato l'accesso, Nordlet ti chiederà l'indirizzo email e ti invierà un link di login. Aprilo utilizzando lo stesso browser per tornare alla pagina di autorizzazione.
3. La pagina mostrerà il nome dell'applicazione che richiede l'accesso e l'indirizzo di ritorno. Verifica entrambi i dati e seleziona Allow (Consenti). Cliccando su Deny (Nega) verrai reindirizzato senza concedere l'accesso.
4. Una volta tornato in Claude, il connettore risulterà attivo.

Il rinnovo dell'accesso da parte di Claude avviene in autonomia. Ciascun token di accesso ha una validità di un'ora e viene rinnovato automaticamente da Claude senza richiedere alcun intervento.

3. Collegare Claude Code

Esegui il comando:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

Successivamente, digita /mcp in Claude Code e seleziona l'autenticazione per il server nordlet. Il browser aprirà la stessa pagina Nordlet descritta nel passaggio 2. Dopo aver fatto clic su Allow, il browser ti riporterà su Claude Code direttamente sul tuo computer.

4. Operare nelle aziende

Un'unica connessione è attiva per tutte le aziende di cui fai parte. Claude elencherà inizialmente le tue aziende e indicherà la società di riferimento in ogni chiamata. È sufficiente specificare il nome dell'azienda nella richiesta, ad esempio "emetti questa fattura per UAB Pavyzdys". Quando vieni aggiunto a una nuova azienda, Claude può operarvi immediatamente; allo stesso modo, se vieni rimosso da un'azienda, Claude perderà l'accesso alla stessa.

Ogni chiamata effettuata da Claude costituisce una normale richiesta API e viene conteggiata al pari di qualsiasi altra richiesta. Le modifiche apportate vengono registrate nel registro di controllo (audit log).

5. Disconnessione

1. In Nordlet, apri Account → Developers. La connessione sarà elencata tra le tue chiavi API sotto il nome dell'applicazione, ad esempio "Claude".
2. Seleziona Revoke (Revoca). Claude perderà immediatamente l'accesso in tutte le aziende.

Per stabilire nuovamente il collegamento, ripeti il passaggio 2.

Utilizzo alternativo di una chiave API

I proprietari, gli amministratori e gli sviluppatori possono creare una chiave API nella sezione Account → Developers e inviarla tramite intestazione HTTP (header). Consulta la sezione sul server MCP.