HomeDocumentazione

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

  1. Navighi su Dashboard → Azienda → API tab
  2. Clicchi Crea chiave API
  3. Assegni alla chiave un nome descrittivo (es.: "Claude Desktop") e selezioni almeno un permesso
  4. 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

ToolDescriptionScope
account_usage_getOttiene 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_companiesElenca tutte le company a cui l'utente corrente ha accesso, con il ruolo dell'utente in ciascuna.any
user_notification_mark_readSegna come letta una delle notifiche dell'utente corrente.any
user_notification_preferences_getOttiene 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_updateAggiorna le preferenze di notifica globali dell'utente corrente (toggle email/push, programma digest, quiet hours).any
user_notification_type_setting_updateAbilita o disabilita la consegna via email / in-app per un singolo tipo di notifica dell'utente corrente (es.any
user_notification_types_listElenca tutti i tipi di notifica raggruppati per categoria (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countOttiene il numero di notifiche non lette dell'utente corrente.any
user_notificationsElenca le notifiche dell'utente corrente, dalla più recente, con paginazione cursor.any
user_notifications_delete_oldManutenzione: elimina permanentemente le notifiche dell'utente corrente già lette e più vecchie di 30 giorni.any
user_notifications_mark_all_readSegna come lette tutte le notifiche dell'utente corrente.any
user_profileOttiene il profilo dell'utente corrente (id, name, email, role, subscription tier).any

Company & Team

ToolDescriptionScope
company_chatbots_listElenca tutti i chatbot di una specifica company con statistiche di riepilogo.chatbots:read
company_getOttiene informazioni dettagliate su una company: profilo, owner, impostazioni brand (colori, notification email) e conteggi.any
company_invite_cancelAnnulla (elimina) un invito al team in modo che il link non funzioni più.company:write
company_invite_resendReinvia 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_listElenca gli inviti al team di una company (pendenti per default; impostando includeExpired restituisce anche quelli scaduti).company:read
company_listElenca tutte le company a cui l'utente ha accesso (API key e Dashboard Assistant vedono solo la propria company).any
company_logo_removeRimuove il logo della company (elimina l'immagine memorizzata e cancella l'URL del logo).company:write
company_member_inviteInvita un membro del team via email con un ruolo (ADMIN, MANAGER, AGENT o VIEWER).company:write
company_member_removeRimuove un membro del team dalla company.company:write
company_member_update_roleCambia il ruolo di un membro del team (ADMIN, MANAGER, AGENT o VIEWER).company:write
company_members_listElenca i membri di una company con i loro ruoli (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAggiorna le impostazioni del brand della company: primaryColor / secondaryColor (#RRGGBB) e notificationEmail per le revisioni chat.company:write
company_updateAggiorna 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

ToolDescriptionScope
chatbot_add_instructionAggiunge una nuova core instruction a un chatbot (1-5000 caratteri).chatbots:write
chatbot_confirm_embedSegna un chatbot come embedded sul sito (nasconde il promemoria di setup nella dashboard).chatbots:write
chatbot_createCrea un nuovo chatbot (come il wizard della dashboard).chatbots:write
chatbot_deleteElimina definitivamente un chatbot con tutte le sue FAQ, documenti, chat, lead e moduli (non può essere annullato).chatbots:write
chatbot_delete_instructionElimina una core instruction da un chatbot.chatbots:write
chatbot_getOttiene 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_codeOttiene 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_instructionsOttiene tutte le core instructions di un chatbot.chatbots:read
chatbot_improve_instructionsRiscrive il testo di una core instruction con l'AI della piattaforma (come "Improve with AI" della dashboard).chatbots:write
chatbot_learning_phase_getOttiene 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_updateImposta 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_listElenca tutti i chatbot a cui l'utente ha accesso, con statistiche di riepilogo.chatbots:read
chatbot_reorder_instructionsImposta l'ordine delle core instructions di un chatbot.chatbots:write
chatbot_templates_listElenca 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_activeAttiva o disattiva un chatbot.chatbots:write
chatbot_toggle_learningTermina (false) o riabilita (true) la learning phase di un chatbot.chatbots:write
chatbot_updateAggiorna 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_instructionAggiorna una core instruction esistente (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAggiorna 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_getOttiene 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_updateAggiorna il chat widget di un chatbot: posizione (incl.chatbots:write
widget_translations_getOttiene le traduzioni per lingua del widget di un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateImposta le traduzioni del widget per lingua.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelAnnulla un job di crawl PENDING o RUNNING; le pagine rimanenti vengono saltate.knowledge:write
crawler_job_getOttiene lo stato di un job di crawl, il progresso (pagesCrawled/pagesFound, tokensUsed) e lo stato di ogni pagina.knowledge:read
crawler_jobs_listElenca i job di crawl di un chatbot (dal più recente) con stato e progresso.knowledge:read
crawler_limitsOttiene 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_scanScansiona un sito web e elenca le sue pagine crawlable (url, title, isRecommended) senza importare nulla.knowledge:write
crawler_startAvvia 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_urlScarica 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_textAggiunge un documento di testo o markdown alla knowledge base di un chatbot da contenuto inline (max 10 MB).knowledge:write
knowledge_document_deleteElimina un documento caricato dalla knowledge base.knowledge:write
knowledge_document_getOttiene 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_listElenca i documenti caricati (PDF, TXT, MD, CSV, JSON, DOCX) nella knowledge base di un chatbot con stato e dimensione.knowledge:read
knowledge_page_addEsegue 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_deleteElimina una pagina scansionata dalla knowledge base (rimuove il file vector-store).knowledge:write
knowledge_page_getOttiene 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_recrawlRecupera nuovamente una pagina scansionata e ne sostituisce il contenuto indicizzato (es.knowledge:write
knowledge_pages_deleteElimina diverse pagine scansionate di un chatbot in una sola volta.knowledge:write
knowledge_pages_listElenca le pagine scansionate nella knowledge base di un chatbot, opzionalmente filtrate per dominio, stato o termine di ricerca (URL/title).knowledge:read
knowledge_statsPanoramica 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_deleteElimina tutte le pagine scansionate di un sito (dominio) dalla knowledge base del chatbot.knowledge:write
knowledge_website_recrawlRiesegue il crawl di tutte le pagine di un sito (dominio) nella knowledge base del chatbot per aggiornare il contenuto.knowledge:write
knowledge_website_recrawl_cancelAnnulla 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_listElenca 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.

ToolDescriptionScope
price_listPagine attraverso price heads e separa l'idoneità alla versione approvata.prices:read
price_getLegge lo stato completo dell'item e le revisioni.prices:read
price_detailLegge il dettaglio dell'item con storico revisioni paginato.prices:read
price_suggestions_listPagine attraverso price suggestions.prices:read
price_createCrea una bozza con un ID item generato dal server.prices:write
price_editCrea una nuova bozza da una versione item esplicitamente attesa.prices:write
price_import_csvImporta bozze con un formato esplicito e un import ID stabile per retry sicuri.prices:write
price_suggestion_applyApplica la suggestion candidate selezionata come bozza.prices:write
price_approveApprova una versione item esplicitamente attesa.prices:approve
price_approve_manyApprova una selezione ID/versione esplicita in modo atomico; qualsiasi versione stale respinge l'intera selezione.prices:approve
price_archiveArchivia 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

ToolDescriptionScope
faq_cache_purgePulisce i dati cache del widget FAQ su tutti i siti CMS connessi (plugin WordPress).faqs:write
faq_categories_listElenca le categorie FAQ di un chatbot con i conteggi FAQ, slug, modalità di ordinamento e traduzioni.faqs:read
faq_categories_reorderImposta l'ordine delle categorie FAQ nel widget: la posizione in categoryIds diventa sortOrder.faqs:write
faq_category_createCrea una categoria FAQ per un chatbot (lo slug viene generato dal nome).faqs:write
faq_category_deleteElimina una categoria FAQ.faqs:write
faq_category_translations_updateSostituisce le traduzioni di una categoria FAQ, es.faqs:write
faq_category_updateRinomina una categoria FAQ o ne modifica la descrizione, l'icona o la modalità di ordinamento.faqs:write
faq_createCrea una FAQ per un chatbot.faqs:write
faq_deleteElimina definitivamente una FAQ (la rimuove anche dalla knowledge base del chatbot e svuota le cache dei widget CMS).faqs:write
faq_embed_code_getOttiene 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_getOttiene i dettagli completi di una FAQ: domanda, risposta, categoria, stato di pubblicazione, ordine, traduzioni, campi SEO e statistiche di feedback.faqs:read
faq_listElenca le FAQ di un chatbot (usare chatbot_list per trovare chatbotId).faqs:read
faq_reorderImposta l'ordine di visualizzazione delle FAQ nel widget.faqs:write
faq_suggestion_approveApprova una suggestion FAQ PENDING: crea una FAQ pubblicata (opzionalmente con domanda/risposta/categoria modificata) e segna la suggestion come APPROVED.faqs:write
faq_suggestion_getOttiene i dettagli completi di una suggestion FAQ (risposta completa, ragionamento AI, categoria suggerita, stato di revisione).faqs:read
faq_suggestion_rejectRespinge una suggestion FAQ PENDING con motivo opzionale.faqs:write
faq_suggestions_generatePermette all'AI di proporre nuove FAQ dalla knowledge base del chatbot (pagine scansionate / documenti caricati), opzionalmente per una sola categoria.faqs:write
faq_suggestions_listElenca le suggestion FAQ generate dall'AI di un chatbot (da conversazioni chat o faq_suggestions_generate).faqs:read
faq_translateTraduce 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_updateSalva le traduzioni di una FAQ per lingua, es.faqs:write
faq_updateAggiorna la domanda, la risposta, la categoria, lo stato di pubblicazione o l'ordine manuale di una FAQ.faqs:write
faq_widget_settings_getOttiene 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_updateAggiorna 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

ToolDescriptionScope
chat_feedback_dismissSegna una chat come revisionata senza valutarla (la rimuove dalla coda pending, non cambia lo score di fiducia).chats:write
chat_feedback_getOttiene 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_listElenca le review di chat (righe di feedback) di un chatbot con filtro per stato e conteggi.chats:read
chat_feedback_set_severitySovrascrive 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_statsConteggi 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_submitValuta una sessione chat come Good (isPositive=true) o Needs Work (isPositive=false).chats:write
chat_session_getOttiene 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_searchCerca sessioni chat di un chatbot per contenuto del messaggio e/o email del visitatore.chats:read
chat_session_set_categoryAssegna 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_listElenca 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

ToolDescriptionScope
confidence_categories_listElenca le categorie di confidenza di un chatbot con punteggio per categoria, conteggio review e frequenza email di review.chats:read
confidence_category_createCrea una categoria di confidenza per un chatbot.chatbots:write
confidence_category_deleteElimina una categoria di confidenza.chatbots:write
confidence_category_mergeUnisce 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_updateRinomina 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_getStato 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_approveApprova 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_rejectRespinge una proposta di miglioramento PENDING.chatbots:write
improvement_proposal_simulateSimula come il chatbot risponderebbe al messaggio problematico con una proposta applicata (originale vs.chatbots:write
improvement_proposals_pendingElenca le proposte di miglioramento in attesa di revisione (stato PENDING) per l'azienda o per un singolo chatbot.chatbots:read
improvement_session_completeMarca una sessione di miglioramento come COMPLETED (la chat viene quindi conteggiata come Improved nella coda di revisione).chatbots:write
improvement_session_createApre l'Improvement Agent per una chat valutata Needs Work.chatbots:write
improvement_session_getOttiene 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_resetRiavvia 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_messageInvia 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_listElenca 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_assessValuta 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

ToolDescriptionScope
live_chat_agents_availableOttiene 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_heartbeatAggiorna il heartbeat di presenza live chat dell'utente corrente (solo mentre segnato disponibile tramite live_chat_set_availability).chats:write
live_chat_message_sendInvia un messaggio al visitatore come agente assegnato.chats:write
live_chat_queueOttiene la coda della live chat: sessioni in attesa di un agente, dalla più vecchia (FIFO).chats:read
live_chat_session_assignPrende 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_closeTermina una sessione live chat come agente (qualsiasi membro non-VIEWER della company).chats:write
live_chat_session_getOttiene 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_listElenca 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_availabilityAttiva/disattiva lo switch 'Available for Live Chat' dell'utente corrente per una company.chats:write

Leads

ToolDescriptionScope
lead_assignAssegna un lead a un membro della company o lo rimuove dall'assegnazione (assignedToId: null).leads:write
lead_bulk_update_statusImposta lo status di diversi lead (max 100) in una sola volta.leads:write
lead_categories_listElenca le categorie di lead di un chatbot con conteggi lead e i membri del team notificati per categoria.leads:read
lead_category_assign_userAggiunge un membro della company alla lista notifiche di una categoria lead (o aggiorna le loro flag di notifica).leads:write
lead_category_createCrea una categoria lead per un chatbot.leads:write
lead_category_deleteElimina una categoria lead.leads:write
lead_category_remove_userRimuove un membro della company dalla lista notifiche di una categoria lead.leads:write
lead_category_updateAggiorna il nome, la descrizione e/o il colore di una categoria lead.leads:write
lead_createCrea manualmente un lead (es.leads:write
lead_deleteElimina permanentemente un lead.leads:write
lead_field_config_getOttiene 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_updateAggiorna la configurazione di acquisizione lead di un chatbot.leads:write
lead_getOttiene 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_listElenca 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_statsOttiene statistiche lead per un chatbot: conteggi per status, lead degli ultimi 7 giorni e tasso di conversione (percentuale).leads:read
lead_updateAggiorna lo status, la categoria, le note, i dati raccolti e/o l'assegnatario di un lead.leads:write

Moduli

ToolDescriptionScope
form_createCrea un contact form per un chatbot (basics, fields, design e impostazioni anti-spam in una sola chiamata).forms:write
form_deleteElimina permanentemente un contact form e TUTTE le sue submission (cascade).forms:write
form_getOttiene un contact form in completo: campi, traduzioni, styling, impostazioni anti-spam, stato attivo, conteggio submission e lo script di embed (embedCode).forms:read
form_listElenca i contact form di un chatbot con conteggi campi, conteggi submission e embed codes.forms:read
form_statsConteggi submission di un contact form: total, pending, approved, spam e rejected.forms:read
form_submission_deleteElimina permanentemente una submission di un contact form (es.forms:write
form_submission_getOttiene 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_statusRevisiona una submission di contact form: imposta il suo status su APPROVED, SPAM o REJECTED con una nota di review opzionale.forms:write
form_submissions_listElenca le submission di un contact form, dalla più recente, opzionalmente filtrate per status (PENDING, APPROVED, SPAM, REJECTED) e data di creazione.forms:read
form_updateAggiorna 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_translationsSostituisce le traduzioni dei campi e/o dell'UI di un contact form.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listElenca 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_listElenca le categorie email di una connessione mailbox (ordinate per sortOrder).email:read
email_category_createCrea una categoria email per una connessione mailbox (max 20 per connection).email:write
email_category_deleteElimina una categoria email.email:write
email_category_updateAggiorna una categoria email (parziale: solo i campi forniti cambiano).email:write
email_connection_disconnectDisconnette permanentemente una mailbox.email:write
email_connection_getOttiene una connessione mailbox incl.email:read
email_connection_updateAggiorna 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_listElenca 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_deleteElimina un contatto email appreso (dimentica il profilo del mittente, es.email:write
email_contact_getOttiene un contatto email appreso con tutti i fatti appresi, note interne, relazione, impostazione formal/informal address e statistiche email.email:read
email_contact_updateAggiorna un contatto email appreso.email:write
email_contacts_listElenca 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_createCrea 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_listElenca 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_listElenca 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

ToolDescriptionScope
analytics_chat_volumeVolume 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_statsPerformance 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_formsStatistiche 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_leadsFunnel 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_overviewPanoramica 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_activityCosa 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:

  1. Userà improvement_proposals_pending per recuperare le proposte
  2. Analizzerà e riassumerà ogni suggerimento
  3. Legherà o respingerà a sua nome con improvement_proposal_approve o improvement_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

  1. Verifichi che la sua API key sia corretta
  2. Controlli che la chiave non sia stata revocata
  3. Assicuri che il suo piano includa l'accesso API
  4. 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 →