MCP Server Integration
ChatReact implementira Model Context Protocol (MCP), što vam omogućuje povezivanje vašeg ChatReact računa s AI asistentima poput Claude Desktop, Cursor i drugim alatima kompatibilnim s MCP-om.
Što je MCP?
Model Context Protocol je otvoreni standard koji omogućuje AI asistentima interakciju s vanjskim uslugama i izvorima podataka. Uz ChatReact-ovu MCP integraciju, možete:
- Upravljati chatbotovima — kreirati, konfigurirati (persona, jezici, widget, ponašanje, ograničenja), ugraditi i brisati chatbotove
- Graditi bazu znanja — dodavati dokumente, pretraživati web-stranice, upravljati indeksiranim stranicama i osnovnim uputama
- Upravljati FAQ-ovima — FAQ-ovi, kategorije, prijedlozi, prijevodi i FAQ widget
- Pregledavati razgovore — ocijeniti konverzacije, dodijeliti kategorije povjerenja, pokrenuti Improvement Agent
- Raditi s leadovima i obrascima — leadovi, kategorije leadova, postavke hvatanja, kontakt obrasci i prijave
- Djelovati kao agent za live chat — postaviti dostupnost, preuzeti čekajuće razgovore, odgovarati i zatvarati sesije
- Administrirati vašu tvrtku — profil, boje brenda, članovi tima i pozivnice
- Koristiti Email Assistant — povezivanja poštanskih sandučića, kategorije, kontakti i aktivnost
- Čitati analitiku i obavijesti
Sve što možete učiniti na nadzornoj ploči dostupno je putem MCP-a (i REST API); samo radnje vezane uz preglednik poput plaćanja, mailbox OAuth, passkey-ja, brisanja računa i upravljanja API ključevima ostaju na nadzornoj ploči.
Početak rada
1. Generirajte API ključ
- Idite na vaš Nadzorna ploča → Tvrtka → API karticu
- Kliknite Stvori API ključ
- Dajte ključu opisni naziv (npr. "Claude Desktop") i odaberite barem jednu dozvolu
- Kopirajte generirani ključ (počinje s
cr_)
API ključevi dostupni su na plaćenim planovima — pogledajte našu Pricing page.
Čuvajte svoj API ključ sigurno. Ne može se dohvatiti nakon stvaranja.
2. Konfigurirajte svog MCP klijenta
ChatReact MCP poslužitelj je hostan na https://www.chatreact.ai/api/mcp i komunicira preko HTTP-a (JSON-RPC). Autentificirajte se zaglavljem Authorization: Bearer — prihvaća se i X-API-Key zaglavlje sa istim ključem.
Cursor IDE
Cursor podržava udaljene MCP poslužitelje izravno. Dodajte u vaše Cursor MCP postavke:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Konfiguracijska datoteka Claude Desktop-a podržava serverske konfiguracije temeljene na naredbama, zato upotrijebite standardni mcp-remote bridge za povezivanje s hostanim endpointom:
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"
]
}
}
}
Ova postavka zahtijeva instaliran Node.js. Primjer koristi zaglavlje X-API-Key jer neki klijenti ne rukuju pouzdano razmacima u argumentima.
3. Ponovno pokrenite svog AI asistenta
Nakon spremanja konfiguracije, ponovno pokrenite Claude Desktop ili Cursor kako biste uspostavili vezu.
Dostupni alati
ChatReact MCP izlaže dolje navedene alate, grupirane po područjima. Stupac Scope pokazuje dopuštenje API ključa koje alat zahtijeva (any = svaki valjani ključ). Alati se izvršavaju s istim primjenjivim dopuštenjima, ograničenjima plana i nuspojavama kao i operacije podržane na nadzornoj ploči. Radni tokovi vezani uz preglednik za plaćanje, autorizaciju mailbox-a, passkey, brisanje računa i upravljanje ključevima ostaju na nadzornoj ploči.
Destruktivni alati (brisanje, resetiranje, zatvaranje, spajanje) traže potvrdu kada se koriste kroz Dashboard Assistant. Putem API ključa izvršavaju se odmah.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Dohvati trenutni plan (tier, status), brojnike korištenja za tekuće obračunsko razdoblje (companies, chatbots, team members, chats, tokens) i limite plana, plus efektivne limite i značajke tvrtke na koju se poziv odnosi. | any |
user_companies | Ispiši sve tvrtke kojima trenutni korisnik ima pristup, s korisnikovom ulogom u svakoj od njih. | any |
user_notification_mark_read | Označi jednu od trenutnim korisnikovih obavijesti kao pročitanu. | any |
user_notification_preferences_get | Dohvati preferencije obavijesti trenutnog korisnika: globalni email/push prekidači, učestalost/dan/vrijeme digest-a, quiet hours i postavke kanala po tipu. | any |
user_notification_preferences_update | Ažuriraj globalne preferencije obavijesti trenutnog korisnika (email/push prekidači, raspored digest-a, quiet hours). | any |
user_notification_type_setting_update | Omogući ili onemogući dostavu emailom / u aplikaciji za jedan tip obavijesti trenutnog korisnika (npr. | any |
user_notification_types_list | Nabroji sve tipove obavijesti grupirane po kategoriji (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Dohvati broj nepročitanih obavijesti trenutnog korisnika. | any |
user_notifications | Ispiši obavijesti trenutnog korisnika, najnovije prvo, s cursor paginacijom. | any |
user_notifications_delete_old | Održavanje: trajno obriši obavijesti trenutnog korisnika koje su već pročitane i starije od 30 dana. | any |
user_notifications_mark_all_read | Označi sve obavijesti trenutnog korisnika kao pročitane. | any |
user_profile | Dohvati profil trenutnog korisnika (id, name, email, role, subscription tier). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Ispiši sve chatbotove za određenu tvrtku sa sažetim statistikama. | chatbots:read |
company_get | Dohvati detaljne informacije o tvrtki: profil, owner, postavke brenda (boje, notification email) i brojeve. | any |
company_invite_cancel | Otkazati (izbrisati) pozivnicu za tim kako veza više ne bi radila. | company:write |
company_invite_resend | Ponovno pošalji čekajuću pozivnicu za tim: izdaje novi token, produljuje isteka za 7 dana i ponovno šalje email s pozivnicom. | company:write |
company_invites_list | Ispiši pozivnice za tim tvrtke (po defaultu PENDING; postavi includeExpired da vrati i isteknute). | company:read |
company_list | Ispiši sve tvrtke kojima korisnik ima pristup (API ključevi i Dashboard Assistant vide samo svoju tvrtku). | any |
company_logo_remove | Ukloni logo tvrtke (briše pohranjenu sliku i briše URL logotipa). | company:write |
company_member_invite | Pozovi člana tima putem emaila s ulogom (ADMIN, MANAGER, AGENT ili VIEWER). | company:write |
company_member_remove | Ukloni člana tima iz tvrtke. | company:write |
company_member_update_role | Promijeni ulogu člana tima (ADMIN, MANAGER, AGENT ili VIEWER). | company:write |
company_members_list | Ispiši članove tvrtke s njihovim ulogama (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Ažuriraj postavke brenda tvrtke: primaryColor / secondaryColor (#RRGGBB) i notificationEmail za pregled razgovora. | company:write |
company_update | Ažuriraj profil tvrtke: name (2-100 znakova), description (maks. 1000 znakova) ili website (https:// se dodaje automatski; proslijedite prazan string za brisanje website/description). | company:write |
Chatbot Management
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Dodaj novu core instruction chatbotu (1-5000 znakova). | chatbots:write |
chatbot_confirm_embed | Označi chatbot kao ugrađen na web-stranici (skriva podsjetnik za postavljanje na nadzornoj ploči). | chatbots:write |
chatbot_create | Kreiraj novog chatbota (isto kao čarobnjak na nadzornoj ploči). | chatbots:write |
chatbot_delete | Trajno izbriši chatbota sa svim njegovim FAQ-ovima, dokumentima, razgovorima, leadovima i obrascima (ne može se poništiti). | chatbots:write |
chatbot_delete_instruction | Obriši core instruction iz chatbota. | chatbots:write |
chatbot_get | Dohvati detaljne informacije o chatbotu: opće postavke, osobnost (persona, tonality, jezici, ograničenja), postavke widgeta, live chat, learning phase, status ugradnje i brojeve. | chatbots:read |
chatbot_get_embed_code | Dohvati HTML snippet za instalaciju chatbota na web-stranicu (script URL + <script> tag) i informaciju je li embed potvrđen. | chatbots:read |
chatbot_get_instructions | Dohvati sve core instructions za chatbota. | chatbots:read |
chatbot_improve_instructions | Prepiši tekst core-instruction koristeći AI poboljšivač platforme (isto kao 'Improve with AI' na nadzornoj ploči). | chatbots:write |
chatbot_learning_phase_get | Dohvati postavke learning-phase chatbota: behaviour preset (CAUTIOUS, BALANCED, CONFIDENT), custom prompt i je li bot još uvijek u learning phaseu. | chatbots:read |
chatbot_learning_phase_update | Postavi learning-phase behaviour preset (CAUTIOUS = preusmjeri na čovjeka kada nije siguran, BALANCED, CONFIDENT) i/ili custom learning-phase prompt. | chatbots:write |
chatbot_list | Ispiši sve chatbote kojima korisnik ima pristup, sa sažetim statistikama. | chatbots:read |
chatbot_reorder_instructions | Postavi redoslijed core instructions chatbota. | chatbots:write |
chatbot_templates_list | Ispiši template chatbota (preseti za persona, tonality, poruke i ponašanje widgeta) koje se mogu proslijediti kao templateId u chatbot_create, i informaciju može li ih plan tvrtke koristiti. | chatbots:read |
chatbot_toggle_active | Aktiviraj ili deaktiviraj chatbota. | chatbots:write |
chatbot_toggle_learning | Završi (false) ili ponovno omogući (true) learning phase chatbota. | chatbots:write |
chatbot_update | Ažuriraj opće postavke chatbota: name, description, isActive, live chat (liveChatEnabled/liveChatMode, značajka plana), showBranding (white-label planovi), chat-review emails, FAQ auto-generation, legacy coreInstructions tekst, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Ažuriraj postojeću core instruction (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Ažuriraj osobnost chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality klizači 1-5, jezici (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), poruke (welcomeMessage, fallbackMessage, proactive greeting) i ograničenja (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Dohvati trenutne postavke widgeta za chatbota (svi izgled, branding, ponašanje i polja pre-chat formulara). | chatbots:read |
widget_settings_update | Ažuriraj chat widget chatbota: position (uključujući | chatbots:write |
widget_translations_get | Dohvati prijevode widgeta po jeziku za chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Postavi prijevode widgeta po jeziku. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Otkaži PENDING ili RUNNING crawl job; preostale stranice se preskaču. | knowledge:write |
crawler_job_get | Dohvati status crawl joba, napredak (pagesCrawled/pagesFound, tokensUsed) i status svake stranice. | knowledge:read |
crawler_jobs_list | Ispiši crawl jobove chatbota (najnoviji prvi) sa statusom i napretkom. | knowledge:read |
crawler_limits | Dohvati limite crawlanja za plan chatbota (max pages per crawl, tokens per page, crawls per month) i može li se započeti novi crawl ovaj mjesec. | knowledge:read |
crawler_preview_scan | Skeniraj web-stranicu i nabroj indeksabilne stranice (url, title, isRecommended) bez uvoza ičega. | knowledge:write |
crawler_start | Pokreni crawl job koji uvozi odabrane URL-ove u bazu znanja chatbota (obrađuje se u pozadini; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Preuzmi dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) s javnog http(s) URL-a i dodaj ga u bazu znanja chatbota. | knowledge:write |
knowledge_document_add_text | Dodaj tekstualni ili markdown dokument u bazu znanja chatbota iz inline sadržaja (max 10 MB). | knowledge:write |
knowledge_document_delete | Obriši učitani dokument iz baze znanja. | knowledge:write |
knowledge_document_get | Dohvati detalje učitanog dokumenta uključujući status obrade, poruku o pogrešci i kratkotrajni URL za preuzimanje. | knowledge:read |
knowledge_documents_list | Ispiši učitane dokumente (PDF, TXT, MD, CSV, JSON, DOCX) u bazi znanja chatbota sa statusom i veličinom. | knowledge:read |
knowledge_page_add | Crawljaj jedan URL i dodaj ga u bazu znanja chatbota (baca CONFLICT ako je URL već indeksiran, FORBIDDEN kada je dosegnut limit tokena). | knowledge:write |
knowledge_page_delete | Obriši indeksiranu stranicu iz baze znanja (uklanja datoteku vektorskog spremišta). | knowledge:write |
knowledge_page_get | Dohvati indeksiranu stranicu uključujući markdown sadržaj koji je indeksiran za chatbota (korisno za provjeru što bot zna o stranici). | knowledge:read |
knowledge_page_recrawl | Ponovno dohvatiti indeksiranu stranicu i zamijeniti njen indeksirani sadržaj (npr. | knowledge:write |
knowledge_pages_delete | Obriši više indeksiranih stranica chatbota odjednom. | knowledge:write |
knowledge_pages_list | Ispiši indeksirane stranice u bazi znanja chatbota, opcionalno filtrirane po domenu, statusu ili pretraživanom termu (URL/title). | knowledge:read |
knowledge_stats | Pregled baze znanja chatbota: dokumenti (po statusu, veličini), indeksirane stranice i web-stranice (po statusu), crawl jobovi, core instructions razdvojeni po izvoru (manual vs improvement agent), FAQ-ovi, status/veličina vektorskog spremišta i korištenje pohrane vs. | knowledge:read |
knowledge_website_delete | Obriši sve indeksirane stranice web-stranice (domene) iz baze znanja chatbota. | knowledge:write |
knowledge_website_recrawl | Ponovno crawljaj svaku stranicu web-stranice (domene) u bazi znanja chatbota kako biste osvježili sadržaj. | knowledge:write |
knowledge_website_recrawl_cancel | Otkaži u tijeku re-crawl web-stranice: redom (PENDING) stavljene stranice domene vraćaju se na prethodno indeksirano stanje. | knowledge:write |
knowledge_websites_list | Ispiši web-stranice (domene) čije su stranice u bazi znanja chatbota, s brojevima stranica po statusu i zbrojem tokena. | knowledge:read |
Price Management
Ovi alati upravljaju strukturiranim nacrtima cijena i eksplicitnim odobrenjima. Spremanje nacrta je odvojeno od odobravanja točne verzije; prihvatljivost također ovisi o statusu i valjanosti. Postojeći API ključevi ne dobivaju automatski dozvole za cijene. Samo vlasnik tvrtke može dodijeliti prices:write ili prices:approve. Pozivi s API ključem izvršavaju se odmah, stoga provjerite točan unos prije poziva mutacije. Pogledajte Prices & services za korisnički radni tok.
| Tool | Description | Scope |
|---|---|---|
price_list | Paginirajte kroz price heads i odvojeno provjerite prihvatljivost odobrene verzije. | prices:read |
price_get | Pročitaj kompletno stanje stavke i revizije. | prices:read |
price_detail | Pročitaj detalje stavke s paginiranom poviješću revizija. | prices:read |
price_suggestions_list | Paginirajte kroz sugestije za cijene. | prices:read |
price_create | Kreiraj nacrt s ID-jem stavke generiranim na poslužitelju. | prices:write |
price_edit | Kreiraj novi nacrt iz eksplicitno očekivane verzije stavke. | prices:write |
price_import_csv | Uvezi nacrte s eksplicitnim formatom i stabilnim import ID-jem za sigurne ponovne pokušaje. | prices:write |
price_suggestion_apply | Primijeni odabrani kandidat sugestije kao nacrt. | prices:write |
price_approve | Odobri jednu eksplicitno očekivanu verziju stavke. | prices:approve |
price_approve_many | Atomски odobri odabir eksplicitnog ID-ja/verzije; svaka zastarjela verzija odbija cijeli odabir. | prices:approve |
price_archive | Arhiviraj stavku na njezinoj eksplicitno očekivanoj verziji. | prices:approve |
Uređivanja nacrta čuvaju prethodnu odobrenu reviziju. CSV format i decimalni separator moraju biti eksplicitni; promjena CSV sadržaja zahtijeva novi import ID. Sve operacije su vezane uz tvrtku API ključa i specificirani chatbot.
FAQ Management
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Očisti keširane podatke FAQ widgeta na svim povezanima CMS stranicama (WordPress plugin). | faqs:write |
faq_categories_list | Ispiši FAQ kategorije chatbota s brojem FAQ-ova, slugovima, načinom sortiranja i prijevodima. | faqs:read |
faq_categories_reorder | Postavi redoslijed FAQ kategorija u widgetu: pozicija u categoryIds postaje sortOrder. | faqs:write |
faq_category_create | Kreiraj FAQ kategoriju za chatbota (slug se generira iz imena). | faqs:write |
faq_category_delete | Obriši FAQ kategoriju. | faqs:write |
faq_category_translations_update | Zamijeni prijevode FAQ kategorije, npr. | faqs:write |
faq_category_update | Preimenuj FAQ kategoriju ili promijeni njen opis, ikonu ili način sortiranja. | faqs:write |
faq_create | Kreiraj FAQ za chatbota. | faqs:write |
faq_delete | Trajno izbriši FAQ (također ga uklanja iz baze znanja chatbota i čisti CMS cache widgeta). | faqs:write |
faq_embed_code_get | Dohvati embed snippete za FAQ widget: script tag, WordPress shortcode i Shopify Liquid snippet, plus varijante po kategoriji (koristite categorySlug iz faq_categories_list za ugradnju samo jedne kategorije). | chatbots:read |
faq_get | Dohvati pune detalje FAQ-a: pitanje, odgovor, kategorija, publish state, sort order, prijevodi, SEO polja i statistiku povratnih informacija. | faqs:read |
faq_list | Ispiši FAQ-ove chatbota (koristite chatbot_list da pronađete chatbotId). | faqs:read |
faq_reorder | Postavi redoslijed prikaza FAQ-ova u widgetu. | faqs:write |
faq_suggestion_approve | Odobri PENDING FAQ sugestiju: kreira objavljen FAQ (opcionalno s izmijenjenim pitanjem/odgovorom/kategorijom) i označava sugestiju kao APPROVED. | faqs:write |
faq_suggestion_get | Dohvati pune detalje FAQ sugestije (kompletan odgovor, AI objašnjenje, sugerirana kategorija, stanje pregleda). | faqs:read |
faq_suggestion_reject | Odbaci PENDING FAQ sugestiju s opcionalnim razlogom. | faqs:write |
faq_suggestions_generate | Neka AI predloži nove FAQ-ove iz baze znanja chatbota (indeksirane stranice / učitani dokumenti), opcionalno za jednu kategoriju. | faqs:write |
faq_suggestions_list | Ispiši AI-generirane FAQ sugestije chatbota (iz razgovora ili faq_suggestions_generate). | faqs:read |
faq_translate | Prevedi pitanje i odgovor FAQ-a pomoću AI u ostale podržane jezike chatbota (ili u zadane targetLanguages) i spremi rezultat. | faqs:write |
faq_translations_update | Spremi prijevode FAQ-a po jeziku, npr. | faqs:write |
faq_update | Ažuriraj pitanje, odgovor, kategoriju, publish state ili ručni sort order FAQ-a. | faqs:write |
faq_widget_settings_get | Dohvati postavke izgleda i ponašanja ugrađivog FAQ widgeta (boje, border radius, naslov, razmaci, max width, allowMultipleOpen, autoOpenFirst, način sortiranja, prijevodi naslova). | chatbots:read |
faq_widget_settings_update | Ažuriraj postavke FAQ widgeta: boje (hex), borderRadius 0-32, title (maks 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = puna širina), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name i prijevode naslova po jeziku. | chatbots:write |
Chat History & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Označi razgovor kao pregledan bez ocjene (uklanja ga iz redova na čekanju, ne mijenja confidence score). | chats:write |
chat_feedback_get | Dohvati jedan pregled razgovora (feedback) s AI analizom, težinom, kategorijom povjerenja, promjenom rezultata i povezanim improvement sessionom. | chats:read |
chat_feedback_list | Ispiši preglede razgovora (redovi povratnih informacija) chatbota s filterom statusa i brojevima. | chats:read |
chat_feedback_set_severity | Prepiši klasifikaciju težine (MINOR|MODERATE|MAJOR|CRITICAL) pregledanog negativnog razgovora; težina utječe na pad confidence scorea. | chats:write |
chat_feedback_stats | Brojevi sesija po review bucketu za chatbota (total, none, pending, positive, negative, reviewed, improved) — kartice statistike na stranici razgovora nadzorne ploče. | chats:read |
chat_feedback_submit | Ocijeni chat sesiju kao Good (isPositive=true) ili Needs Work (isPositive=false). | chats:write |
chat_session_get | Dohvati chat sesiju s kompletnim transkriptom (po-poruka token/model/latency/pageUrl), podacima o posjetitelju, URL-om početne stranice, kategorijom povjerenja, feedbackom (severity, AI analiza, povezani improvement session) i tagovima. | chats:read |
chat_session_search | Pretraži chat sesije chatbota po sadržaju poruke i/ili emailu posjetitelja. | chats:read |
chat_session_set_category | Dodijeli ili promijeni kategoriju povjerenja chat sesije (ispravlja AI kategorizaciju; per-kategorijska povjerenja se ponovno izračunavaju kada je razgovor pregledan). | chats:write |
chat_sessions_list | Ispiši chat sesije chatbota, najnovije prvo, s istim filterima reda pregleda kao na stranici razgovora nadzorne ploče. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Ispiši kategorije povjerenja chatbota s per-kategorijskim confidence scoreom, brojem pregleda i učestalošću emailova za pregled. | chats:read |
confidence_category_create | Kreiraj kategoriju povjerenja za chatbota. | chatbots:write |
confidence_category_delete | Obriši kategoriju povjerenja. | chatbots:write |
confidence_category_merge | Spoji jednu kategoriju povjerenja u drugu isteg chatbota: svi razgovori/pregledi prelaze u ciljnu, izvorna se briše i rezultati se ponovno izračunavaju. | chatbots:write |
confidence_category_update | Preimenuj kategoriju povjerenja i/ili postavi učestalost emailova za pregled (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 samo za HOURLY). | chatbots:write |
confidence_status_get | Status povjerenja chatbota: score, graduation threshold, learning phase flag, learning-phase behaviour (CAUTIOUS|BALANCED|CONFIDENT) i custom prompt, brojevi pregleda i per-kategorijski confidence scoreovi. | analytics:read |
improvement_proposal_approve | Odobri PENDING improvement prijedlog i primijeni promjenu na chatbota (dodavanje/azuriranje core instruction, kreiranje/azuriranje FAQ-a ili ažuriranje persone) — ista logika i limitiranja plana kao na nadzornoj ploči. | chatbots:write |
improvement_proposal_reject | Odbaci PENDING improvement prijedlog. | chatbots:write |
improvement_proposal_simulate | Simuliraj kako bi chatbot odgovorio na problematičnu poruku s primijenjenim prijedlogom (original vs. | chatbots:write |
improvement_proposals_pending | Ispiši prijedloge za poboljšanje koji očekuju pregled (status PENDING) za tvrtku ili za jednog chatbota. | chatbots:read |
improvement_session_complete | Označi improvement session kao COMPLETED (razgovor se tada broji kao Improved u redu pregleda). | chatbots:write |
improvement_session_create | Otvori Improvement Agent za razgovor ocijenjen kao Needs Work. | chatbots:write |
improvement_session_get | Dohvati improvement session s originalnim razgovorom (poruke imaju 1-bazirani indeks koji se može koristiti kao targetMessageIndex), agentovim razgovorom, svim prijedlozima (s njihovom najnovijom simulacijom) i simulacijama. | chatbots:read |
improvement_session_reset | Ponovno pokreni improvement session: briše sve agentove poruke, simulacije i PENDING/REJECTED prijedloge (primijenjeni se čuvaju) i započinje svježi razgovor. | chatbots:write |
improvement_session_send_message | Pošalji poruku Improvement Agentu (opisi što je bilo loše u botovom odgovoru; opcionalno targetMessageIndex = 1-bazirani indeks botove poruke u originalChat.messages). | chatbots:write |
improvement_sessions_list | Ispiši improvement sessione (Improvement Agent razgovori pokrenuti iz negativnih pregleda) za chatbota ili cijelu tvrtku, najnovije prvi, s brojem prijedloga. | chatbots:read |
improvement_simulation_assess | Ocijeni rezultat simulacije: isApproved=true kada je simulirani odgovor dobar (prijedlog se tada može primijeniti), false kada zahtijeva doradu (komentar 'almost' = skoro točno). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Dohvati vlastitu dostupnost za live chat trenutnog korisnika, agente koji su trenutno dostupni za live chat (svježi heartbeat, isti signal koji widget koristi) i informaciju uključuje li plan tvrtke live chat. | chats:read |
live_chat_heartbeat | Osvježi heartbeat prisutnosti trenutnog korisnika za live chat (samo dok ste označeni dostupnima putem live_chat_set_availability). | chats:write |
live_chat_message_send | Pošalji poruku posjetitelju kao dodijeljeni agent. | chats:write |
live_chat_queue | Dohvati red za live chat: sesije koje čekaju agenta, najstarije prve (FIFO). | chats:read |
live_chat_session_assign | Preuzmi WAITING live chat sesiju iz reda: dodjeljuje je trenutnom korisniku (vlasnik tvrtke za API ključeve) i obavještava posjetitelja da se agent pridružio. | chats:write |
live_chat_session_close | Završi live chat sesiju kao agent (bilo koji član tvrtke osim VIEWER-a). | chats:write |
live_chat_session_get | Dohvati live chat sesiju s informacijama o posjetitelju, dodijeljenom agentu, svim porukama i prethodnim bot razgovorom (handoff context). | chats:read |
live_chat_sessions_list | Ispiši live chat sesije (najnovije prve; WAITING sesije najstarije prve) s opcionalnim filtrima po chatbotu, statusu i dodijeljenom agentu. | chats:read |
live_chat_set_availability | Prebaci prekidač trenutnog korisnika 'Available for Live Chat' za tvrtku. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Dodijeli lead članu tvrtke ili ga oddodijeli (assignedToId: null). | leads:write |
lead_bulk_update_status | Postavi status više leadova (max 100) odjednom. | leads:write |
lead_categories_list | Ispiši kategorije leadova chatbota s brojevima leadova i članovima tima obaviještenim po kategoriji. | leads:read |
lead_category_assign_user | Dodaj člana tvrtke na listu obavijesti lead kategorije (ili ažuriraj njihove notification flags). | leads:write |
lead_category_create | Kreiraj kategoriju leadova za chatbota. | leads:write |
lead_category_delete | Obriši kategoriju leadova. | leads:write |
lead_category_remove_user | Ukloni člana tvrtke s liste obavijesti kategorije leadova. | leads:write |
lead_category_update | Ažuriraj ime, opis i/ili boju kategorije leadova. | leads:write |
lead_create | Ručno kreiraj lead (npr. | leads:write |
lead_delete | Trajno izbriši lead. | leads:write |
lead_field_config_get | Dohvati konfiguraciju hvatanja leadova chatbota: polja (ids mapiraju na ključeve u lead.data), poruku potvrde, prijevode polja/UI i AI postavke prepoznavanja. | leads:read |
lead_field_config_update | Ažuriraj konfiguraciju hvatanja leadova chatbota. | leads:write |
lead_get | Dohvati pune detalje leada uključujući dodijeljenog, kategoriju i izvorni transkript razgovora (paginirano s messageOffset/messageLimit, zadano prve 20 poruka). | leads:read |
lead_list | Ispiši leadove chatbota (najnoviji prvi) s opcionalnim filtrima po statusu, kategoriji, assignee i pretraživanjem slobodnim tekstom (ime/email/tvrtka). | leads:read |
lead_stats | Dohvati statistiku leadova za chatbota: brojeve po statusu, leadove zadnjih 7 dana i stopu konverzije (postotak). | leads:read |
lead_update | Ažuriraj status, kategoriju, bilješke, uhvaćene podatke i/ili dodijeljenog leada. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Kreiraj kontakt obrazac za chatbota (osnovno, polja, dizajn i postavke za spam u jednom pozivu). | forms:write |
form_delete | Trajno izbriši kontakt obrazac i SVE njegove prijave (cascade). | forms:write |
form_get | Dohvati kontakt obrazac u cijelosti: polja, prijevodi, stilizaciju, postavke protiv spama, aktivno stanje, broj prijava i embed script tag (embedCode). | forms:read |
form_list | Ispiši kontakt obrasce chatbota s brojem polja, brojem prijava i embed kodovima. | forms:read |
form_stats | Brojevi prijava kontakt obrasca: total, pending, approved, spam i rejected. | forms:read |
form_submission_delete | Trajno izbriši prijavu kontakt obrasca (npr. | forms:write |
form_submission_get | Dohvati prijavu kontakt obrasca u cijelosti: poslane podatke polja, spam score i AI spam analizu, IP/user agent/referrer metapodatke i informacije o pregledu. | forms:read |
form_submission_update_status | Pregledaj prijavu kontakt obrasca: postavi njezin status na APPROVED, SPAM ili REJECTED s opcionalnom bilješkom. | forms:write |
form_submissions_list | Ispiši prijave kontakt obrasca, najnovije prve, opcionalno filtrirano po statusu (PENDING, APPROVED, SPAM, REJECTED) i datumu kreiranja. | forms:read |
form_update | Ažuriraj kontakt obrazac: ime, opis, aktivno stanje (isActive kontrolira renderiranje embed-a), polja (potpuna zamjena), dizajn (boje, tekst gumba, poruka o uspjehu) i postavke protiv spama (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Zamijeni prijevode polja i/ili UI kontakt obrasca. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Ispiši zapisnik aktivnosti obrađenih emailova povezivanja poštanskog sandučića (najnoviji prvi): pošiljatelj, subject, dodijeljena kategorija, ishod (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) i outcomeDetail. | email:read |
email_categories_list | Ispiši email kategorije povezivanja poštanskog sandučića (poredano po sortOrder). | email:read |
email_category_create | Kreiraj email kategoriju za povezivanje poštanskog sandučića (maks 20 po konekciji). | email:write |
email_category_delete | Obriši email kategoriju. | email:write |
email_category_update | Ažuriraj email kategoriju (djelomično: mijenjaju se samo navedena polja). | email:write |
email_connection_disconnect | Trajno odspoji mailbox. | email:write |
email_connection_get | Dohvati povezivanje mailboxa uključujući | email:read |
email_connection_update | Ažuriraj povezivanje mailboxa: pauziraj/nastavi sinkronizaciju (paused true/false; samo prebacuje ACTIVE<->DISABLED, nikada ne nadjačava TOKEN_EXPIRED/ERROR), uključi/isključi draftanje odgovora (draftingEnabled) i kategorizaciju/organiziranje (organizingEnabled), preusmjeri napajajući chatbot (chatbotId iste tvrtke) ili postavi HTML potpis odgovora (signatureHtml, maks 20000 znakova; prazan string ga briše). | email:write |
email_connections_list | Ispiši povezivanja Email Assistant mailboxa tvrtke (adresa, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, zadnja sinkronizacija, zadnja greška, draftanje/organiziranje prekidači, powering chatbot, draftReadyCategoryCount = kategorije koje mogu generirati nacrte, baseRuleCount = širokoplanne 'Chat + Email' rules primijenjene na svaki nacrt) zajedno s limitima plana (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Obriši naučeni email kontakt (zaboravi profil pošiljatelja, npr. | email:write |
email_contact_get | Dohvati naučeni email kontakt sa svim naučenim činjenicama, internim bilješkama, odnosom, formal/informal postavkom adrese i statistikama emailova. | email:read |
email_contact_update | Ažuriraj naučeni email kontakt. | email:write |
email_contacts_list | Ispiši naučene email kontakte tvrtke (zadnji email prvi) s odnosom, formal/informal adresom (formalAddress: true = formalno 'Sie', false = neformalno 'Du', null = automatski), brojem činjenica i pregledom bilješki. | email:read |
email_folder_create | Kreiraj mail folder ispod inboxa (vraća postojeći ako je ime zauzeto) da služi kao cilj za pomicanje kategorije. | email:write |
email_folders_list | Ispiši foldere u koje email kategorija može premještati mailove uživo iz mailboxa: inbox podmape, prilagođene top-level foldere, archive, junk i trash (id 'deleteditems'). | email:read |
email_general_rules_list | Ispiši pravila koja se primjenjuju na svaki nacrt odgovora mailboxa: aktivne core instructions s channel BOTH ("Chat + Email"), plus legacy email-only koja još nisu migrirana u kategoriju. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volumen razgovora (pokrenute sesije) kroz vrijeme za grafikone i trendove: period week/month/quarter/year, granularnost hour/day/week/month, opcionalno za jednog chatbota. | analytics:read |
analytics_chatbot_stats | Performanse po chatbota za tvrtku u jednom pozivu (tablica performansi chatbota na nadzornoj ploči): id, name, slug, isActive, sessions, messages, FAQs i leads po chatbota, sortirano po sessions. | analytics:read |
analytics_forms | Statistika prijava kontakt obrasca za tvrtku ili jednog chatbota (widget analitike): prijave po statusu (pending/approved/rejected/spam), broj obrazaca, total, spam rate u postocima i serija prijava po danu za zadnjih 7 dana. | analytics:read |
analytics_leads | Lead funnel za tvrtku ili jednog chatbota (widget analitike): leadovi po statusu (new/contacted/qualified/converted/lost), ukupno, stopa konverzije u postocima i serija leadova po danu za zadnjih 7 dana. | analytics:read |
analytics_overview | Analitički pregled za tvrtku ili jednog chatbota: razgovori, poruke, stopa zadovoljstva i top pitanja za pomični period (day/week/month/year), plus widget pregleda nadzorne ploče (total chatbots/published FAQs/leads, sessions danas/ovaj tjedan/ovaj mjesec, leads danas/ovaj tjedan, form submissions total/danas/pending). | analytics:read |
dashboard_activity | Što trenutno zahtijeva pažnju (home view nadzorne ploče): po tvrtki, chatboti s novim leadovima danas, pending FAQ sugestijama, pending prijavama obrazaca, čekajućim/aktivnim live chatovima ili trenutnom learning phaseu. | any |
Primjeri radnih tijekova
Dodavanje core instruction
Pitajte svog AI asistenta:
"Add a core instruction to my 'Support Bot' chatbot: we offer free shipping on orders over €50"
Asistent će upotrijebiti chatbot_add_instruction s odgovarajućim parametrima.
Pregled prijedloga za poboljšanje
"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"
Asistent će:
- Koristiti
improvement_proposals_pendingza dohvat prijedloga - Analizirati i sažeti svaki prijedlog
- Odobriti ili odbiti u vaše ime pomoću
improvement_proposal_approveiliimprovement_proposal_reject
Analiza performansi razgovora
"Give me a weekly report of chat volume and customer satisfaction for my chatbot"
Asistent će koristiti analytics_overview i analytics_chat_volume za sastavljanje sveobuhvatnog izvještaja.
Uvoz web-stranice
"Scan https://example.com, import the product and pricing pages into my 'Support Bot' and tell me when the crawl is done"
Asistent će pozvati crawler_preview_scan, odabrati relevantne stranice, započeti uvoz s crawler_start i pollati crawler_job_get dok posao ne završi.
Pregled leadova i prijava obrazaca
"Show me the new leads from this week, assign the qualified ones to Anna and approve the pending contact form submissions"
Asistent kombinira lead_list, lead_assign, form_submissions_list i form_submission_update_status.
Preuzimanje live chata
"Set me available for live chat and take the oldest waiting conversation"
Asistent koristi live_chat_set_availability, live_chat_queue i live_chat_session_assign; odgovori prolaze kroz live_chat_message_send.
Sigurnost
- API ključevi su ograničeni na vašu tvrtku i na dozvole koje odaberete pri njihovom stvaranju (pogledajte stupac Scope gore)
- Ključevi se izvršavaju s dopuštenjima vlasnika tvrtke; limiti plana i feature gate-ovi primjenjuju se jednako kao na nadzornoj ploči
- Ključevi se mogu opozvati u bilo kojem trenutku s nadzorne ploče
- API pristup dostupan je na plaćenim planovima — pogledajte našu Pricing page
Rješavanje problema
Veza nije uspjela
- Provjerite je li vaš API ključ ispravan
- Provjerite nije li ključ opozvan
- Provjerite uključuje li vaš plan API pristup
- Ponovno pokrenite svog MCP klijenta
Alat nije pronađen
Ponovno pokrenite svog MCP klijenta nakon promjene konfiguracije kako bi ponovno učitao dostupne alate. Imenu alata su mala slova s donjim crticama (npr. faq_list).
Trebate pomoć? Contact our support team →