Claude MCP

Il Model Context Protocol (MCP) è uno standard aperto che permette ad assistenti AI come Claude di richiamare strumenti esterni. Finn gestisce un server MCP: puoi quindi collegare Claude al tuo account Finn e creare agenti vocali descrivendoli in una conversazione, invece di compilare a mano il builder.

Cosa fa questo server. Legge i tuoi Finn e crea o modifica bozze. Non fa altro. Non può avviare un Finn, comporre un numero, usare il tuo credito, accedere ai contatti o leggere le trascrizioni: queste operazioni restano nella dashboard, di proposito. La sezione Ambito più avanti ne spiega il motivo.

A chi è rivolto. A chi usa già Claude e preferisce descrivere un agente anziché crearlo clic dopo clic. Non serve scrivere codice. Se non usi Claude, non ti perdi nulla: la dashboard fa tutto ciò che offre questo server, e anche di più.

Ci sono esattamente due modi per collegarsi, e te ne basta uno:

Ambito: cosa può e non può fare il server

È una scelta voluta, applicata in due punti: il server non espone questi strumenti e il backend rifiuta le relative richieste anche se qualcosa le invia. Il motivo è il link del connettore descritto più avanti: quel link è di per sé una credenziale, quindi il danno massimo che può fare un link trapelato è leggere i tuoi Finn e modificare le tue bozze. È un danno rimediabile. "Chiama i miei clienti e spendi il mio credito" non lo è.

In pratica: Claude lo crea, tu lo avvii. Ogni Finn arriva come bozza: lo controlli nella dashboard e premi tu il pulsante.

Passaggio 1: genera una chiave

Nella dashboard: Impostazioni → Integrazioni → Assistenti AI (MCP) → Genera chiave.

Il nome che dai alla chiave è quello con cui il connettore compare in Claude, quindi sceglilo in base a dove intendi usarla, ad esempio "portatile di lavoro" o "desktop di casa". Così due chiavi appaiono come due voci distinguibili e non come due righe identiche.

La tua chiave è composta da finn_mcp_ seguito da una lunga stringa. Viene mostrata una sola volta. Copia ciò che ti serve prima di chiudere la finestra di dialogo; se la perdi, revoca la chiave e generane un'altra.

Alcune cose utili da sapere sulle chiavi:

• Una chiave porta con sé la tua identità. Un Finn creato con la tua chiave finisce nella tua organizzazione, a tuo nome. Se usi la chiave di un collega, il Finn compare nel suo account e non riuscirai a trovarlo.
• Non esistono ambiti né livelli. Ogni chiave può fare tutto ciò che è nell'elenco "Può" qui sopra e niente di ciò che è nell'elenco "Non può".
• La revoca è immediata. Il server ricontrolla la chiave rispetto al tuo account a ogni singola chiamata, quindi una chiave revocata smette di funzionare alla richiesta successiva, non al termine di una sessione.

Passaggio 2 — Collega Claude

La finestra di dialogo che mostra la nuova chiave offre entrambe le opzioni, ciascuna con un pulsante di copia. Scegli quella adatta al modo in cui usi Claude.

Opzione 1 — App Claude (claude.ai o Claude Desktop)

È l'opzione che serve alla maggior parte degli utenti. Non c'è nulla da installare né da modificare.

Copia il tuo link del connettore dalla finestra di dialogo. Ha questo aspetto, con la tua chiave alla fine:

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

Poi, in Claude:

1. Apri Personalizza → Connettori, fai clic su + e scegli Aggiungi connettore personalizzato.
2. Incolla il link come URL del server MCP remoto, poi fai clic su Aggiungi. Il connettore compare con il nome della tua chiave.
3. In una nuova chat, apri + → Connettori e attiva Finn, poi chiedi a Claude di creare un Finn.

Due cose da sapere sui piani: il piano Free consente un solo connettore personalizzato e, nei piani Team ed Enterprise, solo un Owner può aggiungerlo, da Impostazioni organizzazione → Connettori; tutti gli altri devono poi fare clic su Connetti.

Il compromesso: un connettore personalizzato è un unico campo URL, senza spazio per una password, quindi il link è la credenziale. Tratta l'intero URL come la password della dashboard: non incollarlo in una chat, in un ticket, in uno screenshot o in un repository.

Opzione 2 — Claude Code (terminale)

Copia il comando dalla finestra di dialogo. È su una sola riga, quindi si incolla senza problemi in bash, zsh, PowerShell e cmd:

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

1. Incolla il comando in un terminale ed eseguilo.
2. Esegui claude.
3. Chiedigli di creare un Finn.

In questa forma la chiave resta in un header anziché nell'URL, ed è la più sicura delle due.

Altri client MCP

Il server usa HTTP in streaming, non stdio, ed è stateless: non ci sono sessioni da aprire o che scadono. Qualsiasi client che supporti un endpoint MCP HTTP funziona con uno dei due accessi descritti sopra: la chiave in un header Authorization: Bearer verso /mcp, oppure la chiave come ultimo segmento del percorso di /mcp/<key>.

claude_desktop_config.json non è una delle opzioni. Quel file configura server MCP locali; il server Finn è remoto, quindi va aggiunto come connettore personalizzato.

