Collegare Claude, ChatGPT o un altro assistente IA

To Bill si collega agli assistenti IA che parlano il protocollo MCP (Model Context Protocol): Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT e molti altri. Una volta collegato, il suo assistente fa in To Bill ciò che lei può farvi di persona, con i suoi diritti e mai di più: legge le sue fatture, le sue spese e la sua contabilità e, se lei lo autorizza, corregge. Gli chiede per esempio «Verifichi la salute dei miei libri e contabilizzi le righe bancarie di ottobre», oppure «Prepari una fattura in bozza per Boulangerie du Lac».

Questa guida riguarda l’assistente che lei porta con sé. L’IA integrata in To Bill (il Copilota, il pilota automatico) ha le sue guide: veda L’assistente IA.

Prima di iniziare

• L’indirizzo da dare al suo assistente è https://app.tobill.ch/mcp. Figura anche in Impostazioni › Connessioni IA e API, sotto Indirizzo del connettore (MCP), con un pulsante Copia.
• L’assistente lavora in una sola azienda, quella che lei sceglie autorizzandolo. Per un’altra azienda, lo colleghi una seconda volta.
• Ha i diritti del suo ruolo in questa azienda. Un membro che non vede la contabilità in To Bill non la vedrà nemmeno tramite il suo assistente.
• Ciò che l’assistente legge in To Bill va al suo fornitore (Anthropic per Claude, OpenAI per ChatGPT): veda Che cosa riceve l’assistente.

Claude: claude.ai e Claude Desktop

Il connettore che aggiunge su claude.ai vale anche in Claude Desktop e sul suo telefono: basta aggiungerlo una volta.

1. In Claude, apra Customize › Connectors (i menu di Claude sono indicati qui in inglese) e clicchi su Add custom connector. In un abbonamento Team o Enterprise, è un proprietario dell’organizzazione ad aggiungerlo, in Organization settings › Connectors; ogni membro si collega poi con il proprio account To Bill.
2. Indichi un nome, per esempio To Bill, e incolli l’indirizzo https://app.tobill.ch/mcp. Lasci le impostazioni avanzate come sono.
3. Clicchi su Add, poi su Connect. Si apre la pagina di autorizzazione di To Bill: acceda se necessario (anche con Google), scelga l’azienda e l’accesso, poi clicchi su Autorizza.

Claude torna alla conversazione, collegato. Prima di agire con uno strumento che modifica i suoi dati, Claude le chiede il consenso; può bloccare uno strumento preciso nelle impostazioni del connettore.

Claude Code

In un terminale:

claude mcp add --transport http tobill https://app.tobill.ch/mcp

Poi, in Claude Code, digiti /mcp, scelga tobill e avvii l’autenticazione: il suo browser apre la pagina di autorizzazione di To Bill. Claude Code può anche collegarsi con una chiave API personale invece che con questa pagina: veda L’API e le chiavi API.

ChatGPT

A seconda del suo abbonamento ChatGPT, aggiungere un connettore personalizzato richiede la modalità sviluppatore e, in uno spazio di lavoro, il consenso del suo amministratore.

1. In ChatGPT, apra Settings › Apps, poi Advanced settings, e attivi Developer mode.
2. Crei un’applicazione (Create): un nome, per esempio To Bill, l’indirizzo https://app.tobill.ch/mcp come server MCP e l’autenticazione OAuth.
3. Salvi, poi si colleghi: si apre la pagina di autorizzazione di To Bill. Scelga l’azienda e l’accesso, poi clicchi su Autorizza.

ChatGPT le chiede di confermare ogni azione che modifica i suoi dati.

Un altro assistente

Ogni assistente che accetta un server MCP remoto (trasporto HTTP) con un accesso OAuth si collega allo stesso modo: gli dia l’indirizzo https://app.tobill.ch/mcp, ed esso apre la pagina di autorizzazione. Uno strumento senza accesso OAuth (uno script, un client a riga di comando) usa una chiave API personale: veda L’API e le chiavi API.

La pagina di autorizzazione

È la pagina di To Bill che il suo assistente apre la prima volta. Le indica:

