Tab: Collega Claude

Il connettore che fa leggere a Claude il tuo libro di Brokero, come si collega a claude.ai, Claude Desktop e Claude Code, cosa legge e come si scollega.

Panoramica

La tab Collega Claude spiega come collegare Claude a Brokero. Con il connettore, Claude (claude.ai, Claude Desktop o Claude Code) legge i dati del tuo libro e risponde alle domande sul portafoglio: chi ha una polizza in scadenza a novembre, quanto resta da incassare, la scheda di un cliente, i preventivi ancora aperti.

Il connettore legge soltanto: non crea, non modifica e non cancella niente. Vede quello che vedi tu nell'app, con le stesse regole.

L'indirizzo

In cima alla tab c'è l'indirizzo del connettore, https://brokero.it/api/mcp, con il pulsante Copia. È lo stesso per tutti: chi legge cosa lo decide l'account con cui ti colleghi.

Come si collega

Al primo uso Claude apre la pagina di accesso di Brokero: entri con il tuo account e autorizzi il collegamento.

claude.ai, piani Pro e Max

Apri Impostazioni → Connettori e scegli Aggiungi connettore personalizzato.
Dagli un nome (per esempio Brokero) e incolla l'indirizzo.
Collegalo e accedi con il tuo account Brokero.

claude.ai, piani Team ed Enterprise

L'Owner lo aggiunge una volta dalle impostazioni dell'organizzazione, alla voce Connettori, con lo stesso indirizzo; poi ognuno lo trova fra i suoi connettori e si collega con il proprio account Brokero. Claude legge quello che vede chi si è collegato, non chi ha aggiunto il connettore.

Claude Desktop

Usa i connettori del tuo account claude.ai: se hai aggiunto Brokero lì, c'è già. Altrimenti aggiungilo da Impostazioni → Connettori, come su claude.ai.

Claude Code

Nel terminale:

claude mcp add --transport http brokero https://brokero.it/api/mcp

Poi, dentro Claude Code, scrivi /mcp, scegli brokero e accedi con il tuo account Brokero. La tab mostra il comando pronto da copiare.

Cosa sa fare

Strumento	Cosa risponde
i_miei_libri	Quali libri leggi: il libro personale e i team di cui fai parte, col tuo ruolo
riepilogo	I numeri del libro: clienti, polizze attive, titoli e rinnovi dei prossimi 30 giorni, preventivi aperti, e i titoli da incassare se hai l'accesso all'Amministrazione
cerca_clienti	I clienti per nome, ragione sociale, codice fiscale, partita IVA o email
cliente	La scheda di un cliente: contatti, indirizzo, polizze e preventivi
polizze	Le polizze, per compagnia, stato o data di scadenza
polizza	La scheda di una polizza con i suoi titoli e cosa resta da incassare
scadenze	Lo Scadenzario di un periodo: titoli da incassare e polizze da rinnovare (di norma i prossimi 30 giorni, al massimo tre mesi avanti)
preventivi	I preventivi, tutti o di uno stato; «aperti» sono le bozze e gli inviati non ancora scaduti
titoli_da_incassare	Tutti i titoli non incassati del libro, solo con l'accesso all'Amministrazione

Le date arrivano a Claude come GG/MM/AAAA e gli importi in euro. Un elenco porta al più 50 righe e dice quante ne restano fuori: per vedere le altre, chiedi a Claude di restringere (una compagnia, un periodo, uno stato).

Le regole

Le stesse dell'app. L'amministratore di un team legge tutto il libro del team; il collaboratore i suoi clienti, quelli assegnati a lui e quelli delle polizze di cui è referente; i preventivi degli altri solo col permesso Visualizza tutti i preventivi. In modalità personale, solo il libro personale.
Il libro. Se fai parte di un team, puoi dire a Claude quale libro leggere («nel team Studio Rossi», «nel mio libro personale»). Senza, legge il tuo unico team, oppure il libro personale. Ogni risposta dice da quale libro viene.
Amministrazione. I titoli da incassare di tutto il libro li legge solo chi ha l'accesso all'Amministrazione; agli altri Claude risponde che non è permesso. Lo Scadenzario resta per tutti, come nell'app.
Account o team sospesi. Un account sospeso non legge niente; un team sospeso non compare fra i libri.
Abbonamento. Se l'abbonamento del libro non è attivo (prova finita, abbonamento disdetto), Claude risponde che va riattivato da brokero.it e non legge niente di quel libro. Per un team conta l'abbonamento di chi l'ha creato.
Un tetto al giorno. Fino a 300 chiamate al giorno per persona, su tutti i libri. Il conteggio riparte a mezzanotte.

Quali dati passano a Claude

Solo quando gli fai una domanda, e solo quello che restituiscono gli strumenti che usa per rispondere (al più 50 righe per elenco): nomi, codici fiscali, contatti e indirizzi dei clienti; numeri, compagnie, date, importi e note di polizze, titoli e preventivi.

Non passano i documenti caricati, i documenti d'identità dei clienti, né i PIN e i link dei preventivi.

Come si scollega

claude.ai e Claude Desktop: Impostazioni → Connettori, apri Brokero e scollegalo o rimuovilo.
Claude Code: claude mcp remove brokero.

Da quel momento Claude non legge più niente dal tuo libro.

Uso

In fondo alla tab trovi quante chiamate ha fatto Claude negli ultimi 30 giorni e oggi, con il tetto del giorno.