MCP Server Integration
ChatReact toteuttaa Model Context Protocol (MCP) -protokollan, jonka avulla voit yhdistää ChatReact-tilisi AI-avustimiin kuten Claude Desktop, Cursor ja muihin MCP-yhteensopiviin työkaluihin.
Mikä on MCP?
Model Context Protocol on avoin standardi, joka mahdollistaa AI-avustimien vuorovaikutuksen ulkoisten palveluiden ja tietolähteiden kanssa. ChatReactin MCP-integraation avulla voit:
- Hallinnoida chatboteja — luoda, konfiguroida (persoonallisuus, kielet, widget, käyttäytyminen, rajoitukset), upottaa ja poistaa chatboteja
- Rakentaa tietopohjaa — lisätä dokumentteja, indeksoida verkkosivuja, hallita indeksoituja sivuja ja core-instruktioita
- Hallinnoida UKK:ia — usein kysytyt kysymykset, kategoriat, ehdotukset, käännökset ja FAQ-widget
- Arvioida keskusteluja — arvioida keskusteluja, asettaa luottamusluokkia, ajaa Improvement Agent -toimintoa
- Käsitellä liidejä ja lomakkeita — liidit, liidikategoriat, kaappaussäädöt, yhteydenottolomakkeet ja lähetykset
- Toimia live-chat-agenttina — asettaa saatavuus, ottaa odottavia keskusteluja haltuun, vastata ja sulkea sessioita
- Hallinnoida yritystäsi — profiili, brändivärit, tiimin jäsenet ja kutsut
- Käyttää Email Assistantia — postilaatikon yhteydet, kategoriat, kontaktit ja aktiviteetti
- Lukea analytiikkaa ja ilmoituksia
Kaiken, mitä voit tehdä hallintapaneelissa, on saatavilla MCP:n kautta (ja REST API:n); vain selaimeen sidotut toiminnot kuten maksut, postilaatikon OAuth, passkeys, tilin poisto ja API-avainten hallinta pysyvät hallintapaneelissa.
Aloittaminen
1. Generoi API-avain
- Siirry Kojelauta → Yritys → API -välilehdelle
- Klikkaa Luo API-avain
- Anna avaimellesi kuvaava nimi (esim. "Claude Desktop") ja valitse vähintään yksi oikeus
- Kopioi luotu avain (alkaa
cr_)
API-avaimet ovat saatavilla maksullisilla suunnitelmilla — katso Pricing page.
Säilytä API-avaimesi turvallisesti. Sitä ei voi noutaa luomisen jälkeen.
2. Konfiguroi MCP-asiakasohjelmasi
ChatReactin MCP-palvelin isännöidään osoitteessa https://www.chatreact.ai/api/mcp ja se kommunikoi HTTP:n (JSON-RPC) yli. Todennus tapahtuu Authorization: Bearer-otsakkeella — myös X-API-Key-otsake, jossa on sama avain, hyväksytään.
Cursor IDE
Cursor tukee etä-MCP-palvelimia suoraan. Lisää seuraavat asetukset Cursorin MCP-asetuksiin:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktopin konfiguraatiotiedosto tukee komentopohjaisia palvelimia, joten käytä vakiobridgenä mcp-remote yhdistääksesi isännöidylle päätepisteelle:
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"
]
}
}
}
Tämä asennus edellyttää Node.js:n asentamista. Esimerkissä käytetään X-API-Key-otsaketta, koska jotkin asiakkaat eivät käsittele välilyöntejä argumenteissa luotettavasti.
3. Käynnistä AI-avustimesi uudelleen
Konfiguraation tallentamisen jälkeen käynnistä Claude Desktop tai Cursor uudelleen yhteyden muodostamiseksi.
Saatavilla olevat työkalut
ChatReact MCP paljastaa alla olevat työkalut, ryhmiteltyinä alueittain. Scope-sarakkeessa näytetään API-avaimen vaatima oikeus (any = jokainen kelvollinen avain). Työkalut suoritetaan samoilla sovellettavilla oikeuksilla, suunnitelmarajoilla ja sivuvaikutuksilla kuin hallintapaneelin toiminnot. Selaimeen sidotut maksuihin, postilaatikon valtuutukseen, passkeyeihin, tilin poistoon ja avainten hallintaan liittyvät työnkulut pysyvät hallintapaneelissa.
Tuhoavat toiminnot (poista, nollaa, sulje, yhdistä) pyytävät vahvistusta käytettäessä Dashboard Assistantin kautta. API-avaimella ne suoritetaan välittömästi.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Hanki nykyinen suunnitelma (tasoluokka, tila), kuluvan laskutuskauden käyttömittarit (yritykset, chatbotit, tiimin jäsenet, keskustelut, tokenit) ja suunnitelmarajat sekä kutsutun yrityksen tehokkaat rajat ja ominaisuusliput. | any |
user_companies | Listaa kaikki yritykset, joihin nykyisellä käyttäjällä on pääsy, mukaan lukien käyttäjän rooli kussakin. | any |
user_notification_mark_read | Merkitse yksi nykyisen käyttäjän ilmoituksista luetuksi. | any |
user_notification_preferences_get | Hanki nykyisen käyttäjän ilmoitusasetukset: globaalit sähköposti/push-kytkimet, digestin tiheys/aika/viikonpäivä/aikavyöhyke, hiljaiset tunnit ja per-tyyppi-kanava-asetukset. | any |
user_notification_preferences_update | Päivitä nykyisen käyttäjän globaalit ilmoitusasetukset (sähköposti/push-kytkimet, digest-aikataulu, hiljaiset tunnit). | any |
user_notification_type_setting_update | Ota käyttöön tai poista käytöstä sähköposti / sovelluksen sisäinen toimitus yhden ilmoitustyypin osalta nykyiselle käyttäjälle (esim. | any |
user_notification_types_list | Listaa kaikki ilmoitustyypit ryhmiteltynä kategoriassa (chatbot, liidit, live chat, knowledge, tiimi, laskutus). | any |
user_notification_unread_count | Hanki nykyisen käyttäjän lukemattomien ilmoitusten määrä. | any |
user_notifications | Listaa nykyisen käyttäjän ilmoitukset uusimmasta vanhimpaan, käyttämällä cursor-paginointia. | any |
user_notifications_delete_old | Taloushallinto: poista pysyvästi nykyisen käyttäjän jo luetut ja yli 30 päivää vanhat ilmoitukset. | any |
user_notifications_mark_all_read | Merkitse kaikki nykyisen käyttäjän ilmoitukset luetuiksi. | any |
user_profile | Hanki nykyisen käyttäjän profiili (id, nimi, sähköposti, rooli, tilausvaihe). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Listaa kaikki tietyn yrityksen chatbotit yhteenvedon kanssa. | chatbots:read |
company_get | Hanki yksityiskohtaista tietoa yrityksestä: profiili, omistaja, brändiasetukset (värit, ilmoitussähköposti) ja laskurit. | any |
company_invite_cancel | Peruuta (poista) tiimikutsu, jotta linkki ei enää toimi. | company:write |
company_invite_resend | Lähetä odottava tiimikutsu uudelleen: luo uusi token, jatkaa vanhenemista 7 päivällä ja lähettää kutsun sähköpostilla uudelleen. | company:write |
company_invites_list | Listaa yrityksen tiimikutsut (oletuksena odottavat; aseta includeExpired myös vanhentuneiden palauttamiseksi). | company:read |
company_list | Listaa kaikki yritykset, joihin käyttäjällä on pääsy (API-avaimet ja Dashboard Assistant näkevät vain oman yrityksensä). | any |
company_logo_remove | Poista yrityksen logo (poistaa tallennetun kuvan ja tyhjentää logo-URLin). | company:write |
company_member_invite | Kutsu tiimin jäsen sähköpostilla roolilla (ADMIN, MANAGER, AGENT tai VIEWER). | company:write |
company_member_remove | Poista tiimin jäsen yrityksestä. | company:write |
company_member_update_role | Vaihda tiimin jäsenen rooli (ADMIN, MANAGER, AGENT tai VIEWER). | company:write |
company_members_list | Listaa yrityksen jäsenet rooleineen (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Päivitä yrityksen brändiasetuksia: primaryColor / secondaryColor (#RRGGBB) ja ilmoitussähköposti chat-arvioille. | company:write |
company_update | Päivitä yrityksen profiili: nimi (2–100 merkkiä), kuvaus (max 1000 merkkiä) tai verkkosivusto (https:// lisätään automaattisesti; lähetä tyhjä merkkijono tyhjentääksesi sivuston/kuvauksen). | company:write |
Chatbot Management
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Lisää uusi core-instructio chatbotille (1–5000 merkkiä). | chatbots:write |
chatbot_confirm_embed | Merkitse chatbot upotetuksi verkkosivustolle (piilottaa asennusmuistutuksen hallintapaneelissa). | chatbots:write |
chatbot_create | Luo uusi chatbot (sama kuin hallintapaneelin ohjattu asennus). | chatbots:write |
chatbot_delete | Poista chatbot pysyvästi kaikilla sen UKK:illa, dokumenteilla, keskusteluilla, liideillä ja lomakkeilla (ei voi peruuttaa). | chatbots:write |
chatbot_delete_instruction | Poista core-instructio chatbotista. | chatbots:write |
chatbot_get | Hanki yksityiskohtaista tietoa chatbotista: yleisasetukset, persoonallisuus (persona, sävy, kielet, rajoitukset), widget-asetukset, live chat, oppimisvaihe, upotustila ja laskurit. | chatbots:read |
chatbot_get_embed_code | Hanki HTML-koodinpätkä chatbotin asentamiseksi verkkosivulle (script-URL + <script> tag) ja tieto siitä, onko upotus vahvistettu. | chatbots:read |
chatbot_get_instructions | Hanki kaikki core-instruktiot chatbotille. | chatbots:read |
chatbot_improve_instructions | Kirjoita core-instruction uudelleen alustan AI:n avulla (sama kuin hallintapaneelin 'Improve with AI'). | chatbots:write |
chatbot_learning_phase_get | Hanki chatbotin oppimisvaiheen asetukset: käyttäytymispresetti (CAUTIOUS, BALANCED, CONFIDENT), mukautettu kehotte ja tieto siitä, onko botti vielä oppimisvaiheessa. | chatbots:read |
chatbot_learning_phase_update | Aseta oppimisvaiheen käyttäytymispresetti (CAUTIOUS = ohjaa ihmisen puoleen epävarmoissa tapauksissa, BALANCED, CONFIDENT) ja/tai mukautettu oppimisvaiheen kehotte. | chatbots:write |
chatbot_list | Listaa kaikki chatbotit, joihin käyttäjällä on pääsy, yhteenvedon kanssa. | chatbots:read |
chatbot_reorder_instructions | Aseta chatbotin core-instruktioiden järjestys. | chatbots:write |
chatbot_templates_list | Listaa chatbot-mallit (presetit persona, sävy, viestit ja widget-käyttäytyminen), jotka voidaan antaa templateId-parametrina chatbot_create-kutsulle, ja tieto siitä, voiko yrityksen suunnitelma käyttää niitä. | chatbots:read |
chatbot_toggle_active | Aktivoi tai deaktivoi chatbot. | chatbots:write |
chatbot_toggle_learning | Lopeta (false) tai ota uudelleen käyttöön (true) chatbotin oppimisvaihe. | chatbots:write |
chatbot_update | Päivitä chatbotin yleisasetuksia: nimi, kuvaus, isActive, live chat (liveChatEnabled/liveChatMode, suunnitelman ominaisuus), showBranding (white-label-suunnitelmissa), chat-arvioiden sähköpostit, FAQ-automaattigenerointi, legacy coreInstructions -teksti, oppimisvaihe (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Päivitä olemassa oleva core-instructio (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Päivitä chatbotin persoonallisuus: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality-liukusäätimet 1–5, kielet (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), viestit (welcomeMessage, fallbackMessage, proactive greeting) ja rajoitukset (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Hanki chatbotin nykyiset widget-asetukset (kaikki ulkoasu-, brändi-, käyttäytymis- ja pre-chat-lomakekentät). | chatbots:read |
widget_settings_update | Päivitä chatbotin chat-widget: position (ml. | chatbots:write |
widget_translations_get | Hanki chatbotin per-kieli widget-käännökset: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Aseta per-kieli widget-käännökset. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Peruuta PENDING- tai RUNNING-tilassa oleva indeksointityö; jäljellä olevat sivut jätetään väliin. | knowledge:write |
crawler_job_get | Hanki indeksointityön tila, eteneminen (pagesCrawled/pagesFound, tokensUsed) ja kunkin sivun tila. | knowledge:read |
crawler_jobs_list | Listaa chatbotin indeksointityöt (uusin ensin) tilan ja etenemisen kanssa. | knowledge:read |
crawler_limits | Hanki suunnitelman indeksointirajoitukset chatbotille (maks. sivuja per indeksointi, tokenit per sivu, indeksoinnit per kuukausi) ja tieto siitä, voiko uusi indeksointi aloittaa tältä kuulta. | knowledge:read |
crawler_preview_scan | Skannaa verkkosivu ja listaa indeksoitavat sivut (url, otsikko, isRecommended) ilman tuontia. | knowledge:write |
crawler_start | Aloita indeksointityö, joka tuo valitut URLit chatbotin tietopohjaan (käsitellään taustalla; pollaa crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Lataa dokumentti (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) julkisesta http(s)-URLista ja lisää se chatbotin tietopohjaan. | knowledge:write |
knowledge_document_add_text | Lisää tekstin tai markdownin sisältävä dokumentti chatbotin tietopohjaan inline-sisällöstä (max 10 MB). | knowledge:write |
knowledge_document_delete | Poista ladattu dokumentti tietopohjasta. | knowledge:write |
knowledge_document_get | Hanki tiedot ladatusta dokumentista, mukaan lukien käsittelytila, virheviesti ja lyhytikäinen lataus-URL. | knowledge:read |
knowledge_documents_list | Listaa ladatut dokumentit (PDF, TXT, MD, CSV, JSON, DOCX) chatbotin tietopohjassa tilan ja koon kanssa. | knowledge:read |
knowledge_page_add | Indeksoi yksittäinen URL ja lisää se chatbotin tietopohjaan (epäonnistuu CONFLICT-tilalla, jos URL on jo indeksoitu, FORBIDDEN-tilalla kun token-raja ylittyy). | knowledge:write |
knowledge_page_delete | Poista indeksoitu sivu tietopohjasta (poistaa sen vektorivarastotiedoston). | knowledge:write |
knowledge_page_get | Hanki indeksoitu sivu mukaan lukien markdown-sisältö, joka indeksoitiin chatbotille (hyödyllinen varmistaessa, mitä botti tietää sivusta). | knowledge:read |
knowledge_page_recrawl | Hae indeksoitu sivu uudelleen ja korvaa sen indeksoitu sisältö (esim. | knowledge:write |
knowledge_pages_delete | Poista useita indeksoituja sivuja chatbotilta kerralla. | knowledge:write |
knowledge_pages_list | Listaa indeksoidut sivut chatbotin tietopohjassa, valinnaisesti suodatettuna verkkotunnuksen, tilan tai hakusanan (URL/otsikko) mukaan. | knowledge:read |
knowledge_stats | Yleiskatsaus chatbotin tietopohjasta: dokumentit (tilan ja koon mukaan), indeksoidut sivut ja verkkosivustot (tilan mukaan), indeksointityöt, core-instruktiot jaoteltuna lähteen mukaan (manuaalinen vs. improvement agent), UKK:t, vektorivaraston tila/koko ja tallennuksen käyttö vs. | knowledge:read |
knowledge_website_delete | Poista kaikki tietyn verkkotunnuksen indeksoidut sivut chatbotin tietopohjasta. | knowledge:write |
knowledge_website_recrawl | Indeksoi uudelleen kaikki verkkotunnuksen sivut chatbotin tietopohjassa päivittääksesi niiden sisällön. | knowledge:write |
knowledge_website_recrawl_cancel | Peruuta käynnissä oleva verkkotunnuksen uudelleenindeksointi: jonossa (PENDING) olevat sivut palautetaan aiempaan indeksoituun tilaan. | knowledge:write |
knowledge_websites_list | Listaa verkkosivustot (verkkotunnukset), joiden sivut ovat chatbotin tietopohjassa, sivumäärineen tilan mukaan ja token-yhteenvetoineen. | knowledge:read |
Price Management
Nämä työkalut hallinnoivat jäsenneltyjä hintaluonnoksia ja nimenomaisia hyväksyntöjä. Luonnoksen tallentaminen on erillinen toimenpide verrattuna tietyn version hyväksymiseen; kelpoisuus riippuu myös tilasta ja voimassaolosta. Nykyiset API-avaimet eivät automaattisesti saa hinta-oikeuksia. Vain yrityksen omistaja voi myöntää prices:write tai prices:approve. API-avaimen kutsut suoritetaan suoraan, joten tarkistakaa tarkka syöte ennen mutaation kutsumista. Katso Prices & services asiakasprosessia varten.
| Tool | Description | Scope |
|---|---|---|
price_list | Sivuta hintapääotsikoita ja erillinen hyväksytyn version kelpoisuus. | prices:read |
price_get | Lue kohteen täydellinen tila ja revisiot. | prices:read |
price_detail | Lue kohteen tiedot sivutetulla revisiohistorialla. | prices:read |
price_suggestions_list | Sivuta hintaehdotuksia. | prices:read |
price_create | Luo luonnos palvelinluodulla item-id:llä. | prices:write |
price_edit | Luo uusi luonnos nimenomaisesti odotetusta item-versiosta. | prices:write |
price_import_csv | Tuo luonnoksia nimenomaisessa muodossa ja vakaalla import-id:llä turvallisia uudelleenyrittoyrityksiä varten. | prices:write |
price_suggestion_apply | Käytä valittua ehdokasta luonnoksena. | prices:write |
price_approve | Hyväksy yksi nimenomaisesti odotettu item-versio. | prices:approve |
price_approve_many | Hyväksy nimenomainen id/versiovalinta atomisesti; mikä tahansa vanhentunut versio hylkää koko valinnan. | prices:approve |
price_archive | Arkistoi item nimenomaisessa odotetussa versiossaan. | prices:approve |
Luonnosmuutokset säilyttävät aiemman hyväksytyn revision. CSV-muoto ja desimaalierotin on ilmoitettava; muuttunut CSV-sisältö vaatii uuden import-id:n. Kaikki toiminnot sidotaan API-avaimen yritykseen ja määriteltyyn chatbottiin.
FAQ Management
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Tyhjennä välimuistissa oleva FAQ-widget-data kaikilla yhdistetyillä CMS-sivustoilla (WordPress-laajennus). | faqs:write |
faq_categories_list | Listaa chatbotin FAQ-kategoriat niiden FAQ-määrien, slugien, lajittelutilan ja käännösten kanssa. | faqs:read |
faq_categories_reorder | Aseta FAQ-kategorioiden järjestys widgetissä: position kategoriIds-listassa määrittää sortOrderin. | faqs:write |
faq_category_create | Luo FAQ-kategoria chatbotille (slug generoidaan nimestä). | faqs:write |
faq_category_delete | Poista FAQ-kategoria. | faqs:write |
faq_category_translations_update | Korvaa FAQ-kategorian käännökset, esim. | faqs:write |
faq_category_update | Nimeä FAQ-kategoria uudelleen tai muuta sen kuvausta, ikonia tai lajittelutilaa. | faqs:write |
faq_create | Luo FAQ chatbotille. | faqs:write |
faq_delete | Poista FAQ pysyvästi (poistaa sen myös chatbotin tietopohjasta ja tyhjentää CMS-widget-välimuistit). | faqs:write |
faq_embed_code_get | Hanki upotuskoodit FAQ-widgetille: script-tag, WordPress-shortcode ja Shopify Liquid -snippet, sekä per-kategoria-variantit (käytä categorySlug-arvoa faq_categories_listista upottaaksesi vain yhden kategorian). | chatbots:read |
faq_get | Hanki FAQ:n täydet tiedot: kysymys, vastaus, kategoria, julkaisutila, lajittelujärjestys, käännökset, SEO-kentät ja palautetilastot. | faqs:read |
faq_list | Listaa chatbotin FAQ:t (käytä chatbot_list löytääksesi chatbotId:n). | faqs:read |
faq_reorder | Aseta FAQ:iden näyttöjärjestys widgetissä. | faqs:write |
faq_suggestion_approve | Hyväksy PENDING-tilassa oleva FAQ-ehdotus: luo julkaistu FAQ (valinnaisesti muokattu kysymys/vastaus/kategoria) ja merkitsee ehdotuksen APPROVED-tilaan. | faqs:write |
faq_suggestion_get | Hanki FAQ-ehdotuksen täydet tiedot (täydellinen vastaus, AI-perustelu, ehdotettu kategoria, tarkastustila). | faqs:read |
faq_suggestion_reject | Hylkää PENDING-tilassa oleva FAQ-ehdotus valinnaisella syyllä. | faqs:write |
faq_suggestions_generate | Anna AI:n ehdottaa uusia FAQeja chatbotin tietopohjasta (indeksoidut sivut / ladatut dokumentit), valinnaisesti yhden kategorian osalta. | faqs:write |
faq_suggestions_list | Listaa chatbotin AI-generoidut FAQ-ehdotukset (chat-keskusteluista tai faq_suggestions_generate-kutsusta). | faqs:read |
faq_translate | Käännä FAQ:n kysymys ja vastaus AI:n avulla chatbotin muille tuetuille kielille (tai annettuihin targetLanguages) ja tallenna tulos. | faqs:write |
faq_translations_update | Tallenna FAQ:n käännökset per kieli, esim. | faqs:write |
faq_update | Päivitä FAQ:n kysymys, vastaus, kategoria, julkaisutila tai manuaalinen lajittelujärjestys. | faqs:write |
faq_widget_settings_get | Hanki upotettavan FAQ-widgetin ulkoasu- ja käyttäytymisasetukset (värit, reunasäde, otsikko, välistys, maksimi leveys, allowMultipleOpen, autoOpenFirst, sort mode, otsikon käännökset). | chatbots:read |
faq_widget_settings_update | Päivitä FAQ-widgetin asetukset: värit (hex), borderRadius 0–32, otsikko (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0–2000 (0 = koko leveys), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name ja otsikon käännökset per kieli. | chatbots:write |
Chat History & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Merkitse keskustelu tarkastetuksi ilman arvostelua (poistaa sen odotusjonosta, ei muuta luottamuspisteitä). | chats:write |
chat_feedback_get | Hanki yksi keskusteluarviointi (palaute) AI-analyysin, vakavuuden, luottamusluokan, pistemuutoksen ja linkitetyn improvement-session kanssa. | chats:read |
chat_feedback_list | Listaa chatbotin keskusteluarvioinnit (palaute-rivit) tilasuodattimella ja laskureilla. | chats:read |
chat_feedback_set_severity | Ylikirjoita tarkastetun negatiivisen keskustelun vakavuusluokitus (MINOR|MODERATE|MAJOR|CRITICAL); vakavuus painottaa luottamuspisteen pudotusta. | chats:write |
chat_feedback_stats | Istuntolaskurit arvion koreittain chatbotille (total, none, pending, positive, negative, reviewed, improved) — dashboardin chats-sivun tilakortit. | chats:read |
chat_feedback_submit | Arvioi keskustelusessio Good (isPositive=true) tai Needs Work (isPositive=false). | chats:write |
chat_session_get | Hanki keskustelusessio täydellä transkriptilla (viestikohtaiset token/model/latenssi/pageUrl), vierailijatiedot, aloitussivun URL, luottamusluokka, palaute (vakavuus, AI-analyysi, linkitetty improvement-session) ja tagit. | chats:read |
chat_session_search | Etsi chatbotin keskustelusessioita viestisisällön ja/tai vierailijan sähköpostin perusteella. | chats:read |
chat_session_set_category | Aseta tai muuta keskustelusession luottamusluokkaa (korjaa AI-luokitus; per-luokka-luottamus lasketaan uudelleen kun keskustelu on tarkastettu). | chats:write |
chat_sessions_list | Listaa chatbotin keskustelusessiot, uusimmasta vanhimpaan, samoilla tarkastusjonon suodattimilla kuin dashboardin chats-sivulla. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Listaa chatbotin luottamusluokat per-luokan luottamuspisteillä, arviointimäärillä ja arvio-sähköpostin tiheydellä. | chats:read |
confidence_category_create | Luo luottamusluokka chatbotille. | chatbots:write |
confidence_category_delete | Poista luottamusluokka. | chatbots:write |
confidence_category_merge | Yhdistä yksi luottamusluokka toiseen saman chatbotin sisällä: kaikki keskustelut/arviot siirtyvät kohteeseen, lähde poistetaan ja pisteet lasketaan uudelleen. | chatbots:write |
confidence_category_update | Nimeä luottamusluokka uudelleen ja/tai aseta sen arvio-sähköpostin tiheys (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1–24 vain HOURLYlle). | chatbots:write |
confidence_status_get | Chatbotin luottamustila: pistemäärä, valmistumiskynnys, oppimisvaihelippu, oppimisvaiheen käyttäytyminen (CAUTIOUS|BALANCED|CONFIDENT) ja mukautettu kehotte, arviointimäärät ja per-luokka luottamuspisteet. | analytics:read |
improvement_proposal_approve | Hyväksy PENDING-tilassa oleva parannusehdotus ja käytä muutosta chatbotille (core-instruction lisäys/päivitys, FAQ luonti/päivitys tai persona-päivitys) — sama logiikka ja suunnitelmarajat kuin hallintapaneelissa. | chatbots:write |
improvement_proposal_reject | Hylkää PENDING-tilassa oleva parannusehdotus. | chatbots:write |
improvement_proposal_simulate | Simuloi, kuinka chatbot vastaisi ongelmalliseen viestiin ehdotus sovellettuna (alkuperäinen vs. | chatbots:write |
improvement_proposals_pending | Listaa parannusehdotukset, jotka odottavat tarkastusta (tila PENDING) yrityksen laajuisesti tai yhdelle chatbotille. | chatbots:read |
improvement_session_complete | Merkitse improvement-session COMPLETEDiksi (keskustelu lasketaan sitten Improved-tilaan tarkastusjonossa). | chatbots:write |
improvement_session_create | Avaa Improvement Agent keskustelulle, joka on arvioitu Needs Workiksi. | chatbots:write |
improvement_session_get | Hanki improvement-session tiedot alkuperäisen keskustelun kanssa (viesteillä on 1-pohjainen indeksi, jota voidaan käyttää targetMessageIndexina), agentin keskustelu, kaikki ehdotukset (niiden viimeisimmällä simuloinnilla) ja simulaatiot. | chatbots:read |
improvement_session_reset | Käynnistä improvement-session uudelleen: poistaa kaikki agentin viestit, simulaatiot ja PENDING/REJECTED-ehdotukset (sovellettuja pidetään) ja aloittaa uuden keskustelun. | chatbots:write |
improvement_session_send_message | Lähetä viesti Improvement Agentille (kuvaile mitä botin vastauksessa oli vialla; valinnaisesti targetMessageIndex = bot-viestin 1-pohjainen indeksi originalChat.messagesissa). | chatbots:write |
improvement_sessions_list | Listaa improvement-sessionit (Improvement Agent -keskustelut, jotka on aloitettu negatiivisista chat-arvioista) chatbotille tai koko yritykselle, uusimmasta vanhimpaan, ehdotusmäärien kanssa. | chatbots:read |
improvement_simulation_assess | Arvioi simulaation tulos: isApproved=true kun simuloitu vastaus on hyvä (ehdotuksen voi sitten soveltaa), false kun se tarvitsee lisää työtä (kommentti 'almost' = lähes oikein). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Hanki nykyisen käyttäjän live-chat-saatavuus, tällä hetkellä saatavilla olevat agentit live-chatiin (fresh heartbeat, sama signaali jota widget käyttää) ja tieto siitä, sisältyykö yrityksen suunnitelmaan live chat. | chats:read |
live_chat_heartbeat | Päivitä nykyisen käyttäjän live-chat-läsnäolon heartbeat (vain kun merkitty saatavaksi live_chat_set_availabilityn kautta). | chats:write |
live_chat_message_send | Lähetä viesti vierailijalle nimelläsi assigned agenttina. | chats:write |
live_chat_queue | Hanki live-chat-jonon: sessiot, jotka odottavat agenttia, vanhimmat ensin (FIFO). | chats:read |
live_chat_session_assign | Ota WAITING-tilassa oleva live-chat-sessio jonosta: nimeää sen nykyiselle käyttäjälle (yrityksen omistaja API-avaimilla) ja ilmoittaa vierailijalle, että agentti liittyi. | chats:write |
live_chat_session_close | Lopeta live-chat-sessio agenttina (mikä tahansa ei-VIEWER jäsen yrityksestä). | chats:write |
live_chat_session_get | Hanki live-chat-sessio vierailijatiedoilla, nimetyn agentin tiedoilla, kaikilla viesteillä ja aiemmalla bot-keskustelulla (handoff-konteksti). | chats:read |
live_chat_sessions_list | Listaa live-chat-sessiot (uusin ensin; WAITING-sessiot vanhimmat ensin) valinnaisilla suodattimilla chatbotin, tilan ja nimetyn agentin mukaan. | chats:read |
live_chat_set_availability | Kytke nykyisen käyttäjän 'Available for Live Chat' -kytkin yritykselle päälle/pois. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Aseta liidi yrityksen jäsenelle tai poista määritys (assignedToId: null). | leads:write |
lead_bulk_update_status | Aseta useiden liidien tila kerralla (max 100). | leads:write |
lead_categories_list | Listaa chatbotin liidikategoriat liidimäärineen ja tiimin jäsenet, jotka saavat ilmoituksia per kategoria. | leads:read |
lead_category_assign_user | Lisää yrityksen jäsen liidikategorian ilmoituslistalle (tai päivitä heidän ilmoitusliput). | leads:write |
lead_category_create | Luo liidikategoria chatbotille. | leads:write |
lead_category_delete | Poista liidikategoria. | leads:write |
lead_category_remove_user | Poista yrityksen jäsen liidikategorian ilmoituslistalta. | leads:write |
lead_category_update | Päivitä liidikategorian nimi, kuvaus ja/tai väri. | leads:write |
lead_create | Luo liidi manuaalisesti (esim. | leads:write |
lead_delete | Poista liidi pysyvästi. | leads:write |
lead_field_config_get | Hanki chatbotin liidikaappauskonfiguraatio: kentät (id:t kartoitettu lead.data-avaimiin), vahvistusviesti, kenttä/UI-käännökset ja AI-tunnistuksen asetukset. | leads:read |
lead_field_config_update | Päivitä chatbotin liidikaappauskonfiguraatio. | leads:write |
lead_get | Hanki liidin täydet tiedot mukaan lukien vastuuhenkilö, kategoria ja lähdekeskustelun transkriptio (sivutettu messageOffset/messageLimit, oletuksena ensimmäiset 20 viestiä). | leads:read |
lead_list | Listaa chatbotin liidit (uusin ensin) valinnaisilla suodattimilla tilan, kategorian, vastuuhenkilön ja vapaatekstihakun (nimi/sähköposti/yritys) mukaan. | leads:read |
lead_stats | Hanki liiditilastot chatbotille: määrät tiloittain, viimeisen 7 päivän liidit ja konversioprosentti. | leads:read |
lead_update | Päivitä liidin tila, kategoria, muistiinpanot, kaapattu data ja/tai vastuuhenkilö. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Luo yhteydenottolomake chatbotille (perusasetukset, kentät, ulkoasu ja roskapostiasetukset yhdessä kutsussa). | forms:write |
form_delete | Poista pysyvästi yhteydenottolomake ja KAIKKI sen lähetykset (cascade). | forms:write |
form_get | Hanki yhteydenottolomake täysimittaisesti: kentät, käännökset, tyylit, roskapostiasetukset, aktiivinen tila, lähetyslukumäärä ja upotus script-tag (embedCode). | forms:read |
form_list | Listaa chatbotin yhteydenottolomakkeet kenttämäärin, lähetys määrin ja upotuskoodien kanssa. | forms:read |
form_stats | Yhteydenottolomakkeen lähetyslukumäärät: yhteensä, odottaa, hyväksytty, roskaposti ja hylätty. | forms:read |
form_submission_delete | Poista pysyvästi yhteydenottolomakkeen lähetys (esim. | forms:write |
form_submission_get | Hanki yhteydenottolomakkeen lähetys täysimittaisesti: lähetetyt kenttäarvot, roskapistetiheys ja AI-roskaposti-analyysi, IP/user agent/referrer-metadata ja tarkastustiedot. | forms:read |
form_submission_update_status | Tarkasta yhteydenottolomakkeen lähetys: aseta sen tila APPROVED, SPAM tai REJECTED valinnaisella tarkastusbemerkinnällä. | forms:write |
form_submissions_list | Listaa lomakkeen lähetykset, uusimmasta vanhimpaan, valinnaisesti suodatettuna tilan (PENDING, APPROVED, SPAM, REJECTED) ja luontipäivän mukaan. | forms:read |
form_update | Päivitä yhteydenottolomake: nimi, kuvaus, aktiivinen tila (isActive kontrolloi upotuksen renderöintiä), kentät (täydellinen korvaus), ulkoasu (värit, napin teksti, onnistumisviesti) ja roskapostiasetukset (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Korvaa lomakkeen kenttä- ja/tai UI-käännökset. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Listaa postilaatikon käsitellyn sähköpostin aktiviteettiloki (uusin ensin): lähettäjä, aihe, asetettu kategoria, lopputulos (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) ja outcomeDetail. | email:read |
email_categories_list | Listaa postilaatikon sähköpostikategoriat (järjestetty sortOrderin mukaan). | email:read |
email_category_create | Luo sähköpostikategoria postilaatikon liitokselle (max 20 per liitos). | email:write |
email_category_delete | Poista sähköpostikategoria. | email:write |
email_category_update | Päivitä sähköpostikategoria (partiaali: vain annetut kentät muuttuvat). | email:write |
email_connection_disconnect | Irrota postilaatikko pysyvästi. | email:write |
email_connection_get | Hanki postilaatikon liitos mukaan lukien | email:read |
email_connection_update | Päivitä postilaatikon liitos: keskeytä/jatka synkronointi (paused true/false; vaihtaa vain ACTIVE<->DISABLED, ei koskaan korvaa TOKEN_EXPIRED/ERROR), kytke vastausluonnoksen luonnostelu (draftingEnabled) ja kategorisointi/organisointi (organizingEnabled), ohjaa voimatekijächatbot uudelleen (chatbotId samasta yrityksestä) tai aseta HTML-allekirjoitus vastauksille (signatureHtml, max 20000 merkkiä; tyhjä merkkijono poistaa sen). | email:write |
email_connections_list | Listaa yrityksen Email Assistant -postilaatikkoyhteydet (osoite, tila ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, viimeisin synkronointi, viimeisin virhe, luonnostelu/kategoria-kytkimet, voimatekijächatbot, draftReadyCategoryCount = kategoriat, jotka voivat tuottaa luonnoksia, baseRuleCount = chatbotin laajuiset 'Chat + Email' -säännöt) yhdessä suunnitelmarajojen kanssa (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Poista opittu sähköpostikontakti (unohda lähettäjän profiili, esim. | email:write |
email_contact_get | Hanki opittu sähköpostikontakti kaikkine opittujen faktojen, sisäisten muistiinpanojen, suhteiden, muodollisen/epämuodollisen puhuttelun asetuksen ja sähköpostitilastojen kanssa. | email:read |
email_contact_update | Päivitä opittu sähköpostikontakti. | email:write |
email_contacts_list | Listaa yrityksen opitut sähköpostikontaktit (uusin sähköposti ensin) suhteineen, muodollinen/epämuodollinen puhuttelu (formalAddress: true = muodollinen 'Sie', false = epämuodollinen 'Du', null = automaattinen), faktamäärä ja muistiinpanon esikatselu. | email:read |
email_folder_create | Luo mail-kansio inboxin alle (palauttaa olemassa olevan, jos nimi on varattu) käytettäväksi kategorian siirtokohteena. | email:write |
email_folders_list | Listaa kansiot, joihin sähköpostikategoria voi siirtää sähköpostia, suoraan postilaatikosta: inboxin alikansiot, mukautetut pääkansiot, arkisto, roskaposti ja roskakori (id 'deleteditems'). | email:read |
email_general_rules_list | Listaa chatbotin laajuiset säännöt, jotka koskevat jokaista postilaatikon vastausluonnosta: aktiiviset core-instruktiot kanavalla BOTH ("Chat + Email"), sekä perinteiset vain-sähköposti-säännöt, joita ei ole vielä siirretty kategorioihin. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Keskustelumäärä (aloitetut sessiot) ajan kuluessa kaavioita ja trendejä varten: period week/month/quarter/year, granularity hour/day/week/month, valinnaisesti yhdelle chatbotille. | analytics:read |
analytics_chatbot_stats | Yrityksen per-chatbot -suoritus yhdessä kutsussa (hallintapaneelin chatbot performance -taulukko): id, nimi, slug, isActive, sessions, messages, FAQs ja liidit per chatbot, järjestetty sessionsin mukaan. | analytics:read |
analytics_forms | Yhteydenottolomakkeen lähetysstatistiikat yritykselle tai yhdelle chatbotille (hallintapaneelin analytiikka-widget): lähetykset tiloittain (pending/approved/rejected/spam), lomakkeiden määrä, yhteensä, roskaprosentti ja viimeisten 7 päivän submissions-per-day -sarja. | analytics:read |
analytics_leads | Liidien suppilo yritykselle tai yhdelle chatbotille (hallintapaneelin analytiikka-widget): liidit tiloittain (new/contacted/qualified/converted/lost), yhteensä, konversioprosentti ja viimeisten 7 päivän leads-per-day -sarja. | analytics:read |
analytics_overview | Analytiikan yleiskatsaus yritykselle tai yhdelle chatbotille: keskustelut, viestit, tyytyväisyysaste ja top-kysymykset liukuvalla ajanjaksolla (day/week/month/year), plus hallintapaneelin overview-widget (yhteensä chatbotit/published FAQs/liidit, sessiot tänään/tällä viikolla/tässä kuussa, liidit tänään/tällä viikolla, lomakelähetykset yhteensä/tänään/odottaa). | analytics:read |
dashboard_activity | Mitä tällä hetkellä vaatii huomiota (hallintapaneelin kotinäkymä): per yritys, chatbotit, joilla on uusia liidejä tänään, odottavat FAQ-ehdotukset, odottavat lomakelähetykset, odottavat/aktiiviset live-chatit tai käynnissä oleva oppimisvaihe. | any |
Esimerkkityönkulut
Core-instructionin lisääminen
Pyydä AI-avustinta:
"Lisää core-instruction 'Support Bot' -chatbotiini: tarjoamme ilmaisen toimituksen yli 50 € tilauksiin"
Avustaja käyttää chatbot_add_instruction sopivilla parametreilla.
Parannusehdotusten tarkastelu
"Näytä kaikki odottavat parannusehdotukset chatbotilleni ja selitä, mitä muutoksia ne ehdottavat"
Avustaja:
- Käyttää
improvement_proposals_pendinghakeakseen ehdotukset - Analysoi ja tiivistää jokaisen ehdotuksen
- Hyväksyy tai hylkää ne puolestasi
improvement_proposal_approve- taiimprovement_proposal_reject-kutsuilla
Keskustelusuorituskyvyn analysointi
"Anna minulle viikoittainen raportti keskustelumäärästä ja asiakastyytyväisyydestä chatbotilleni"
Avustaja käyttää analytics_overview ja analytics_chat_volume kokoavan kattavan raportin.
Verkkosivun tuominen
"Skannaa https://example.com, tuo tuotet ja hinnastot sivut 'Support Bot' -chatbotiiniini ja ilmoita, kun indeksointi on valmis"
Avustaja kutsuu crawler_preview_scan, valitsee relevantit sivut, aloittaa tuonnin crawler_start:llä ja pollaa crawler_job_get kunnes työ on valmis.
Liidien ja lomakelähetysten tarkastelu
"Näytä tämän viikon uudet liidit, osoita kelvolliset Annalle ja hyväksy odottavat yhteydenottolomakkeen lähetykset"
Avustaja yhdistää lead_list, lead_assign, form_submissions_list ja form_submission_update_status.
Live-chatin ottaminen haltuun
"Aseta minut saataville live-chatiin ja ota vanhin odottava keskustelu"
Avustaja käyttää live_chat_set_availability, live_chat_queue ja live_chat_session_assign; vastaukset menevät live_chat_message_send kautta.
Security
- API-avaimet sidotaan yritykseesi ja niihin oikeuksiin, jotka valitset niiden luomisessa (katso Scope -saraketta yllä)
- Avaimet suorittavat yrityksen omistajan oikeuksilla; suunnitelmarajat ja ominaisuuksien lippujen rajoitukset pätevät täsmälleen kuten hallintapaneelissa
- Avaimet voidaan peruuttaa milloin tahansa hallintapaneelista
- API-käyttö on saatavilla maksullisilla suunnitelmilla — katso Pricing page
Troubleshooting
Yhteyden muodostaminen epäonnistui
- Varmista, että API-avaimesi on oikea
- Tarkista, ettei avain ole peruutettu
- Varmista, että suunnitelmasi sisältää API-pääsyn
- Käynnistä MCP-asiakas uudelleen
Työkalua ei löydy
Käynnistä MCP-asiakas uudelleen konfiguraation muuttamisen jälkeen, jotta saat ladattua saatavilla olevat työkalut uudelleen. Työkalujen nimet ovat pienaakkosilla ja alaviivoin (esim. faq_list).
Tarvitsetko apua? Ota yhteyttä tukitiimiimme →