Passaggio 3 — Verifica il funzionamento

Chiedi a Claude:

"Quali Finn ho?"

Se la connessione funziona, la risposta riporta i nomi reali dei tuoi Finn. Se Claude dice di non avere uno strumento del genere, consulta Risoluzione dei problemi più avanti.

Gli strumenti

Sei strumenti, tra cui Claude sceglie in autonomia: non devi mai indicarne uno direttamente.

Creare un Finn in conversazione

Chiedi ciò che vuoi in linguaggio naturale. La finestra di dialogo propone questo come punto di partenza:

"Usa il connettore Finn per creare una bozza di Finn chiamata Maya che prenota appuntamenti per uno studio dentistico: cordiale, concisa, in inglese."

Una richiesta più completa è simile a questa:

"Crea un Finn chiamato Skylar che prenota demo di 15 minuti per il nostro team di vendita. Cordiale e conciso, non interrompe mai e riconferma sempre data e ora al chiamante. Deve parlare solo di demo e appuntamenti: se qualcuno chiede dei prezzi, deve proporre di passarlo a un operatore. Usa una voce femminile inglese e cordiale."

Per farlo, Claude ha bisogno di quattro informazioni e te le chiederà se ne ometti una:

Facoltativamente puoi indicare anche un'etichetta per il caso d'uso, una lingua, una voce, una frase di apertura e un vocabolario personalizzato per i nomi che altrimenti pronuncerebbe male.

In risposta ricevi un link alla nuova bozza, il suo id e l'organizzazione e l'account in cui è stata creata. A quel punto:

1. Apri il link ed esamina la bozza nel builder.
2. Chiedi modifiche a Claude — "accorcia la frase di apertura", "aggiungi un ramo per la segreteria" — e Claude modificherà direttamente la bozza.
3. Quando sei soddisfatto, associa un numero e avvia il Finn dalla dashboard. Vedi Deployment.

Una scheda della dashboard già aperta non mostrerà il nuovo Finn finché non la ricarichi.

Voci

Chiedi una voce descrivendola — "una voce maschile inglese e calma" — e Claude cercherà nel catalogo per te.

Un aspetto a cui fare attenzione: i nuovi Finn vengono creati su Cartesia, e un id voce di un altro provider viene salvato senza errori ma poi non funziona durante una chiamata reale. Se chiedi un provider specifico, assicurati che sia quello effettivamente usato dal tuo Finn. Voice Gallery contiene il catalogo completo.

Sicurezza

Il link del connettore è una password. Con la configurazione a link singolo la chiave è inclusa nell'URL, quindi chiunque veda l'URL ha il tuo stesso accesso. Non farne screenshot, non incollarlo in chat condivise e non includerlo nei commit.

Considera esposto tutto ciò che incolli. Se una chiave è finita in una chat, in un ticket o in un'email, revocala e generane una nuova. Non costa nulla.

Revoca da Impostazioni → Integrazioni → Assistenti AI → Revoca. La revoca ha effetto dalla richiesta successiva. I Finn già creati restano invariati: revocare una chiave non elimina nulla di ciò che ha creato.

Una chiave per ogni postazione. Con chiavi separate per il portatile, il desktop e ogni collega puoi revocarne una senza toccare le altre, e il nome del connettore ti indica quale è quale.

Verifica in quale account ti trovi. Se appartieni a più organizzazioni, chiedi a Claude "in quale organizzazione Finn mi trovo?" prima di creare qualsiasi cosa. I nuovi Finn vengono creati nell'organizzazione a cui ti sei unito più di recente.

Risoluzione dei problemi

"Claude non ha nessuno strumento Finn"

• Nell'app Claude, apri + → Connettori nella chat e verifica che Finn sia attivo. I connettori si attivano per singola conversazione.
• In Claude Code, riavvialo: legge la configurazione MCP all'avvio.
• Con il piano Free, verifica di non aver già usato per altro il tuo unico slot per connettori personalizzati.

"Il link del connettore non è valido"

La chiave nell'URL non è nel formato corretto. Deve essere completa, iniziare con finn_mcp_, senza parti tagliate alla fine e senza slash o spazi finali.

"Il link del connettore è stato revocato"

Quella chiave non esiste più. Generane una nuova e aggiorna il connettore.

"Impossibile raggiungere il backend Finn per verificare la chiave"

Si tratta di un problema temporaneo da parte nostra, non di un errore nella tua configurazione. Riprova; se il problema persiste, contatta l'assistenza.

Claude ha creato un Finn ma non riesci a trovarlo

Quasi sempre si tratta dell'account sbagliato. Chiedi a Claude "in quale organizzazione è stato creato?": la risposta indica l'organizzazione e l'email a cui appartiene la chiave. Se non è la tua, stai usando la chiave di qualcun altro.

Claude dice di non poter modificare un Finn

Il Finn è già stato lanciato. Il server modifica solo le bozze; un Finn live si modifica dalla dashboard.

Avanti

• Creare un Finn → — il builder della dashboard e la funzione di ciascun campo della persona.
• Deployment → — associare un numero e mettere live una bozza.
• Voice Gallery → — il catalogo completo delle voci.
• Integrazioni → — webhook e le altre integrazioni disponibili.