MCP Server Integration
ChatReact implementa il Model Context Protocol (MCP), permettendo di collegare il suo account ChatReact ad assistenti AI come Claude Desktop, Cursor e altri strumenti compatibili MCP.
Che cos'è MCP?
Il Model Context Protocol è uno standard aperto che consente agli assistenti AI di interagire con servizi esterni e fonti di dati. Con l'integrazione MCP di ChatReact, può:
- Gestire chatbot — creare, configurare (persona, lingue, widget, comportamento, restrizioni), incorporare ed eliminare chatbot
- Costruire la knowledge base — aggiungere documenti, eseguire la scansione di siti web, gestire le pagine scansionate e le core instructions
- Gestire le FAQ — FAQ, categorie, suggerimenti, traduzioni e il widget FAQ
- Revisionare le chat — valutare conversazioni, assegnare categorie di fiducia, eseguire l'Improvement Agent
- Lavorare con lead e moduli — lead, categorie di lead, impostazioni di acquisizione, form di contatto e invii
- Agire come agente di live chat — impostare la disponibilità, prendere in carico chat in attesa, rispondere e chiudere sessioni
- Amministrare la sua azienda — profilo, colori del brand, membri del team e inviti
- Usare l'Email Assistant — connessioni mailbox, categorie, contatti e attività
- Leggere analytics e notifiche
Tutto ciò che è possibile fare nella dashboard è disponibile tramite MCP (e la REST API); solo azioni vincolate al browser come pagamenti, mailbox OAuth, passkey, cancellazione account e gestione delle API key rimangono nella dashboard.
Per iniziare
1. Generare una API Key
- Navighi su Dashboard → Azienda → API tab
- Clicchi Crea chiave API
- Assegni alla chiave un nome descrittivo (es.: "Claude Desktop") e selezioni almeno un permesso
- Copi la chiave generata (inizia con
cr_)
Le API key sono disponibili nei piani a pagamento — veda la nostra pagina Pricing.
Conservi la sua API key in modo sicuro. Non potrà essere recuperata dopo la creazione.
2. Configurare il suo client MCP
Il server MCP di ChatReact è ospitato su https://www.chatreact.ai/api/mcp e comunica tramite HTTP (JSON-RPC). Autentichi con un header Authorization: Bearer — è accettato anche un header X-API-Key con la stessa chiave.
Cursor IDE
Cursor supporta server MCP remoti direttamente. Aggiunga nelle impostazioni MCP di Cursor:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Il file di configurazione di Claude Desktop supporta server basati su comandi, quindi utilizzi il bridge standard mcp-remote per connettersi all'endpoint ospitato:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"chatreact": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.chatreact.ai/api/mcp",
"--header",
"X-API-Key:cr_your_api_key_here"
]
}
}
}
Questa configurazione richiede Node.js installato. L'esempio usa l'header X-API-Key perché alcuni client non gestiscono gli spazi negli argomenti in modo affidabile.
3. Riavviare il suo assistente AI
Dopo aver salvato la configurazione, riavvii Claude Desktop o Cursor per stabilire la connessione.
Strumenti disponibili
ChatReact MCP espone gli strumenti elencati di seguito, raggruppati per area. La colonna Scope mostra il permesso dell'API key richiesto da uno strumento (any = ogni chiave valida). Gli strumenti vengono eseguiti con gli stessi permessi applicabili, limiti di piano e effetti collaterali delle operazioni supportate dalla dashboard. I workflow vincolati al browser per pagamenti, autorizzazione mailbox, passkey, cancellazione account e gestione chiavi rimangono nella dashboard.
Gli strumenti distruttivi (delete, reset, close, merge) richiedono una conferma quando usati tramite il Dashboard Assistant. Tramite API key vengono eseguiti immediatamente.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Ottiene il piano corrente (tier, status), i contatori d'uso del periodo di fatturazione corrente (companies, chatbots, team members, chats, tokens) e i limiti del piano, oltre ai limiti effettivi e ai feature flag della company a cui la chiamata è limitata. | any |
user_companies | Elenca tutte le company a cui l'utente corrente ha accesso, con il ruolo dell'utente in ciascuna. | any |
user_notification_mark_read | Segna come letta una delle notifiche dell'utente corrente. | any |
user_notification_preferences_get | Ottiene le preferenze di notifica dell'utente corrente: toggle globali email/push, frequenza/ora/giorno/ timezone del digest, quiet hours e impostazioni per canale per tipo. | any |
user_notification_preferences_update | Aggiorna le preferenze di notifica globali dell'utente corrente (toggle email/push, programma digest, quiet hours). | any |
user_notification_type_setting_update | Abilita o disabilita la consegna via email / in-app per un singolo tipo di notifica dell'utente corrente (es. | any |
user_notification_types_list | Elenca tutti i tipi di notifica raggruppati per categoria (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Ottiene il numero di notifiche non lette dell'utente corrente. | any |
user_notifications | Elenca le notifiche dell'utente corrente, dalla più recente, con paginazione cursor. | any |
user_notifications_delete_old | Manutenzione: elimina permanentemente le notifiche dell'utente corrente già lette e più vecchie di 30 giorni. | any |
user_notifications_mark_all_read | Segna come lette tutte le notifiche dell'utente corrente. | any |
user_profile | Ottiene il profilo dell'utente corrente (id, name, email, role, subscription tier). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Elenca tutti i chatbot di una specifica company con statistiche di riepilogo. | chatbots:read |
company_get | Ottiene informazioni dettagliate su una company: profilo, owner, impostazioni brand (colori, notification email) e conteggi. | any |
company_invite_cancel | Annulla (elimina) un invito al team in modo che il link non funzioni più. | company:write |
company_invite_resend | Reinvia un invito al team pendente: emette un nuovo token, estende la scadenza di 7 giorni e invia nuovamente l'email di invito. | company:write |
company_invites_list | Elenca gli inviti al team di una company (pendenti per default; impostando includeExpired restituisce anche quelli scaduti). | company:read |
company_list | Elenca tutte le company a cui l'utente ha accesso (API key e Dashboard Assistant vedono solo la propria company). | any |
company_logo_remove | Rimuove il logo della company (elimina l'immagine memorizzata e cancella l'URL del logo). | company:write |
company_member_invite | Invita un membro del team via email con un ruolo (ADMIN, MANAGER, AGENT o VIEWER). | company:write |
company_member_remove | Rimuove un membro del team dalla company. | company:write |
company_member_update_role | Cambia il ruolo di un membro del team (ADMIN, MANAGER, AGENT o VIEWER). | company:write |
company_members_list | Elenca i membri di una company con i loro ruoli (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Aggiorna le impostazioni del brand della company: primaryColor / secondaryColor (#RRGGBB) e notificationEmail per le revisioni chat. | company:write |
company_update | Aggiorna il profilo della company: nome (2-100 caratteri), descrizione (max 1000 caratteri) o sito web (https:// viene aggiunto automaticamente; passare stringa vuota per cancellare sito/descrizione). | company:write |
Gestione Chatbot
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Aggiunge una nuova core instruction a un chatbot (1-5000 caratteri). | chatbots:write |
chatbot_confirm_embed | Segna un chatbot come embedded sul sito (nasconde il promemoria di setup nella dashboard). | chatbots:write |
chatbot_create | Crea un nuovo chatbot (come il wizard della dashboard). | chatbots:write |
chatbot_delete | Elimina definitivamente un chatbot con tutte le sue FAQ, documenti, chat, lead e moduli (non può essere annullato). | chatbots:write |
chatbot_delete_instruction | Elimina una core instruction da un chatbot. | chatbots:write |
chatbot_get | Ottiene informazioni dettagliate su un chatbot: impostazioni generali, personalità (persona, tonalità, lingue, restrizioni), impostazioni widget, live chat, learning phase, stato embed e conteggi. | chatbots:read |
chatbot_get_embed_code | Ottiene lo snippet HTML per installare un chatbot su un sito (URL dello script + tag <script>) e se l'embed è stato confermato. | chatbots:read |
chatbot_get_instructions | Ottiene tutte le core instructions di un chatbot. | chatbots:read |
chatbot_improve_instructions | Riscrive il testo di una core instruction con l'AI della piattaforma (come "Improve with AI" della dashboard). | chatbots:write |
chatbot_learning_phase_get | Ottiene le impostazioni della learning phase di un chatbot: preset di comportamento (CAUTIOUS, BALANCED, CONFIDENT), prompt personalizzato e se il bot è ancora in learning phase. | chatbots:read |
chatbot_learning_phase_update | Imposta il comportamento preset della learning phase (CAUTIOUS = rimanda a un umano quando non sicuro, BALANCED, CONFIDENT) e/o un prompt personalizzato per la learning phase. | chatbots:write |
chatbot_list | Elenca tutti i chatbot a cui l'utente ha accesso, con statistiche di riepilogo. | chatbots:read |
chatbot_reorder_instructions | Imposta l'ordine delle core instructions di un chatbot. | chatbots:write |
chatbot_templates_list | Elenca i template di chatbot (preset per persona, tonalità, messaggi e comportamento del widget) che possono essere passati come templateId a chatbot_create, e se il piano della company può usarli. | chatbots:read |
chatbot_toggle_active | Attiva o disattiva un chatbot. | chatbots:write |
chatbot_toggle_learning | Termina (false) o riabilita (true) la learning phase di un chatbot. | chatbots:write |
chatbot_update | Aggiorna le impostazioni generali di un chatbot: nome, descrizione, isActive, live chat (liveChatEnabled/liveChatMode, feature del piano), showBranding (piani white-label), email per chat-review, generazione automatica FAQ, testo legacy coreInstructions, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Aggiorna una core instruction esistente (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Aggiorna la personalità di un chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), slider di tonalità 1-5, lingue (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), messaggi (welcomeMessage, fallbackMessage, proactive greeting) e restrizioni (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Ottiene le impostazioni correnti del widget per un chatbot (tutti gli aspetti di aspetto, branding, comportamento e i campi del pre-chat form). | chatbots:read |
widget_settings_update | Aggiorna il chat widget di un chatbot: posizione (incl. | chatbots:write |
widget_translations_get | Ottiene le traduzioni per lingua del widget di un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Imposta le traduzioni del widget per lingua. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Annulla un job di crawl PENDING o RUNNING; le pagine rimanenti vengono saltate. | knowledge:write |
crawler_job_get | Ottiene lo stato di un job di crawl, il progresso (pagesCrawled/pagesFound, tokensUsed) e lo stato di ogni pagina. | knowledge:read |
crawler_jobs_list | Elenca i job di crawl di un chatbot (dal più recente) con stato e progresso. | knowledge:read |
crawler_limits | Ottiene i limiti di crawl del piano per un chatbot (max pagine per crawl, tokens per pagina, crawl per mese) e se è possibile avviare un nuovo crawl questo mese. | knowledge:read |
crawler_preview_scan | Scansiona un sito web e elenca le sue pagine crawlable (url, title, isRecommended) senza importare nulla. | knowledge:write |
crawler_start | Avvia un job di crawl che importa gli URL selezionati nella knowledge base del chatbot (processato in background; interrogare crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Scarica un documento (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) da un URL http(s) pubblico e lo aggiunge alla knowledge base di un chatbot. | knowledge:write |
knowledge_document_add_text | Aggiunge un documento di testo o markdown alla knowledge base di un chatbot da contenuto inline (max 10 MB). | knowledge:write |
knowledge_document_delete | Elimina un documento caricato dalla knowledge base. | knowledge:write |
knowledge_document_get | Ottiene i dettagli di un documento caricato inclusi stato di elaborazione, messaggio di errore e un URL di download a breve termine. | knowledge:read |
knowledge_documents_list | Elenca i documenti caricati (PDF, TXT, MD, CSV, JSON, DOCX) nella knowledge base di un chatbot con stato e dimensione. | knowledge:read |
knowledge_page_add | Esegue il crawl di un singolo URL e lo aggiunge alla knowledge base del chatbot (fallisce con CONFLICT quando l'URL è già indicizzato, FORBIDDEN quando il limite di token è raggiunto). | knowledge:write |
knowledge_page_delete | Elimina una pagina scansionata dalla knowledge base (rimuove il file vector-store). | knowledge:write |
knowledge_page_get | Ottiene una pagina scansionata incluso il contenuto markdown indicizzato per il chatbot (utile per verificare cosa il bot conosce su una pagina). | knowledge:read |
knowledge_page_recrawl | Recupera nuovamente una pagina scansionata e ne sostituisce il contenuto indicizzato (es. | knowledge:write |
knowledge_pages_delete | Elimina diverse pagine scansionate di un chatbot in una sola volta. | knowledge:write |
knowledge_pages_list | Elenca le pagine scansionate nella knowledge base di un chatbot, opzionalmente filtrate per dominio, stato o termine di ricerca (URL/title). | knowledge:read |
knowledge_stats | Panoramica della knowledge base di un chatbot: documenti (per stato, dimensione), pagine scansionate e siti (per stato), job di crawl, core instructions divise per fonte (manuale vs improvement agent), FAQ, stato/dimensione del vector store e utilizzo storage vs. | knowledge:read |
knowledge_website_delete | Elimina tutte le pagine scansionate di un sito (dominio) dalla knowledge base del chatbot. | knowledge:write |
knowledge_website_recrawl | Riesegue il crawl di tutte le pagine di un sito (dominio) nella knowledge base del chatbot per aggiornare il contenuto. | knowledge:write |
knowledge_website_recrawl_cancel | Annulla una riesecuzione di crawl in corso di un sito: le pagine in coda (PENDING) del dominio vengono revertite al loro stato indicizzato precedente. | knowledge:write |
knowledge_websites_list | Elenca i siti (domini) le cui pagine sono nella knowledge base di un chatbot, con conteggi di pagine per stato e totali token. | knowledge:read |
Gestione Prezzi
Questi strumenti gestiscono bozze di prezzi strutturate e approvazioni esplicite. Salvare una bozza è separato dall'approvare la versione esatta; l'idoneità dipende anche da stato e validità. Le API key esistenti non acquisiscono automaticamente i permessi prezzo. Solo il proprietario della company può concedere prices:write o prices:approve. Le chiamate tramite API key vengono eseguite direttamente, quindi riveda l'input esatto prima di eseguire una mutation. Veda Prices & services per il workflow cliente.
| Tool | Description | Scope |
|---|---|---|
price_list | Pagine attraverso price heads e separa l'idoneità alla versione approvata. | prices:read |
price_get | Legge lo stato completo dell'item e le revisioni. | prices:read |
price_detail | Legge il dettaglio dell'item con storico revisioni paginato. | prices:read |
price_suggestions_list | Pagine attraverso price suggestions. | prices:read |
price_create | Crea una bozza con un ID item generato dal server. | prices:write |
price_edit | Crea una nuova bozza da una versione item esplicitamente attesa. | prices:write |
price_import_csv | Importa bozze con un formato esplicito e un import ID stabile per retry sicuri. | prices:write |
price_suggestion_apply | Applica la suggestion candidate selezionata come bozza. | prices:write |
price_approve | Approva una versione item esplicitamente attesa. | prices:approve |
price_approve_many | Approva una selezione ID/versione esplicita in modo atomico; qualsiasi versione stale respinge l'intera selezione. | prices:approve |
price_archive | Archivia un item alla sua versione esplicitamente attesa. | prices:approve |
Le modifiche alle bozze preservano la revisione approvata precedente. Formato CSV e separatore decimale devono essere espliciti; contenuto CSV modificato richiede un nuovo import ID. Tutte le operazioni sono vincolate alla company dell'API key e al chatbot specificato.
Gestione FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Pulisce i dati cache del widget FAQ su tutti i siti CMS connessi (plugin WordPress). | faqs:write |
faq_categories_list | Elenca le categorie FAQ di un chatbot con i conteggi FAQ, slug, modalità di ordinamento e traduzioni. | faqs:read |
faq_categories_reorder | Imposta l'ordine delle categorie FAQ nel widget: la posizione in categoryIds diventa sortOrder. | faqs:write |
faq_category_create | Crea una categoria FAQ per un chatbot (lo slug viene generato dal nome). | faqs:write |
faq_category_delete | Elimina una categoria FAQ. | faqs:write |
faq_category_translations_update | Sostituisce le traduzioni di una categoria FAQ, es. | faqs:write |
faq_category_update | Rinomina una categoria FAQ o ne modifica la descrizione, l'icona o la modalità di ordinamento. | faqs:write |
faq_create | Crea una FAQ per un chatbot. | faqs:write |
faq_delete | Elimina definitivamente una FAQ (la rimuove anche dalla knowledge base del chatbot e svuota le cache dei widget CMS). | faqs:write |
faq_embed_code_get | Ottiene gli snippet di embed per il widget FAQ: tag script, shortcode WordPress e snippet Shopify Liquid, più varianti per categoria (usare categorySlug da faq_categories_list per incorporare solo una categoria). | chatbots:read |
faq_get | Ottiene i dettagli completi di una FAQ: domanda, risposta, categoria, stato di pubblicazione, ordine, traduzioni, campi SEO e statistiche di feedback. | faqs:read |
faq_list | Elenca le FAQ di un chatbot (usare chatbot_list per trovare chatbotId). | faqs:read |
faq_reorder | Imposta l'ordine di visualizzazione delle FAQ nel widget. | faqs:write |
faq_suggestion_approve | Approva una suggestion FAQ PENDING: crea una FAQ pubblicata (opzionalmente con domanda/risposta/categoria modificata) e segna la suggestion come APPROVED. | faqs:write |
faq_suggestion_get | Ottiene i dettagli completi di una suggestion FAQ (risposta completa, ragionamento AI, categoria suggerita, stato di revisione). | faqs:read |
faq_suggestion_reject | Respinge una suggestion FAQ PENDING con motivo opzionale. | faqs:write |
faq_suggestions_generate | Permette all'AI di proporre nuove FAQ dalla knowledge base del chatbot (pagine scansionate / documenti caricati), opzionalmente per una sola categoria. | faqs:write |
faq_suggestions_list | Elenca le suggestion FAQ generate dall'AI di un chatbot (da conversazioni chat o faq_suggestions_generate). | faqs:read |
faq_translate | Traduce domanda e risposta di una FAQ con l'AI nelle altre lingue supportate dal chatbot (o nelle targetLanguages fornite) e salva il risultato. | faqs:write |
faq_translations_update | Salva le traduzioni di una FAQ per lingua, es. | faqs:write |
faq_update | Aggiorna la domanda, la risposta, la categoria, lo stato di pubblicazione o l'ordine manuale di una FAQ. | faqs:write |
faq_widget_settings_get | Ottiene le impostazioni di aspetto e comportamento del widget FAQ embedabile (colori, border radius, titolo, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, traduzioni titolo). | chatbots:read |
faq_widget_settings_update | Aggiorna le impostazioni del widget FAQ: colori (hex), borderRadius 0-32, titolo (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = full width), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name e traduzioni titolo per lingua. | chatbots:write |
Cronologia Chat & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Segna una chat come revisionata senza valutarla (la rimuove dalla coda pending, non cambia lo score di fiducia). | chats:write |
chat_feedback_get | Ottiene una review di chat (feedback) con analisi AI, severità, categoria di confidenza, variazione di punteggio e la sessione di miglioramento collegata. | chats:read |
chat_feedback_list | Elenca le review di chat (righe di feedback) di un chatbot con filtro per stato e conteggi. | chats:read |
chat_feedback_set_severity | Sovrascrive la classificazione di severità (MINOR|MODERATE|MAJOR|CRITICAL) di una chat negativa revisionata; la severità pesa la diminuzione dello score di fiducia. | chats:write |
chat_feedback_stats | Conteggi di sessione per bucket di review di un chatbot (total, none, pending, positive, negative, reviewed, improved) — le card statistiche della pagina chats della dashboard. | chats:read |
chat_feedback_submit | Valuta una sessione chat come Good (isPositive=true) o Needs Work (isPositive=false). | chats:write |
chat_session_get | Ottiene una sessione chat con la trascrizione completa (per-messaggio token/model/latency/pageUrl), dettagli visitatore, URL della pagina di avvio, categoria di confidenza, feedback (severità, analisi AI, sessione di miglioramento collegata) e tag. | chats:read |
chat_session_search | Cerca sessioni chat di un chatbot per contenuto del messaggio e/o email del visitatore. | chats:read |
chat_session_set_category | Assegna o cambia la categoria di confidenza di una sessione chat (corregge la categorizzazione AI; la confidenza per categoria viene ricalcolata quando la chat è stata revisionata). | chats:write |
chat_sessions_list | Elenca le sessioni chat di un chatbot, dalla più recente, con gli stessi filtri della coda di revisione della pagina chats della dashboard. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Elenca le categorie di confidenza di un chatbot con punteggio per categoria, conteggio review e frequenza email di review. | chats:read |
confidence_category_create | Crea una categoria di confidenza per un chatbot. | chatbots:write |
confidence_category_delete | Elimina una categoria di confidenza. | chatbots:write |
confidence_category_merge | Unisce una categoria di confidenza in un'altra dello stesso chatbot: tutte le chat/review vengono spostate sul target, la fonte viene eliminata e i punteggi ricalcolati. | chatbots:write |
confidence_category_update | Rinomina una categoria di confidenza e/o imposta la sua frequenza di email di review (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 solo per HOURLY). | chatbots:write |
confidence_status_get | Stato di confidenza di un chatbot: score, soglia di graduazione, flag learning phase, comportamento learning-phase (CAUTIOUS|BALANCED|CONFIDENT) e prompt personalizzato, conteggi di review e punteggi per categoria. | analytics:read |
improvement_proposal_approve | Approva una proposta di miglioramento PENDING e applica la modifica al chatbot (aggiunta/aggiornamento core instruction, creazione/aggiornamento FAQ o aggiornamento persona) — stessa logica e limiti di piano della dashboard. | chatbots:write |
improvement_proposal_reject | Respinge una proposta di miglioramento PENDING. | chatbots:write |
improvement_proposal_simulate | Simula come il chatbot risponderebbe al messaggio problematico con una proposta applicata (originale vs. | chatbots:write |
improvement_proposals_pending | Elenca le proposte di miglioramento in attesa di revisione (stato PENDING) per l'azienda o per un singolo chatbot. | chatbots:read |
improvement_session_complete | Marca una sessione di miglioramento come COMPLETED (la chat viene quindi conteggiata come Improved nella coda di revisione). | chatbots:write |
improvement_session_create | Apre l'Improvement Agent per una chat valutata Needs Work. | chatbots:write |
improvement_session_get | Ottiene una sessione di miglioramento con la chat originale (i messaggi hanno un indice 1-based utilizzabile come targetMessageIndex), la conversazione dell'agente, tutte le proposte (con la loro ultima simulazione) e le simulazioni. | chatbots:read |
improvement_session_reset | Riavvia una sessione di miglioramento: elimina tutti i messaggi dell'agente, le simulazioni e le proposte PENDING/REJECTED (quelle applicate vengono mantenute) e avvia una nuova conversazione. | chatbots:write |
improvement_session_send_message | Invia un messaggio all'Improvement Agent (descriva cosa non andava nella risposta del bot; opzionalmente targetMessageIndex = indice 1-based del messaggio del bot in originalChat.messages). | chatbots:write |
improvement_sessions_list | Elenca le sessioni di miglioramento (conversazioni Improvement Agent avviate da recensioni negative) per un chatbot o per l'intera company, dal più recente, con conteggi proposte. | chatbots:read |
improvement_simulation_assess | Valuta un risultato di simulazione: isApproved=true quando la risposta simulata è buona (la proposta può quindi essere applicata), false quando necessita di ulteriori lavori (comment 'almost' = quasi corretta). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Ottiene la propria disponibilità per la live chat, gli agenti attualmente disponibili per la live chat (fresh heartbeat, lo stesso segnale usato dal widget) e se il piano della company include la live chat. | chats:read |
live_chat_heartbeat | Aggiorna il heartbeat di presenza live chat dell'utente corrente (solo mentre segnato disponibile tramite live_chat_set_availability). | chats:write |
live_chat_message_send | Invia un messaggio al visitatore come agente assegnato. | chats:write |
live_chat_queue | Ottiene la coda della live chat: sessioni in attesa di un agente, dalla più vecchia (FIFO). | chats:read |
live_chat_session_assign | Prende una sessione live chat in stato WAITING dalla coda: la assegna all'utente corrente (company owner per le API key) e notifica il visitatore che l'agente si è unito. | chats:write |
live_chat_session_close | Termina una sessione live chat come agente (qualsiasi membro non-VIEWER della company). | chats:write |
live_chat_session_get | Ottiene una sessione live chat con info del visitatore, agente assegnato, tutti i messaggi e la conversazione bot precedente (handoff context). | chats:read |
live_chat_sessions_list | Elenca le sessioni live chat (dalla più recente; le sessioni WAITING dalla più vecchia) con filtri opzionali per chatbot, stato e agente assegnato. | chats:read |
live_chat_set_availability | Attiva/disattiva lo switch 'Available for Live Chat' dell'utente corrente per una company. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Assegna un lead a un membro della company o lo rimuove dall'assegnazione (assignedToId: null). | leads:write |
lead_bulk_update_status | Imposta lo status di diversi lead (max 100) in una sola volta. | leads:write |
lead_categories_list | Elenca le categorie di lead di un chatbot con conteggi lead e i membri del team notificati per categoria. | leads:read |
lead_category_assign_user | Aggiunge un membro della company alla lista notifiche di una categoria lead (o aggiorna le loro flag di notifica). | leads:write |
lead_category_create | Crea una categoria lead per un chatbot. | leads:write |
lead_category_delete | Elimina una categoria lead. | leads:write |
lead_category_remove_user | Rimuove un membro della company dalla lista notifiche di una categoria lead. | leads:write |
lead_category_update | Aggiorna il nome, la descrizione e/o il colore di una categoria lead. | leads:write |
lead_create | Crea manualmente un lead (es. | leads:write |
lead_delete | Elimina permanentemente un lead. | leads:write |
lead_field_config_get | Ottiene la configurazione di acquisizione lead di un chatbot: campi (ids mappano a chiavi in lead.data), messaggio di conferma, traduzioni campo/UI e impostazioni di riconoscimento AI. | leads:read |
lead_field_config_update | Aggiorna la configurazione di acquisizione lead di un chatbot. | leads:write |
lead_get | Ottiene i dettagli completi di un lead inclusi assegnatario, categoria e la trascrizione della chat sorgente (paginata con messageOffset/messageLimit, default prime 20 messages). | leads:read |
lead_list | Elenca i lead di un chatbot (dal più recente) con filtri opzionali per status, categoria, assegnatario e ricerca testo libero (nome/email/azienda). | leads:read |
lead_stats | Ottiene statistiche lead per un chatbot: conteggi per status, lead degli ultimi 7 giorni e tasso di conversione (percentuale). | leads:read |
lead_update | Aggiorna lo status, la categoria, le note, i dati raccolti e/o l'assegnatario di un lead. | leads:write |
Moduli
| Tool | Description | Scope |
|---|---|---|
form_create | Crea un contact form per un chatbot (basics, fields, design e impostazioni anti-spam in una sola chiamata). | forms:write |
form_delete | Elimina permanentemente un contact form e TUTTE le sue submission (cascade). | forms:write |
form_get | Ottiene un contact form in completo: campi, traduzioni, styling, impostazioni anti-spam, stato attivo, conteggio submission e lo script di embed (embedCode). | forms:read |
form_list | Elenca i contact form di un chatbot con conteggi campi, conteggi submission e embed codes. | forms:read |
form_stats | Conteggi submission di un contact form: total, pending, approved, spam e rejected. | forms:read |
form_submission_delete | Elimina permanentemente una submission di un contact form (es. | forms:write |
form_submission_get | Ottiene una submission di un contact form in completo: dati dei campi inviati, spam score e analisi spam AI, metadata IP/user agent/referrer e informazioni di review. | forms:read |
form_submission_update_status | Revisiona una submission di contact form: imposta il suo status su APPROVED, SPAM o REJECTED con una nota di review opzionale. | forms:write |
form_submissions_list | Elenca le submission di un contact form, dalla più recente, opzionalmente filtrate per status (PENDING, APPROVED, SPAM, REJECTED) e data di creazione. | forms:read |
form_update | Aggiorna un contact form: nome, descrizione, stato attivo (isActive controlla se l'embed viene renderizzato), campi (replace completo), design (colori, testo bottone, messaggio di successo) e impostazioni anti-spam (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Sostituisce le traduzioni dei campi e/o dell'UI di un contact form. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Elenca il log di attività delle email processate di una connessione mailbox (dal più recente): mittente, oggetto, categoria assegnata, outcome (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) e outcomeDetail. | email:read |
email_categories_list | Elenca le categorie email di una connessione mailbox (ordinate per sortOrder). | email:read |
email_category_create | Crea una categoria email per una connessione mailbox (max 20 per connection). | email:write |
email_category_delete | Elimina una categoria email. | email:write |
email_category_update | Aggiorna una categoria email (parziale: solo i campi forniti cambiano). | email:write |
email_connection_disconnect | Disconnette permanentemente una mailbox. | email:write |
email_connection_get | Ottiene una connessione mailbox incl. | email:read |
email_connection_update | Aggiorna una connessione mailbox: mette in pausa/riavvia la sincronizzazione (paused true/false; toggla solo ACTIVE<->DISABLED, non sovrascrive mai TOKEN_EXPIRED/ERROR), abilita/disabilita drafting delle risposte (draftingEnabled) e categorizzazione/organizzazione (organizingEnabled), ripunta il chatbot che la alimenta (chatbotId della stessa company) o imposta la signature HTML della reply (signatureHtml, max 20000 caratteri; stringa vuota la cancella). | email:write |
email_connections_list | Elenca le connessioni mailbox dell'Email Assistant della company (address, stato ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, ultimo sync, ultimo errore, toggle drafting/organizing, chatbot che alimenta, draftReadyCategoryCount = categorie che possono generare bozze, baseRuleCount = 'Chat + Email' rule a livello chatbot applicate a ogni bozza) insieme ai limiti del piano (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Elimina un contatto email appreso (dimentica il profilo del mittente, es. | email:write |
email_contact_get | Ottiene un contatto email appreso con tutti i fatti appresi, note interne, relazione, impostazione formal/informal address e statistiche email. | email:read |
email_contact_update | Aggiorna un contatto email appreso. | email:write |
email_contacts_list | Elenca i contatti email appresi della company (email più recente prima) con relazione, formal/informal address (formalAddress: true = forma formale 'Sie', false = informale 'Du', null = automatico), conteggio fatti e anteprima note. | email:read |
email_folder_create | Crea una cartella mail sotto la inbox (restituisce quella esistente se il nome è già preso) da usare come target di spostamento categoria. | email:write |
email_folders_list | Elenca le cartelle in cui una categoria email può spostare la posta, live dalla mailbox: sottocartelle inbox, cartelle top-level personalizzate, archive, junk e trash (id 'deleteditems'). | email:read |
email_general_rules_list | Elenca le regole a livello chatbot che si applicano a ogni bozza di risposta di una mailbox: core instructions attive con channel BOTH ("Chat + Email"), più quelle legacy solo email non ancora migrate in una categoria. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volume chat (sessioni avviate) nel tempo per grafici e trend: periodo week/month/quarter/year, granularità hour/day/week/month, opzionalmente per un chatbot. | analytics:read |
analytics_chatbot_stats | Performance per chatbot di una company in una singola chiamata (la tabella performance chatbot della dashboard): id, name, slug, isActive, sessions, messages, FAQs e leads per chatbot, ordinati per sessions. | analytics:read |
analytics_forms | Statistiche submission contact form per una company o un chatbot (widget analytics della dashboard): submission per status (pending/approved/rejected/spam), numero di form, totale, tasso spam in percentuale e la serie submissions-per-day degli ultimi 7 giorni. | analytics:read |
analytics_leads | Funnel lead per una company o un chatbot (widget analytics della dashboard): lead per status (new/contacted/qualified/converted/lost), totale, tasso di conversione in percentuale e la serie leads-per-day degli ultimi 7 giorni. | analytics:read |
analytics_overview | Panoramica analytics per una company o un chatbot: chats, messages, satisfaction rate e top questions per un periodo rolling (day/week/month/year), più il widget overview della dashboard (total chatbots/published FAQs/leads, sessions today/this week/this month, leads today/this week, form submissions total/today/pending). | analytics:read |
dashboard_activity | Cosa richiede attenzione attualmente (vista home della dashboard): per company, i chatbot con nuovi lead oggi, suggestion FAQ pendenti, submission form pendenti, live chat waiting/active o una learning phase in corso. | any |
Esempi di workflow
Aggiungere una core instruction
Chieda al suo assistente AI:
"Aggiungi una core instruction al mio chatbot 'Support Bot': offriamo spedizione gratuita per ordini superiori a €50"
L'assistente userà chatbot_add_instruction con i parametri appropriati.
Revisionare suggerimenti di miglioramento
"Mostrami tutte le proposte di miglioramento pendenti per il mio chatbot e spiegami quali cambiamenti suggeriscono"
L'assistente:
- Userà
improvement_proposals_pendingper recuperare le proposte - Analizzerà e riassumerà ogni suggerimento
- Legherà o respingerà a sua nome con
improvement_proposal_approveoimprovement_proposal_reject
Analizzare le performance delle chat
"Dammi un report settimanale del volume di chat e della soddisfazione clienti per il mio chatbot"
L'assistente userà analytics_overview e analytics_chat_volume per compilare un report completo.
Importare un sito web
"Scansiona https://example.com, importa le pagine prodotto e pricing nel mio 'Support Bot' e avvisami quando il crawl è terminato"
L'assistente chiamerà crawler_preview_scan, selezionerà le pagine rilevanti, avvierà l'import con crawler_start e pollerà crawler_job_get finché il job non sarà terminato.
Revisionare lead e submission dei form
"Mostrami i nuovi lead di questa settimana, assegna quelli qualificati ad Anna e approva le submission del contact form pendenti"
L'assistente combinerà lead_list, lead_assign, form_submissions_list e form_submission_update_status.
Prendere in carico una live chat
"Impostami disponibile per la live chat e prendi la conversazione in attesa più vecchia"
L'assistente usa live_chat_set_availability, live_chat_queue e live_chat_session_assign; le risposte passano tramite live_chat_message_send.
Sicurezza
- Le API key sono limitate alla sua company e ai permessi che seleziona durante la creazione (vedi la colonna Scope sopra)
- Le chiavi vengono eseguite con i permessi del proprietario della company; i limiti di piano e le feature gate si applicano esattamente come nella dashboard
- Le chiavi possono essere revocate in qualsiasi momento dalla dashboard
- L'accesso API è disponibile nei piani a pagamento — veda la nostra pagina Pricing
Risoluzione dei problemi
Connessione fallita
- Verifichi che la sua API key sia corretta
- Controlli che la chiave non sia stata revocata
- Assicuri che il suo piano includa l'accesso API
- Riavvii il suo client MCP
Strumento non trovato
Riavvii il suo client MCP dopo aver modificato la configurazione in modo che ricarichi gli strumenti disponibili. I nomi degli strumenti sono in lowercase con underscore (es., faq_list).
Serve aiuto? Contatti il nostro team di supporto →