Tab: Assistenti AI

Panoramica

La tab Assistenti AI spiega come collegare a Brokero l'assistente AI che usi già: Claude, ChatGPT, Gemini e gli altri che supportano i connettori MCP. Con il connettore, l'assistente 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, non cancella e non invia niente. Vede quello che vedi tu nell'app, con le stesse regole.

Prima la tab si chiamava Collega Claude: i link vecchi alle Impostazioni (?tab=claude) aprono questa.

L'indirizzo

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

Al primo collegamento l'assistente apre l'accesso di Brokero: entri col tuo account e autorizzi.

Come si collega

Sotto l'indirizzo, una scheda per assistente: Claude, ChatGPT, Gemini e Altri. Ognuna ha i passi, cosa serve e qualche nota. I nomi dei menu sono quelli che mostra l'assistente, e cambiano spesso: se non li trovi, cerca «connettore personalizzato» o «custom MCP» nelle impostazioni dell'assistente.

Claude

Piani Pro e Max

1. Su claude.ai apri Impostazioni → Connettori e scegli Aggiungi connettore personalizzato.
2. Dagli un nome, per esempio Brokero, e incolla l'indirizzo.
3. Premi Collega e accedi con il tuo account Brokero.

Piani Team ed Enterprise

1. L'Owner lo aggiunge una volta dalle impostazioni dell'organizzazione, alla voce Connettori, con lo stesso indirizzo.
2. Poi ognuno lo trova fra i suoi connettori, preme Collega e accede con il proprio account Brokero.

Claude Code

1. Nel terminale (la tab mostra il comando pronto da copiare):

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

2. Dentro Claude Code scrivi /mcp, scegli brokero e accedi con il tuo account Brokero.

Serve: un piano Pro, Max, Team o Enterprise di Claude, oppure Claude Code.

• Claude Desktop usa gli stessi connettori dell'account claude.ai: se hai aggiunto Brokero lì, c'è già.
• Su Team ed Enterprise Claude legge quello che vede chi si è collegato, non chi ha aggiunto il connettore.
• Per toglierlo da Claude Code: claude mcp remove brokero.

ChatGPT

Da chatgpt.com (in beta)

1. Su chatgpt.com, dal computer, apri la sezione delle App (in alcune versioni Plugin), premi + e scegli Add custom MCP server.
2. Come nome scrivi Brokero, incolla l'indirizzo e come autenticazione scegli OAuth.
3. Conferma l'avviso con I understand and want to continue e crea il connettore.
4. Collegalo e accedi con il tuo account Brokero.

Serve: ChatGPT dal web; nei workspace Business ed Enterprise, i connettori MCP personalizzati permessi dall'amministratore.

• Nei workspace Business ed Enterprise l'amministratore deve prima permettere i connettori MCP personalizzati (Developer mode) dalle impostazioni del workspace.
• È una funzione in beta e si configura solo dal web.

Gemini

Da gemini.google.com

1. Dal computer apri gemini.google.com e vai in Settings → Connected Apps.
2. Scegli Add a custom app e incolla l'indirizzo.
3. Premi Next e accedi con il tuo account Brokero.

Serve: un account Google personale (non di lavoro né della scuola), almeno 18 anni, l'Attività attiva (Keep Activity) e Gemini in inglese. Per ora solo negli Stati Uniti.

• Le app personalizzate ci sono solo con l'interfaccia in inglese: per questo i menu sono in inglese.
• Gemini Enterprise (Business): l'amministratore del team lo aggiunge da Gestisci team → App collegate → Aggiungi server MCP.

Altri assistenti

Mistral Le Chat

1. Apri Intelligenza → Connettori → Aggiungi connettore.
2. Scegli Custom MCP Connector e incolla l'indirizzo.
3. Come autenticazione scegli OAuth 2.1, premi Collega e accedi con il tuo account Brokero.

Microsoft Copilot Studio, per chi costruisce gli agenti dell'azienda

1. Nell'agente aggiungi un server MCP esistente e incolla l'indirizzo.
2. Come autenticazione scegli OAuth con registrazione dinamica.

Editor e strumenti da terminale (Cursor, VS Code, Gemini CLI, Claude Code)

1. Aggiungi un server MCP remoto (HTTP) con l'indirizzo.
2. Al primo uso accedi con il tuo account Brokero.

Serve: un assistente o uno strumento che supporta i server MCP remoti con l'accesso OAuth.

Qualunque assistente che supporta i server MCP remoti con OAuth funziona allo stesso modo: incolli l'indirizzo, entri col tuo account Brokero e autorizzi.

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 all'assistente 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 all'assistente di restringere (una compagnia, un periodo, uno stato).

Cosa legge

• Le stesse regole 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 all'assistente 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 l'assistente 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), l'assistente riceve il messaggio 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 e tutti gli assistenti. Il conteggio riparte a mezzanotte.

Quali dati passano all'assistente

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 scollegarlo

Dalle impostazioni dell'assistente, dove l'hai aggiunto: apri il connettore Brokero e scollegalo o rimuovilo. Il collegamento con Brokero si chiude da lì: da quel momento l'assistente non legge più niente dal tuo libro. Da Claude Code: claude mcp remove brokero.

Uso

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