Server MCP SiteBoS:
Cosa Puoi (e Non Puoi) Chiedere
In Breve
Un ponte diretto e sicuro tra i tuoi dati reali e un assistente AI esterno
Il Server MCP (Model Context Protocol) è il modo in cui un assistente AI esterno — Claude Desktop, Claude Code, Antigravity, o un agente vocale compatibile — può leggere i dati reali e aggiornati della tua attività su SiteBoS, invece di lavorare a memoria o inventare risposte. Non è un chatbot nuovo: è un canale che qualunque assistente MCP-compatibile può collegare.
1. Come Attivarlo
URL del server e Access Token si trovano nella pagina Configurazione Titolare (edit_owner.html), sezione "Server MCP — Dati Live per Agenti Esterni": copia i due valori e incollali nella configurazione del tuo client MCP (trovi anche uno snippet pronto per Claude Desktop). L'Access Token è lo stesso che usi per accedere alla Dashboard — non è un valore separato da gestire a parte, ma va comunque trattato come una password: chi lo possiede può leggere i dati della tua attività.
2. I 6 Strumenti Reali (Tool)
Ogni tool interroga direttamente il database di SiteBoS al momento della domanda — non uno snapshot vecchio, non un'invenzione del modello linguistico.
get_catalog
Cosa fa: elenca i servizi e prodotti attivi del catalogo, con prezzi reali.
Esempio: "Quali servizi di igiene abbiamo in catalogo e a che prezzo?"
get_catalog_item_detail
Cosa fa: dettaglio completo di UN prodotto/servizio specifico, cercato per nome o codice.
Esempio: "Dammi tutti i dettagli del servizio Sbiancamento Dentale."
get_job_status
Cosa fa: stato di UNA prenotazione/job specifica (serve il codice turno o l'identificativo job — non un nome generico).
Esempio: "A che punto è la prenotazione #A-05?"
get_availability
Cosa fa: elenca gli slot già occupati registrati nativamente in SiteBoS (jobs) per un intervallo di date.
Esempio: "Cosa abbiamo già in agenda per la prossima settimana?"
get_handover_status
Cosa fa: stato delle richieste di intervento operatore attualmente aperte.
Esempio: "Ci sono clienti in attesa di un operatore umano adesso?"
trigger_handover
Cosa fa: invia una notifica realtime immediata alla Desk Board per chiedere l'intervento di un operatore umano.
Esempio: "Segnala alla reception che serve un intervento urgente per questo cliente."
3. Cosa NON Puoi Chiedere (Limiti Reali, Non Teorici)
Questi non sono avvertimenti generici: sono i limiti tecnici effettivi di come i 6 tool sono costruiti oggi.
- Nessuna scrittura sul catalogo o sui prezzi. Tutti i tool di catalogo sono a sola lettura — non puoi far modificare, creare o cancellare un prodotto/servizio da qui.
- La disponibilità vede solo SiteBoS, non ancora il gestionale esterno.
get_availabilitylegge solo gli appuntamenti già registrati nativamente in SiteBoS (jobs). Se usi anche un gestionale esterno (es. per uno studio odontoiatrico) e non hai ancora attivato la sincronizzazione, quegli appuntamenti non compaiono qui. get_job_statusnon fa ricerche libere. Serve un riferimento preciso (codice turno o job id) — non puoi chiedere genericamente "tutte le prenotazioni di Mario Rossi" senza quel dato.trigger_handovernon crea un ticket permanente né invia messaggi al cliente. Pubblica solo una notifica realtime sul canale della Desk Board: se in quel momento nessun operatore ha la Desk Board aperta, la notifica non viene vista finché non la riaprono. Non manda SMS, email o messaggi WhatsApp per conto tuo.- Nessun tool prenota, cancella o modifica un appuntamento. Tutti e 6 sono pensati per leggere/segnalare, non per agire al posto della segreteria.
- Senza Access Token valido, nessun tool risponde con dati reali. Ogni chiamata viene verificata contro le credenziali del tenant prima di eseguire qualunque lettura.