Strumenti
Riferimento dei 21 strumenti che il server MCP mette a disposizione di Claude Code, con i parametri principali. Utile per capire cosa succede dietro le quinte, non per usarli a mano.
Versione Markdown di questa pagina
Scarica o copia il contenuto di questa pagina in formato .md — utile per fornirlo a un agente AI che integra questa specifica feature.
Gli strumenti sono ciò che Claude usa per eseguire le tue richieste. In
Claude Code compaiono come mcp__audin__<nome> (li vedi con /mcp). Non
serve chiamarli direttamente: questa pagina è un riferimento per capire cosa
Claude può fare e con quali dati.
Tutti gli strumenti, tranne list_accounts, agiscono su un account: il
parametro accountId (dalla risposta di list_accounts) o, in alternativa,
l'account fissato con AUDIN_DEFAULT_ACCOUNT_ID.
Account e pipeline
| Strumento | Cosa fa |
|---|---|
list_accounts | Chi sei e su quali account puoi operare, con il ruolo. Sempre per primo. |
list_pipelines | Le pipeline dei deal con gli stage (id, nome, iniziale/terminale). |
Deal
| Strumento | Parametri principali | Cosa fa |
|---|---|---|
search_deals | query, status, pipelineId, stageId, ownerId, page | Ricerca per titolo con filtri. Ritorna id, titolo, stage, contatto, aziende, preventivi e contratti collegati. |
get_deal | dealId | Dettaglio completo: contatti, aziende, stage, prodotti con totali, preventivi e contratti con stato e link pubblico. |
create_deal | title, pipelineId, stageId?, amount?, primaryContactId?, contactIds?, companyIds?, expectedCloseDate?, description? | Crea il deal. Senza stage parte da quello iniziale. |
add_deal_products | dealId, products[] | Aggiunge righe dal listino (productId) o libere (name + prezzi). Le righe esistenti restano. |
remove_deal_product | dealId, lineId | Rimuove una riga. |
Una riga (usata anche nelle offerte dei preventivi) ha: productId o
name, description, quantity, unitLabel, oneTimePrice,
recurringPrice con billingPeriod (DAY, WEEK, MONTH, QUARTER,
YEAR) e billingPeriods, discountType (PERCENTAGE, FIXED_AMOUNT) con
discountValue, currency.
Contatti e aziende
| Strumento | Parametri principali | Cosa fa |
|---|---|---|
search_leads | query | Cerca per nome, email o telefono. |
create_lead | fullName, email?, phoneNumber?, companyId?, role? | Crea un contatto. |
search_companies | query | Cerca per nome. |
create_company | name, domain, sector?, website?, city?, … | Crea un'azienda. Il dominio è obbligatorio e unico per account. |
Listino e clausole
| Strumento | Parametri principali | Cosa fa |
|---|---|---|
search_products | query?, categoryId?, includeInactive? | Prodotti e servizi del listino con prezzi, periodo, unità. |
list_clauses | query?, category? | Le clausole dell'account con il testo. Non vengono inserite automaticamente nei documenti. |
Preventivi
| Strumento | Parametri principali | Cosa fa |
|---|---|---|
create_quote | dealId, title, htmlPath, offers[]? | Carica l'HTML dal file (percorso assoluto) e crea le offerte con le righe, confermandole. Senza offers usa i prodotti del deal. |
update_quote_html | quoteId, htmlPath, documentReflectsOffers? | Sostituisce l'HTML di una bozza. |
create_quote_revision | quoteId, htmlPath?, offers[]? | Nuova revisione di un preventivo inviato: clona le offerte; con offers le rimpiazza, con htmlPath sostituisce il documento. |
send_quote | quoteId, expiresAt?, acknowledgeDrift? | Attiva il link pubblico e lo restituisce. Non invia email. |
get_quote_pdf | quoteId, outputPath? | Genera il PDF; con outputPath lo salva sul disco. |
Un'offerta ha label, description?, isRecommended?, currency? e
lines[] (le righe descritte sopra).
Contratti
| Strumento | Parametri principali | Cosa fa |
|---|---|---|
create_contract | dealId, htmlPath, title? | Crea il contratto dall'HTML. Un solo contratto in lavorazione per deal. |
send_contract | contractId, expiresAt? | Genera il PDF se manca, attiva il link di firma e lo restituisce. |
get_contract_pdf | contractId, outputPath? | PDF del contratto; se firmato, la versione firmata. |
Cosa ricevono i risultati
Le risposte sono compatte: id, titoli, stati spiegati in italiano, totali e link pubblici. Mai l'HTML dei documenti né il costo d'acquisto delle righe. Gli errori dicono cosa fare: token da rifare, account da scegliere, permesso mancante, conflitto da risolvere dalla dashboard.
Variabili di configurazione
| Variabile | Obbligatoria | Default | Note |
|---|---|---|---|
AUDIN_PAT | sì | — | Il token personale (aud_pat_…). |
AUDIN_DEFAULT_ACCOUNT_ID | no | — | Account usato quando non lo indichi: comodo se ne hai uno solo. |
AUDIN_API_URL | no | https://api.audin.ai | Solo per ambienti diversi da produzione. |
AUDIN_APP_URL | no | https://app.audin.ai | Base dei link pubblici restituiti. |
Si passano al comando di registrazione con --env NOME=valore.
Cosa puoi fare
Le richieste che puoi fare a Claude Code una volta collegato ad Audin — account, deal, contatti, prodotti, preventivi, contratti — con esempi pronti da copiare.
Widget
Il widget chat embeddable di Audin — aggiungi un assistente AI conversazionale al tuo sito incollando un solo snippet, in modalità popup o embedded.