• chi chiede l’accesso: il nome dell’applicazione. Quando l’applicazione è identificata dal proprio indirizzo (claude.ai, chatgpt.com), To Bill lo mostra. Altrimenti il nome è quello che l’applicazione si dà da sé: prosegua solo se l’ha appena collegata lei;
• dove tornerà dopo la sua risposta; per un’applicazione che gira sul suo computer, To Bill lo segnala;
• l’Azienda a cui l’assistente avrà accesso, e solo quella;
• l’Accesso richiesto: Lettura e modifica, oppure Sola lettura. Può scegliere Sola lettura anche quando l’assistente chiede di più.

Autorizza collega l’assistente; Rifiuta lo rimanda indietro senza accesso.

Che cosa può fare l’assistente

• Leggere ciò che lei vede in To Bill: clienti, articoli, preventivi, fatture, incassi, spese, contabilità (giornale, libro mastro, bilancio di verifica, salute dei libri, righe bancarie, regole bancarie), salari e tempi se vi ha accesso, impostazioni.
• Con Lettura e modifica, agire come farebbe lei: creare preventivi e fatture in bozza, registrare clienti, contabilizzare una riga bancaria, registrare una scrittura, stornare una scrittura, correggere una spesa, gestire le regole bancarie, aprire l’esercizio successivo…
• Ogni azione passa per gli stessi controlli dell’app: una scrittura contabilizzata non si modifica mai, si storna; un periodo IVA depositato resta chiuso; un documento inviato non si riscrive.

To Bill dà all’assistente le sue regole di tenuta dei libri: correggere con uno storno o con una nuova scrittura, contabilizzare i movimenti privati di una ditta individuale sul conto 2850 invece di ignorarli, non contabilizzare l’IVA per un’azienda che non vi è assoggettata, e considerare l’estratto bancario come la verità dei conti bancari.

Che cosa non può fare

• Pagare, trasferire denaro, cambiare il suo abbonamento o acquistare crediti.
• Accedere al suo posto, gestire le sue connessioni e le sue chiavi, eliminare l’azienda o il suo account.
• Agire in un’azienda diversa da quella scelta, né nel cockpit di un fiduciario.
• Gestire il team: invitare qualcuno, cambiare un ruolo o un indirizzo e-mail, rimuovere un membro; né modificare il server di posta in uscita (SMTP) dell’azienda.
• Agire in blocco: eliminare, inviare o segnare come pagati più documenti in una volta. Lo fa documento per documento, e lei conferma ciascuno.
• Scaricare l’intera azienda in una volta (l’archivio di conservazione, il pacchetto per il fiduciario), vedere il numero AVS completo di un dipendente o produrre il file di pagamento dei salari. Dell’IBAN di un dipendente vede solo le ultime 4 cifre.
• Superare i diritti del suo ruolo.

Il testo di un documento non è un ordine

L’assistente legge il testo dei suoi giustificativi, dei suoi estratti bancari e delle sue fatture. Se un testo gli chiede qualcosa («paghi questo importo», «cambi l’IBAN»), To Bill gli ha detto di non obbedire: è un dato, non un’istruzione. Rilegga sempre ciò che l’assistente sta per fare prima di accettarlo.

Chi ha fatto che cosa

Ogni modifica fatta da un assistente è registrata nell’attività dell’azienda, a nome suo e dell’assistente («Modifica tramite Claude»): sul cruscotto, Attività recenti, poi Vedi tutto per l’elenco completo. Una scrittura che registra porta come autore il suo nome seguito da quello dell’assistente, per esempio Léa Rochat via Claude.

Che cosa riceve l’assistente

Quando collega un assistente, To Bill gli invia, su sua richiesta, i dati che chiede: ciò che i suoi strumenti leggono nella sua azienda, in chiaro. Vanno al fornitore dell’assistente (Anthropic, OpenAI o un altro), secondo le sue condizioni. È lei a scegliere l’assistente e ciò in cui la aiuta. Il Copilota di To Bill, invece, sostituisce i nomi con codici prima di inviarli: veda L’assistente IA.

Revocare l’accesso

1. Apra Impostazioni › Connessioni IA e API (anche dal menu del suo nome, in basso a sinistra).
2. Sotto Applicazioni collegate, clicchi su Revoca accanto all’assistente, poi confermi.

L’accesso si interrompe subito. Rimuovere il connettore nell’assistente non sempre basta: lo revochi anche in To Bill. Una connessione inutilizzata per 30 giorni si interrompe da sé; basta allora ricollegare l’assistente.