Documentazione

Collegare i suoi sistemi (MCP)

Italiano

In questa pagina

Un assistente che sa solo parlare è utile; un assistente che sa fare diventa un prodotto. Busymate AI consente a bro di chiamare i tuoi strumenti tramite il tuo server MCP, per consultare informazioni e apportare modifiche ai tuoi sistemi per conto degli utenti, secondo le regole che stabilisci.

MCP (Model Context Protocol) è uno standard aperto per esporre strumenti a un’IA. Se i tuoi sistemi supportano già MCP, bro si collega allo stesso modo in cui si collega a tutti gli altri, senza codice di integrazione specifico della piattaforma.

Come bro agisce sui dati dei tuoi utenti

Quando l’assistente deve fare qualcosa, chiama uno strumento sul tuo server MCP. Due elementi rendono sicura l’operazione:

bro comunica al server chi è l’utente tramite un token di breve durata, firmato crittograficamente, che il server verifica. Non può essere contraffatto né riutilizzato, quindi il server sa sempre esattamente a quale utente appartiene la richiesta.
Il tuo server applica l’ambito. Poiché MCP conosce l’utente, restituisce e modifica solo i dati di quella persona. bro non vede mai più di quanto il server gli consegna.

Livelli di autorizzazione

Ogni strumento che esponi riceve un livello, così l’assistente può accedere solo a ciò che è appropriato per chi effettua la richiesta:

Livello	Per chi	Cosa consente
Pubblico	Chiunque, inclusi gli ospiti	Letture sicure e non personali — informazioni sul prodotto e assistenza generale.
Identificato	Un utente autenticato	Letture e azioni solo sui propri dati.
Delegato	Un utente autenticato, per le azioni che richiedono la sua autorizzazione	Le stesse operazioni, quando vuoi un’autorizzazione esplicita dell’utente.
Conferma	Qualsiasi azione di scrittura contrassegnata	L’utente deve confermare prima dell’esecuzione; prima viene mostrata l’azione completa.

Le operazioni distruttive o sensibili sono protette da una conferma: bro mostra esattamente cosa sta per fare e attende un “sì” umano. Nulla scrive silenziosamente.

Configurazione

La sezione Integrazione della Console di Busymate AI è la fonte attendibile per questa configurazione. Viene generata dalla configurazione attiva del tenant selezionato, quindi URL, valori di identità, snippet e checklist di pubblicazione restano aggiornati; non esiste un documento di handoff separato che possa divergere.

Apri Console → Integrazione e seleziona il tenant da configurare.
Segui il passaggio MCP fino a Connessioni, aggiungi l’URL del server e il collegamento delle credenziali, poi esegui la verifica.
Esamina ogni strumento rilevato e assegna consapevolmente le policy Pubblico, Identificato, Delegato e Conferma.
Esegui il controllo preliminare e pubblica la revisione del tenant. Una verifica fallita o un contratto di identità incompleto blocca la pubblicazione invece di creare un assistente collegato solo in parte.

La sezione Integrazione offre anche una guida di automazione pronta da copiare e l’endpoint MCP di gestione di Busymate AI per i team che vogliono affidare a un agente lo stesso processo limitato al tenant. Vedi Per iniziare.

Collega Claude Code all’MCP di gestione

Un solo comando; il browser gestisce l’accesso con il tuo account abituale (OAuth 2.1 — non si incolla nulla):

bash

claude mcp add --transport http busymate-ai https://busymate.ai/mcp

Poi esegui /mcp in Claude Code e scegli busymate-ai → Autentica. Qualsiasi altro client HTTP-MCP (Claude Desktop, Cursor, …) si collega con la sola URL https://busymate.ai/mcp: la discovery OAuth è servita sia sull’endpoint sia sull’origine, quindi non serve alcuna configurazione lato client oltre alla URL.

Utenti che collegano i propri account

La delega OAuth per utente è disponibile per i connettori white label. Usala quando ogni utente deve autorizzare il proprio account presso un servizio che non gestisci. Configura in Connessioni i metadati OAuth di autorizzazione, token e revoca del connettore, quindi pubblica i suoi strumenti delegati.

Gli strumenti di account delegati supportano due modalità esplicite:

Token attore cliente firmato — consigliato quando il tuo prodotto ha già verificato il visitatore. Busymate AI genera per il tuo server MCP un token attore di breve durata, vincolato al tenant e al connettore, così l’accesso all’account è automatico e il cliente non vede né un secondo accesso né un’altra richiesta di consenso.
OAuth per cliente autenticato — usalo quando è intenzionale un’autorizzazione separata. L’assistente mostra una sola volta Autorizza gli strumenti dell’account, usa il flusso OAuth 2.1 authorization code con PKCE e collega lato server l’autorizzazione al tenant, al connettore e all’utente finale verificato.

Entrambe le modalità falliscono in modo sicuro. Il tuo server MCP ricava il cliente esclusivamente dal bearer verificato e non considera mai attendibile un identificativo di account passato negli argomenti dello strumento. Le autorizzazioni OAuth possono essere revocate dal menu account; i token attore firmati scadono entro cinque minuti e sono vincolati a un solo connettore.

Avanti

Per iniziare — dove viene collegato il tuo MCP.
Governance e policy dei modelli — abilita gli strumenti e imposta le regole di conferma.
L’esperienza dell’assistente — scopri come le azioni appaiono all’utente.