---
title: Claude Code (MCP)
description: 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](https://claude.com/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.

<Callout type="info">
  **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.
</Callout>

## 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.

```text
┌──────────────────────────────┐        ┌──────────────────────────┐
│  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

<Steps>
<Step>
### 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.
</Step>
<Step>
### Registra il server in Claude Code

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

```bash
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.
</Step>
<Step>
### 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?»*.
</Step>
</Steps>

## 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](/docs/claude-code-mcp/cosa-puoi-fare); per il dettaglio dei
singoli strumenti, [Strumenti](/docs/claude-code-mcp/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). |