Claude Code (MCP)

Lavora su Audin direttamente da Claude Code con la tua utenza — deal, preventivi e contratti senza uscire dal terminale. Come si collega, come si usa, cosa può fare.

Il server MCP di Audin (@audin.ai/mcp) collega Claude Code al tuo account Audin. Da quel momento chiedi a Claude, in italiano, quello che faresti dalla dashboard: cercare o creare un deal, aggiungere prodotti, caricare il preventivo o il contratto che avete scritto insieme, attivare il link per il cliente, scaricare il PDF. Claude sceglie da solo gli strumenti giusti e li esegue nell'ordine giusto.

Lavori con la tua utenza, non con una chiave dell'account. Tutto quello che fai da Claude Code porta il tuo nome (chi ha creato il preventivo, chi ha mosso il deal) e rispetta i permessi del tuo ruolo su ciascun account. Se hai accesso a più account, scegli su quale lavorare all'inizio.

Come funziona

Il server gira sul tuo computer, avviato da Claude Code, e parla con Audin con un token personale che crei dalla dashboard. Non c'è nulla da installare a mano e nulla che resta acceso quando Claude Code è chiuso.

┌──────────────────────────────┐        ┌──────────────────────────┐
│  Il tuo computer             │ HTTPS  │  Audin                   │
│  Claude Code ──▶ @audin.ai/mcp ───────▶│  api.audin.ai            │
│  legge i file .html dal disco│        │  con la TUA utenza       │
└──────────────────────────────┘        └──────────────────────────┘

Il punto di forza è il file: il preventivo o il contratto che scrivi con Claude Code sta in un .html sul tuo disco, e il server lo carica su Audin così com'è, byte per byte, esattamente come l'import dalla dashboard. Nessuna modifica al contenuto, nessuna clausola o stile aggiunti.

Installazione

Crea il token personale

In Audin vai su Impostazioni → Claude Code (MCP) e premi Crea token. Dagli un nome che ti ricordi il computer (es. «MacBook di Anna»). Il token (aud_pat_…) si vede una volta sola: copialo. Se lo perdi, revocalo e creane un altro.

Registra il server in Claude Code

La pagina ti mostra il comando già compilato con il tuo token. Eseguilo nel terminale, una volta sola:

claude mcp add --scope user audin --env AUDIN_PAT=aud_pat_… -- npx -y @audin.ai/mcp

Serve Node.js 20 o superiore, che hai già se usi Claude Code.

Riavvia Claude Code

Al riavvio il server audin compare fra i server MCP (puoi verificarlo con /mcp). Prova subito con: «Su quali account Audin posso lavorare?».

Il primo preventivo

Un esempio di conversazione completa. Supponiamo che abbiate già scritto il preventivo in preventivo-rossi.html:

Crea su Audin il preventivo ./preventivo-rossi.html per la trattativa «Sito web Rossi Srl», con due offerte: Base (realizzazione sito 3.000 €) e Pro (sito 3.000 € più hosting 30 €/mese per 12 mesi, consigliata). Poi attiva il link e dammelo.

Claude, da solo: individua l'account, cerca il deal, carica l'HTML, crea le due offerte con le righe, le conferma, attiva il link pubblico e ti risponde con https://app.audin.ai/p/…. Su Audin trovi il preventivo esattamente come se l'avessi creato dalla dashboard: revisione, offerte, PDF, storico del deal a tuo nome.

Per la lista completa di ciò che puoi chiedere, vedi Cosa puoi fare; per il dettaglio dei singoli strumenti, Strumenti.

Cosa NON fa

Non manda email al cliente. Ti restituisce il link pubblico del preventivo (/p/…) o di firma del contratto (/c/…): lo mandi tu, dal composer di Audin o da dove preferisci.
Non supera i tuoi permessi. Quello che il tuo ruolo non consente su un account, non lo consente nemmeno da qui.
Non tocca lo stile dei documenti. L'HTML viene caricato fedelmente. Le clausole dell'account sono disponibili se le chiedi, ma non vengono inserite automaticamente.
Non crea altri token né modifica le impostazioni dell'account.

Sicurezza del token

Il token è tuo: vale su tutti gli account a cui hai accesso, con i tuoi permessi, e sparisce dalla vista dopo la creazione (Audin ne conserva solo un'impronta).
Puoi revocarlo in qualunque momento da Impostazioni → Claude Code (MCP): smette di funzionare subito. Puoi anche dargli una scadenza alla creazione.
La pagina mostra l'ultimo utilizzo di ogni token: se ne vedi uno che non riconosci, revocalo.
Ogni chiamata fatta da Claude Code è registrata nel log API dell'account, attribuita al tuo token.

Se qualcosa non va

Messaggio	Cosa fare
«Token personale non valido, revocato o scaduto»	Crea un token nuovo e registra di nuovo il server (`claude mcp remove audin`, poi il comando della pagina).
«Serve l'account su cui operare»	Chiedi «su quali account posso lavorare?» e indica quello giusto. Se ne usi sempre uno, puoi fissarlo con la variabile `AUDIN_DEFAULT_ACCOUNT_ID` nel comando di registrazione.
«Non hai il permesso …»	Il tuo ruolo su quell'account non lo consente: chiedi all'amministratore dell'account.
«Le offerte sono cambiate … DATA_DRIFT»	Qualcuno ha modificato le offerte dopo il caricamento del documento. Verifica che l'HTML sia aggiornato, poi chiedi di inviare «confermando il drift».
«Esiste già un contratto in lavorazione per questo deal»	Completa o annulla quello esistente dalla dashboard: Audin ammette un solo contratto in corso per deal.
«File non trovato» / «deve avere estensione .html»	Passa a Claude il percorso assoluto del file e assicurati che sia un `.html` o `.htm` (massimo 5 MB).

On this page