MCP Server Integration
Cuireann ChatReact an Model Context Protocol (MCP) i bhfeidhm, rud a cheadaíonn duit do chuntas ChatReact a nascadh le cúntóirí AI mar Claude Desktop, Cursor, agus uirlisí eile comhoiriúnach MCP.
Cad é MCP?
Is caighdeán oscailte é an Model Context Protocol a chuireann ar chumas cúntóirí AI idirghníomhú le seirbhísí seachtracha agus foinsí sonraí. Le hionchuinge ChatReact ar MCP, is féidir leat:
- Bainistiú chatbot — cruthaigh, cumraigh (pearsona, teangacha, widget, iompar, srianta), ionchlannú agus scrioschatbots
- Tóg an bhonn eolais — cuir doiciméid leis, crawl suíomhanna gréasáin, bainistiú leathanach a chraolaíodh agus treoracha croí
- Bainistiú FAQs — FAQs, catagóirí, moltaí, aistriúcháin agus an widget FAQ
- Athbhreithniú comhráite — rátáil comhráite, catagóirí muiníne a leithdháileadh, an Gníomhaire Feabhsúcháin a rith
- Oibriú le luaidhe agus foirmeacha — luaidhe, catagóirí luaidhe, socruithe ghabhdála, foirmeacha teag contact agus cúrsálacha
- Gníomhú mar ghníomhairí comhrá beo — socraigh do infhaighteacht, glac le comhráite atá ag fanacht, freagair agus dún seisiúin
- Riar do chomhlacht — próifíl, dathanna branda, baill foirne agus cuireadh
- Úsáid an Email Assistant — nascanna bosca poist, catagóirí, teagmhálaithe agus gníomhaíocht
- Léigh anailísíocht agus fógraí
Is féidir gach rud is féidir leat a dhéanamh sa dashboard a dhéanamh trí MCP (agus an REST API); ní fanann ach gníomhartha a cheanglaíonn ar an mbrabhsálaí amhail íocaíochtaí, OAuth bosca poist, passkeys, scriosadh cuntais agus bainistíocht eochracha API sa dashboard.
Tús a chur
1. Gineadh Eochair API
- Téigh go dtí do Painéal → Cuideachta → API cluaisín
- Cliceáil Cruthaigh Eochair API
- Tabhair ainm tuairisciúil don eochair (m.sh. "Claude Desktop") agus roghnaigh ar a laghad ceadúnas amháin
- Cóipeáil an eochair ghiniúna (tosaíonn sé le
cr_)
Tá eochracha API ar fáil ar phleananna íoctha — féach ar ár leathanach Praghsála.
Stóráil do eochair API go slán. Ní féidir í a aisghabháil tar éis a cruthaithe.
2. Cumraigh Do Chliaint MCP
Tá freastalaí MCP ChatReact óstáilte ag https://www.chatreact.ai/api/mcp agus cumarsáideann sé thar HTTP (JSON-RPC). Déan údarú le ceannlíne Authorization: Bearer — glacfar freisin le ceannlíne X-API-Key leis an eochair chéanna.
Cursor IDE
Tacaíonn Cursor le freastalaithe MCP iargúlta go díreach. Cuir leis do shocruithe MCP Cursor:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Tacaíonn comhad cumraíochta Claude Desktop le freastalaithe bunaithe ar ordú, mar sin bain úsáid as an droichead caighdeánach mcp-remote chun nasc a dhéanamh leis an deireadh óstáilte:
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"
]
}
}
}
Éilíonn an socrú seo Node.js a bheith suiteáilte. Úsáideann an sampla an ceannlíne X-API-Key mar gheall ar nach bhfuil roinnt cliant in ann spásanna i argóintí a láimhseáil go iontaofa.
3. Athchealraigh Do Chúnntóir AI
Tar éis an chumraíocht a shábháil, athchealraigh Claude Desktop nó Cursor chun an nasc a bhunú.
Uirlisí atá ar Fáil
Nochtann MCP ChatReact na huirlisí thíos, grúpáilte de réir réimse. Taispeánann colún an Scope an ceadúnas eochair API a éilíonn uirlis (any = gach eochair bailí). Rithfidh uirlisí leis na ceadanna i bhfeidhm chéanna, teorainneacha plean agus éifeachtaí taobh a bhíonn i bhfeidhm ar oibríochtaí an dashboard. Fanann sreafaí íocaíochta, údarú bosca poist, passkey, scriosadh cuntais agus bainistíocht eochracha a shaincheapadh sa dashboard.
Iarrann uirlisí dochracha (scrios, athshocraigh, dún, comhcheangail) deimhniú nuair a úsáidtear iad trí Dashboard Assistant. Trí eochair API a úsáideann siad láithreach.
Cuntas
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Faigh an plean reatha (sraith, stádas), comptóirí úsáide thréimhse billeála reatha (comhlachtaí, chatbots, baill foirne, comhráite, tiontaí) agus teorainneacha an phlean, chomh maith leis na teorainneacha agus bratacha gné éifeachtacha an chomhlachta atá scóipithe don ghlao. | any |
user_companies | Liostaigh gach comhlacht atá rochtain ag an úsáideoir reatha orthu, le ról an úsáideora i ngach ceann. | any |
user_notification_mark_read | Marcáil ceann de fhógraí an úsáideora reatha mar léite. | any |
user_notification_preferences_get | Faigh roghanna fógraíochta an úsáideora reatha: lascáin ríomhphoist/pressa domhanda, min rithe digear/time/weekday/timezone, uaireanta ciúine agus socruithe chanála in aghaidh an chine. | any |
user_notification_preferences_update | Nuashonraigh roghanna fógraíochta domhanda an úsáideora reatha (lascáin ríomhphoist/pressa, sceideal digear, uaireanta ciúine). | any |
user_notification_type_setting_update | Cumasaigh nó díghníomhachtaigh seachdelivery ríomhphoist / in-app do chine amháin fógra den úsáideoir reatha (m.sh. | any |
user_notification_types_list | Liostaigh gach cine fógra grúpáilte de réir catagóire (chatbot, luaidhe, comhrá beo, eolas, foireann, billeáil). | any |
user_notification_unread_count | Faigh líon na bhfógraí neamhléite don úsáideoir reatha. | any |
user_notifications | Liostaigh fógraí an úsáideora reatha, is nuaí ar dtús, le págiú cursor. | any |
user_notifications_delete_old | Bainistíocht: scrios go buan fógraí an úsáideora reatha atá léite cheana agus níos sine ná 30 lá. | any |
user_notifications_mark_all_read | Marcáil gach fógra an úsáideora reatha mar léite. | any |
user_profile | Faigh próifíl an úsáideora reatha (id, ainm, ríomhphost, ról, sraith síntiúis). | any |
Comhlacht & Foireann
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Liostaigh gach chatbot do chomhlacht sonrach le staitisticí achoimre. | chatbots:read |
company_get | Faigh sonraí mionsonraithe faoi chomhlacht: próifíl, úinéir, socruithe branda (dathanna, ríomhphost fógraíochta) agus comptóirí. | any |
company_invite_cancel | Cealaigh (scrios) cuireadh foirne ionas nach n-oibreodh an nasc a thuilleadh. | company:write |
company_invite_resend | Seol cuireadh foirne atá ar feitheamh arís: táirgeann sé token nua, síneann sé an éagtha trí 7 lá agus seolann sé r-phost an chuiúide arís. | company:write |
company_invites_list | Liostaigh cuidiúcháin foirne comhlachta (ar feitheamh de réir réamhshocraithe; socraigh includeExpired chun iad atá éagtha a thabhairt ar ais freisin). | company:read |
company_list | Liostaigh gach comhlacht atá rochtain ag an úsáideoir orthu (feiceann eochracha API agus Dashboard Assistant a gcomhlacht féin amháin). | any |
company_logo_remove | Bain lógó an chomhlachta (scriosann sé an íomhá stóráilte agus glanann sé an URL lógó). | company:write |
company_member_invite | Cuireadh ball foirne trí r-phost le ról (ADMIN, MANAGER, AGENT nó VIEWER). | company:write |
company_member_remove | Bain ball foirne den chomhlacht. | company:write |
company_member_update_role | Athraigh ról ball foirne (ADMIN, MANAGER, AGENT nó VIEWER). | company:write |
company_members_list | Liostaigh baill chomhlachta lena róil (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Nuashonraigh socruithe branda an chomhlachta: primaryColor / secondaryColor (#RRGGBB) agus an notificationEmail do athbhreithnithe comhrá. | company:write |
company_update | Nuashonraigh próifíl an chomhlachta: ainm (2-100 carachtar), cur síos (uasmhéid 1000 carachtair) nó suíomh gréasáin (cuirtear https:// leis go huathoibríoch; pasáil stríng fhánach chun suíomh/cur síos a ghlanadh). | company:write |
Bainistíocht Chatbot
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Cuir treoir chroí nua le chatbot (1-5000 carachtar). | chatbots:write |
chatbot_confirm_embed | Marcáil chatbot mar ionchlannaithe ar an suíomh (folach an cuimhneachán socraithe sa dashboard). | chatbots:write |
chatbot_create | Cruthaigh chatbot nua (cosúil leis an draoi sa dashboard). | chatbots:write |
chatbot_delete | Scrios chatbot go buan le gach a FAQs, doiciméid, comhráite, luaidhe agus foirmeacha (ní féidir é a aisiompú). | chatbots:write |
chatbot_delete_instruction | Scrios treoir chroí ó chatbot. | chatbots:write |
chatbot_get | Faigh faisnéis mhionsonraithe faoi chatbot: socruithe ginearálta, pearsantacht (pearsona, tonality, teangacha, srianta), socruithe widget, comhrá beo, céim foghlama, stádas ionchlannaithe agus comptóirí. | chatbots:read |
chatbot_get_embed_code | Faigh an slisnigh HTML chun chatbot a shuiteáil ar shuíomh (URL script + <script> tag) agus an bhfuil an ionchlannú dearbhaithe. | chatbots:read |
chatbot_get_instructions | Faigh na treoracha croí go léir do chatbot. | chatbots:read |
chatbot_improve_instructions | Athscríobh téacs treorach chroí le feabhsóir AI an ardáin (mar an "Improve with AI" sa dashboard). | chatbots:write |
chatbot_learning_phase_get | Faigh socruithe céim foghlama chatbot: réamhshocraíocht iompair (CAUTIOUS, BALANCED, CONFIDENT), spreagadh saincheaptha agus an bhfuil an bot fós i gcéim foghlama. | chatbots:read |
chatbot_learning_phase_update | Socraigh réamhshocraíocht iompair céim foghlama (CAUTIOUS = tagair do dhuine nuair nach bhfuil cinnte, BALANCED, CONFIDENT) agus/nó spreagadh céim foghlama saincheaptha. | chatbots:write |
chatbot_list | Liostaigh gach chatbot atá rochtain ag an úsáideoir orthu, le staitisticí achoimre. | chatbots:read |
chatbot_reorder_instructions | Socraigh ordú treoracha croí chatbot. | chatbots:write |
chatbot_templates_list | Liostaigh na téamaí chatbot (réamhshocruithe do persona, tonality, teachtaireachtaí agus iompar widget) ar féidir iad a pasáil mar templateId chuig chatbot_create, agus an bhféadfaidh plean an chomhlachta iad a úsáid. | chatbots:read |
chatbot_toggle_active | Gníomhachtaigh nó díghníomhachtaigh chatbot. | chatbots:write |
chatbot_toggle_learning | Críochnaigh (false) nó cuir ar ais (true) céim foghlama chatbot. | chatbots:write |
chatbot_update | Nuashonraigh socruithe ginearálta chatbot: ainm, cur síos, isActive, comhrá beo (liveChatEnabled/liveChatMode, gné plean), showBranding (pleananna white-label), ríomhphoist athbhreithnithe comhrá, giniúint FAQ uathoibríoch, téacs treoracha croí oidhreachta, céim foghlama (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Nuashonraigh treoir chroí atá ann cheana (ábhar, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Nuashonraigh pearsantacht chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), sleamhnáin tonality 1-5, teangacha (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), teachtaireachtaí (welcomeMessage, fallbackMessage, proactive greeting) agus srianta (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Faigh socruithe reatha an widget do chatbot (gach cuma, branda, iompair agus réimsí foirm réamh-chomhrá). | chatbots:read |
widget_settings_update | Nuashonraigh an widget comhrá do chatbot: suíomh (incl. | chatbots:write |
widget_translations_get | Faigh na haistriúcháin widget in aghaidh teanga do chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Socraigh aistriúcháin widget in aghaidh teanga. | chatbots:write |
Bonn Eolais
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Cealú post crawl PENDING nó RUNNING; ní dhéanfar na leathanaigh fágtha a phróiseáil. | knowledge:write |
crawler_job_get | Faigh stádas post crawl, dul chun cinn (pagesCrawled/pagesFound, tokensUsed) agus stádas gach leathanach. | knowledge:read |
crawler_jobs_list | Liostaigh poist crawl chatbot (is nuaí ar dtús) le stádas agus dul chun cinn. | knowledge:read |
crawler_limits | Faigh teorainneacha crawl an phlean do chatbot (uasmhéid leathanach in aghaidh crawl, token in aghaidh leathanach, crawls in aghaidh na míosa) agus an féidir crawl nua a thosú an mhí seo. | knowledge:read |
crawler_preview_scan | Scan suíomh gréasáin agus liostaigh a leathanaigh crawlable (url, teideal, isRecommended) gan aon rud a iompórtáil. | knowledge:write |
crawler_start | Tosaigh post crawl a iompraíonn na URLanna roghnaithe isteach i mbonn eolais an chatbot (próiseáilte sa chúlra; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Íoslódáil doiciméad (PDF, TXT, MD, CSV, JSON, DOCX; uasmhéid 10 MB) ó URL http(s) poiblí agus cuir isteach i mbonn eolais chatbot. | knowledge:write |
knowledge_document_add_text | Cuir doiciméad téacs nó markdown le mbonn eolais chatbot ó ábhar inline (uasmhéid 10 MB). | knowledge:write |
knowledge_document_delete | Scrios doiciméad uaslódáilte ón mbun eolais. | knowledge:write |
knowledge_document_get | Faigh sonraí do dhoiciméad uaslódáilte lena stádas próiseála, teachtaireacht earráide agus URL íoslódála sealadach. | knowledge:read |
knowledge_documents_list | Liostaigh na doiciméid uaslódáilte (PDF, TXT, MD, CSV, JSON, DOCX) i mbonn eolais chatbot le stádas agus méid. | knowledge:read |
knowledge_page_add | Crawl URL aonair agus cuir isteach i mbonn eolais chatbot (teipíonn le CONFLICT nuair atá an URL innéacsaithe cheana, FORBIDDEN nuair a shroicheann an teorainn token). | knowledge:write |
knowledge_page_delete | Scrios leathanach a craoladh ón mbun eolais (bainfidh sé a chomhad stór stór veicteoir). | knowledge:write |
knowledge_page_get | Faigh leathanach a craoladh lena ábhar markdown a innéacsadh don chatbot (úsáideach chun a fhíorú cad atá ar eolas ag an bot faoi leathanach). | knowledge:read |
knowledge_page_recrawl | Faigh leathanach a craoladh arís agus cuir ina áit a ábhar innéacsaithe (m.sh. | knowledge:write |
knowledge_pages_delete | Scrios roinnt leathanach a craoladh de chatbot in aon uair. | knowledge:write |
knowledge_pages_list | Liostaigh leathanach a craoladh i mbonn eolais chatbot, scagtha go roghnach de réir fearann, stádas nó téarma cuardaigh (URL/teideal). | knowledge:read |
knowledge_stats | Forbhreathnú ar bhonn eolais chatbot: doiciméid (de réir stádas, méid), leathanach a craoladh agus suíomhanna gréasáin (de réir stádas), poist crawl, treoracha croí roinnte de réir foinse (láimhe vs gníomhaire feabhsúcháin), FAQs, stádas/méid stór veicteoir agus úsáid stórála vs. | knowledge:read |
knowledge_website_delete | Scrios gach leathanach a craoladh de shuíomh (fearann) ón mbun eolais chatbot. | knowledge:write |
knowledge_website_recrawl | Athchraolaigh gach leathanach de shuíomh (fearann) i mbonn eolais chatbot chun a ábhar a athnuachan. | knowledge:write |
knowledge_website_recrawl_cancel | Cealú athchraoladh suíomh i mbun próiseála: filltear leathanaigh sanárthaithe (PENDING) ar a stádas innéacsaithe roimhe. | knowledge:write |
knowledge_websites_list | Liostaigh na suíomhanna gréasáin (fearainn) atá leathanacha iontu i mbonn eolais chatbot, le comhaireamh leathanaigh de réir stádas agus suimhní token. | knowledge:read |
Bainistíocht Praghais
Bainistíonn na huirlisí seo dréachtpraghsanna struchtúrtha agus faomhadh soiléir. Is rud ar leith é dréacht a shábháil ó fhomhadh an leagan cruinn; tá incháilitheacht ag brath freisin ar stádas agus bailíocht. Ní fhaigheann eochracha API atá ann cheana ceadanna praghais go huathoibríoch. Ní féidir prices:write nó prices:approve a thabhairt ach ag úinéir an chomhlachta. Rithfidh glaonna le eochair API láithreach, mar sin déan an ionchur cruinn a athbhreithniú sula nglaoimid ar athrú. Féach Prices & services don shruth oibre custaiméara.
| Tool | Description | Scope |
|---|---|---|
price_list | Leathanaigh ceannas praghais agus iarmhéid incháilitheachta leagan faofa. | prices:read |
price_get | Léigh staid iomlán mír agus athruithe. | prices:read |
price_detail | Léigh sonraí mír le stair athruithe páidiúnaithe. | prices:read |
price_suggestions_list | Leathanaigh moltaí praghais. | prices:read |
price_create | Cruthaigh dréacht le ID mír ginte ón bhfreastalaí. | prices:write |
price_edit | Cruthaigh dréacht nua ó leagan mír beartaithe go soiléir. | prices:write |
price_import_csv | Iompórtáil dréachtanna le formáid shoiléir agus ID iompórtála seasta le haghaidh athghlaonna sábháilte. | prices:write |
price_suggestion_apply | Cuir an moladh tosaíochta roghnaithe i bhfeidhm mar dréacht. | prices:write |
price_approve | Faomh leagan mír beartaithe go soiléir amháin. | prices:approve |
price_approve_many | Faomh roghnú ID/leagan soiléir go hadanach; diúltaítear don rogha iomlán má tá leagan seanbhailithe ann. | prices:approve |
price_archive | Achar mír ag a leagan beartaithe go soiléir a chartlannú. | prices:approve |
Coinnítear eagarthóireachtaí dréachta an leagan faofa roimhe. Ní mór foirmát CSV agus scaradóir deachúlach a bheith soiléir; éilítear ID iompórtála nua má athraíonn ábhar CSV. Tá gach oibríocht nasctha le comhlacht na heochair API agus an chatbot sonraithe.
Bainistíocht FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Glan sonraí taisce widget FAQ ar gach suíomh CMS nasctha (breiseán WordPress). | faqs:write |
faq_categories_list | Liostaigh catagóirí FAQ chatbot le comhaireamh FAQ, slugs, mód eagar agus aistriúcháin. | faqs:read |
faq_categories_reorder | Socraigh ord FAQ catagóirí sa widget: éireoidh suíomh i categoryIds mar sortOrder. | faqs:write |
faq_category_create | Cruthaigh catagóir FAQ do chatbot (gintear slug ón ainm). | faqs:write |
faq_category_delete | Scrios catagóir FAQ. | faqs:write |
faq_category_translations_update | Athsholáthar aistriúcháin catagóir FAQ, m.sh. | faqs:write |
faq_category_update | Athainmníonn catagóir FAQ nó athraigh a cur síos, deilbhín nó mód eagar. | faqs:write |
faq_create | Cruthaigh FAQ do chatbot. | faqs:write |
faq_delete | Scrios FAQ go buan (bainfidh sé é freisin as bonn eolais an chatbot agus glanfaidh sé taiscí widget CMS). | faqs:write |
faq_embed_code_get | Faigh slisnigh ionchlannaithe do widget FAQ: tag script, shortcode WordPress agus snippet Shopify Liquid, chomh maith le éagsúlachtaí in aghaidh catagóire (úsáid categorySlug ó faq_categories_list chun catagóir amháin a ionchlannú). | chatbots:read |
faq_get | Faigh na sonraí iomlána de FAQ: ceist, freagra, catagóir, stádas foilseacháin, ord eagar, aistriúcháin, réimsí SEO agus staitisticí aiseolais. | faqs:read |
faq_list | Liostaigh FAQs chatbot (úsáid chatbot_list chun chatbotId a fháil). | faqs:read |
faq_reorder | Socraigh ord taispeána FAQs sa widget. | faqs:write |
faq_suggestion_approve | Faomh moladh FAQ PENDING: cruthaítear FAQ foilsithe (roghnach le ceist/freagra/catagóir eedithe) agus marcálann sé an moladh mar APPROVED. | faqs:write |
faq_suggestion_get | Faigh na sonraí iomlána de mholadh FAQ (freagra iomlán, réasúnaíocht AI, catagóir molta, stádas athbhreithnithe). | faqs:read |
faq_suggestion_reject | Diúltaigh moladh FAQ PENDING le cúis roghnach. | faqs:write |
faq_suggestions_generate | Lig don AI moltaí FAQ nua a mholadh ó bhonn eolais an chatbot (leathanaigh a craoladh / doiciméid uaslódáilte), go roghnach do chatagóir amháin. | faqs:write |
faq_suggestions_list | Liostaigh moltaí FAQ a ghintear ag AI do chatbot (ó chomhráite nó faq_suggestions_generate). | faqs:read |
faq_translate | Aistrigh ceist agus freagra FAQ le AI go teangacha eile an chatbot (nó na targetLanguages tugtha) agus sábháil an toradh. | faqs:write |
faq_translations_update | Sábháil aistriúcháin FAQ in aghaidh teanga, m.sh. | faqs:write |
faq_update | Nuashonraigh ceist, freagra, catagóir, stádas foilseacháin nó ord eagar láimhe FAQ. | faqs:write |
faq_widget_settings_get | Faigh socruithe cuma agus iompair an widget FAQ ionchlannaithe (dathanna, radius imeall, teideal, spásáil, leithead uasta, allowMultipleOpen, autoOpenFirst, mód eagar, aistriúcháin teidil). | chatbots:read |
faq_widget_settings_update | Nuashonraigh socruithe widget FAQ: dathanna (hex), borderRadius 0-32, teideal (uasmhéid 100) + showTitle, spásáil compact|normal|relaxed, maxWidth 0-2000 (0 = leithead iomlán), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name agus aistriúcháin teidil in aghaidh na teanga. | chatbots:write |
Stair Comhrá & Aiseolas
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Marcáil comhrá mar athbhreithnithe gan é a rátáil (bainfidh sé é ón scuaine ar feitheamh, ní athróidh sé an scór muiníne). | chats:write |
chat_feedback_get | Faigh athbhreithniú comhrá amháin (aiseolas) le anailís AI, déine, catagóir muiníne, athrú scóir agus an seisiún feabhsúcháin nasctha. | chats:read |
chat_feedback_list | Liostaigh athbhreithnithe comhrá (rónta aiseolais) de chatbot le scagaire stádais agus comptóirí. | chats:read |
chat_feedback_set_severity | Sárshocrú an aicmíochta déine (MINOR|MODERATE|MAJOR|CRITICAL) de chomhrá diúltach a athbhreithíodh; tá meáchan déine ar titim scór muiníne. | chats:write |
chat_feedback_stats | Comtéamaí seisiún in aghaidh buicéad athbhreithnithe do chatbot (iomlán, níl, ar feitheamh, dearfach, diúltach, athbhreithnithe, feabhsaithe) — na cártaí staitisticí ar leathanach comhráite an dashboard. | chats:read |
chat_feedback_submit | Rátáil seisiún comhrá mar Maith (isPositive=true) nó Teastaíonn Obair (isPositive=false). | chats:write |
chat_session_get | Faigh seisiún comhrá le trascríbhinn iomlán (in aghaidh theachtaireacht token/model/latency/pageUrl), sonraí cuairteora, URL an leathanaigh thosaigh, catagóir muiníne, aiseolas (déine, anailís AI, seisiún feabhsúcháin nasctha) agus lipéid. | chats:read |
chat_session_search | Cuardaigh seisiún comhrá de chatbot de réir ábhar teachtaireachta agus/nó ríomhphost cuairteora. | chats:read |
chat_session_set_category | Cuireann nó athraíonn catagóir muiníne seisiún comhrá (ceartóidh sé aicmithe AI; ríomhtar muinín in aghaidh catagóire nuair a rinneadh an comhrá a athbhreithniú). | chats:write |
chat_sessions_list | Liostaigh seisiún comhrá de chatbot, is nuaí ar dtús, leis na scagairí scuaine athbhreithnithe céanna leis an leathanach comhráite sa dashboard. | chats:read |
Gníomhaire Feabhsúcháin
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Liostaigh catagóirí muiníne chatbot le scór muiníne in aghaidh catagóire, comhaireamh athbhreithnithe agus min rithe r-phoist athbhreithnithe. | chats:read |
confidence_category_create | Cruthaigh catagóir muiníne do chatbot. | chatbots:write |
confidence_category_delete | Scrios catagóir muiníne. | chatbots:write |
confidence_category_merge | Comhcheangail catagóir muiníne amháin isteach in ceann eile den chatbot céanna: bogann gach comhrá/athbhreithniú chuig an sprioc, scriostar an fhoinse agus ríomhfar scóir arís. | chatbots:write |
confidence_category_update | Athainmníonn catagóir muiníne agus/nó socraíonn minicíocht r-phoist athbhreithnithe (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 ach do HOURLY). | chatbots:write |
confidence_status_get | Stádas muiníne chatbot: scór, teorainn céimniú, brata foghlama, iompair céim foghlama (CAUTIOUS|BALANCED|CONFIDENT) agus spreagadh saincheaptha, comhaireamh athbhreithnithe agus scóir muiníne in aghaidh catagóire. | analytics:read |
improvement_proposal_approve | Faomh moladh feabhsúcháin PENDING agus cuir an t-athrú i bhfeidhm ar an chatbot (treoir chroí a chur leis/núasghrádú, FAQ a chruthú/nuashonrú nó pearsona a nuashonrú) — an loighic agus teorainneacha plean céanna leis an dashboard. | chatbots:write |
improvement_proposal_reject | Diúltaigh moladh feabhsúcháin PENDING. | chatbots:write |
improvement_proposal_simulate | Samhlaigh conas a fhreagródh an chatbot don teachtaireacht fhadhbacha le moladh curtha i bhfeidhm (bunaidh vs. | chatbots:write |
improvement_proposals_pending | Liostaigh moltaí feabhsúcháin ag fanacht le hathbhreithniú (stádas PENDING) trasna an chomhlachta nó do chatbot amháin. | chatbots:read |
improvement_session_complete | Marcáil seisiún feabhsúcháin mar COMPLETED (an comhrá ansin á líonadh mar Feabhsaithe sa scuaine athbhreithnithe). | chatbots:write |
improvement_session_create | Oscail an Gníomhaire Feabhsúcháin do chomhrá a rátáil Teastaíonn Obair. | chatbots:write |
improvement_session_get | Faigh seisiún feabhsúcháin le an comhrá bunaidh (tá teachtaireachtaí le innéacs 1-bhunúsach inúsáidte mar targetMessageIndex), comhrá an ghníomhaire, gach moladh (le a shimulation is déanaí) agus samhlacha. | chatbots:read |
improvement_session_reset | Athsheol seisiún feabhsúcháin: scriosann sé gach teachtaireacht ghníomhaire, samhlacha agus moltaí PENDING/REJECTED (coinneofar na curtha i bhfeidhm) agus tosaíonn comhrá úr. | chatbots:write |
improvement_session_send_message | Seol teachtaireacht chuig an Gníomhaire Feabhsúcháin (míníodh cad a bhí mícheart leis an fhreagra a d'fhéadfadh an bot; roghnach targetMessageIndex = innéacs 1-bhunúsach den teachtaireacht bot i originalChat.messages). | chatbots:write |
improvement_sessions_list | Liostaigh seisiúin feabhsúcháin (comhráite Gníomhaire Feabhsúcháin a thosaíodh ó athbhreithnithe comhrá diúltacha) do chatbot nó do chuideachta ar fad, is nuaí ar dtús, le comhaire moltaí. | chatbots:read |
improvement_simulation_assess | Rátáil toradh samhail: isApproved=true nuair atá an freagra samhlaithe go maith (is féidir an moladh ansin a chur i bhfeidhm), false nuair a theastaíonn tuilleadh oibre (tuairim 'almost' = beagnach ceart). | chatbots:write |
Comhrá Bheo
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Faigh infhaighteacht comhrá beo an úsáideora féin, na gníomhairí atá ar fáil faoi láthair do chomhrá beo (croí-beat úr, an comhartha céanna a úsáideann an widget) agus an bhfuil comhrá beo san áireamh i bplean an chomhlachta. | chats:read |
live_chat_heartbeat | Athnuachan croí-beat láithreacht comhrá beo an úsáideora reatha (ach amháin nuair atá sé marcáilte mar infhaighte via live_chat_set_availability). | chats:write |
live_chat_message_send | Seol teachtaireacht chuig an gcuairteoir mar an gníomhairí ainmnithe. | chats:write |
live_chat_queue | Faigh scuaine comhrá beo: seisiún ag fanacht le gníomhaire, is sine ar dtús (FIFO). | chats:read |
live_chat_session_assign | Glac seisiún comhrá beo WAITING ón scuaine: sannann sé don úsáideoir reatha (úinéir comhlachta do eochracha API) agus fógraíonn sé don chuairteoir go ndeachaigh an gníomhaire isteach. | chats:write |
live_chat_session_close | Críochnaigh seisiún comhrá beo mar ghníomhairí (aon bhall nach VIEWER den chomhlacht). | chats:write |
live_chat_session_get | Faigh seisiún comhrá beo le faisnéis cuairteora, gníomhaí ainmnithe, gach teachtaireacht agus an comhrá bot roimhe seo (comhthéacs lámh-thóin). | chats:read |
live_chat_sessions_list | Liostaigh seisiúin comhrá beo (is nuaí ar dtús; seisiúin WAITING is sine ar dtús) le scagairí roghnach de réir chatbot, stádas agus gníomhaí ainmnithe. | chats:read |
live_chat_set_availability | Casann an lasc 'Available for Live Chat' an úsáideora reatha do chomhlacht. | chats:write |
Luaidhe
| Tool | Description | Scope |
|---|---|---|
lead_assign | Sann luaidhe do bhall comhlachta nó déan dí-sann é (assignedToId: null). | leads:write |
lead_bulk_update_status | Socraigh stádas roinnt luaidhe (uasmhéid 100) ag an am. | leads:write |
lead_categories_list | Liostaigh catagóirí luaidhe chatbot le comhaireamh luaidhe agus na baill foirne a fógraíodh in aghaidh catagóire. | leads:read |
lead_category_assign_user | Cuir ball comhlachta leis an liosta fógraíochta catagóir luaidhe (nó nuashonraigh a bflags fógraíochta). | leads:write |
lead_category_create | Cruthaigh catagóir luaidhe do chatbot. | leads:write |
lead_category_delete | Scrios catagóir luaidhe. | leads:write |
lead_category_remove_user | Bain ball comhlachta as liosta fógraíochta catagóir luaidhe. | leads:write |
lead_category_update | Nuashonraigh ainm, cur síos agus/nó dath catagóir luaidhe. | leads:write |
lead_create | Cruthaigh luaidhe de láimh (m.sh. | leads:write |
lead_delete | Scrios luaidhe go buan. | leads:write |
lead_field_config_get | Faigh cumraíocht ghabhdála luaidhe chatbot: réimsí (ids mapa chuig eochracha i lead.data), teachtaireacht dearbhaithe, aistriúcháin réimse/UI agus socruithe aithint AI. | leads:read |
lead_field_config_update | Nuashonraigh cumraíocht ghabhdála luaidhe chatbot. | leads:write |
lead_get | Faigh sonraí iomlána luaidhe lena shannadh, catagóir agus trascríbhinn an chomhrá foinse (páidithe le messageOffset/messageLimit, réamhshocraithe na chéad 20 teachtaireacht). | leads:read |
lead_list | Liostaigh luaidhe chatbot (is nuaí ar dtús) le scagairí roghnach de réir stádas, catagóir, assignee agus cuardach téacs saor (ainm/ríomhphost/comhlacht). | leads:read |
lead_stats | Faigh staitisticí luaidhe do chatbot: comhaireanna de réir stádas, luaidhe na 7 lá deireanaí agus ráta tiontaithe (céatadán). | leads:read |
lead_update | Nuashonraigh stádas, catagóir, nótaí, sonraí ghabhdaithe agus/nó assignee luaidhe. | leads:write |
Foirmeacha
| Tool | Description | Scope |
|---|---|---|
form_create | Cruthaigh foirm teag contact do chatbot (bunúsacha, réimsí, dearadh agus socruithe spam i gcéad glao amháin). | forms:write |
form_delete | Scrios foirm teag contact go buan agus GACH a cúrsálacha (cascade). | forms:write |
form_get | Faigh foirm teag contact ina hiomlán: réimsí, aistriúcháin, stíliú, socruithe spam, stádas réidh, comhaireamh cúrsála agus an tag script ionchlannaithe (embedCode). | forms:read |
form_list | Liostaigh foirmeacha teag contact chatbot le comhaire réimse, comhaire cúrsála agus códanna ionchlannaithe. | forms:read |
form_stats | Comhaire cúrsála foirme teag contact: iomlán, ar feitheamh, ceadaithe, spam agus diúltaithe. | forms:read |
form_submission_delete | Scrios cúrsáil foirme teag contact go buan (m.sh. | forms:write |
form_submission_get | Faigh cúrsáil foirme teag contact ina hiomlán: sonraí réimse a cuireadh isteach, scór spam agus anailís spam AI, metadata IP/user agent/referrer agus faisnéis athbhreithnithe. | forms:read |
form_submission_update_status | Athbhreithnigh cúrsáil foirme teag contact: socraigh a stádas go APPROVED, SPAM nó REJECTED le nóta athbhreithnithe roghnach. | forms:write |
form_submissions_list | Liostaigh cúrsálacha foirme, is nuaí ar dtús, go roghnach scagtha de réir stádas (PENDING, APPROVED, SPAM, REJECTED) agus dáta cruthaithe. | forms:read |
form_update | Nuashonraigh foirm teag contact: ainm, cur síos, stádas gníomhach (isActive riallaíonn an ionchlannú má léirítear é), réimsí (athsholáthar iomlán), dearadh (dathanna, téacs cnaipe, teachtaireacht rathúnais) agus socruithe spam (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Athsholáthar réimse agus/nó aistriúcháin UI foirme teag contact. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Liostaigh log gníomhaíochta ríomhphoist phróiseáilte nasc bosca poist (is nuaí ar dtús): seolta, ábhar, catagóir ainmniúcháin, toradh (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) agus outcomeDetail. | email:read |
email_categories_list | Liostaigh catagóirí ríomhphoist nasc bosca poist (ordaithe de réir sortOrder). | email:read |
email_category_create | Cruthaigh catagóir ríomhphoist do nasc bosca poist (uasmhéid 20 in aghaidh an nasc). | email:write |
email_category_delete | Scrios catagóir ríomhphoist. | email:write |
email_category_update | Nuashonraigh catagóir ríomhphoist (páirteach: athraítear ach na réimsí tugtha). | email:write |
email_connection_disconnect | Dícheangail bosca poist go buan. | email:write |
email_connection_get | Faigh nasc bosca poist incl. | email:read |
email_connection_update | Nuashonraigh nasc bosca poist: móide/athnua an sintéise (paused true/false; aistríonn sé ACH ACTIVE<->DISABLED, ní sáraíonn sé TOKEN_EXPIRED/ERROR), cas ar dréachtú freagra (draftingEnabled) agus catagóiriú/eagrú (organizingEnabled), athaird an chatbot cumhachtach (chatbotId den chomhlacht céanna) nó socraigh síniú freagra HTML (signatureHtml, uasmhéid 20000 carachtair; glanann stríng fhánach é). | email:write |
email_connections_list | Liostaigh nascanna bosca poist Email Assistant an chomhlachta (seoladh, stádas ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, an t-am sync deireanach, earráid dheireanach, lascáin dréachtaithe/eagraithe, chatbot cumhachtach, draftReadyCategoryCount = catagóirí a d'fhéadfadh dréacht a tháirgeadh, baseRuleCount = rialacha "Chat + Email" ar fud an chatbot i bhfeidhm ar gach dréacht) le teorainneacha an phlean (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Scrios teagmhála ríomhphoist fhoghlaithe (dearmad an próifíl seoltaí, m.sh. | email:write |
email_contact_get | Faigh teagmháil ríomhphoist fhoghlaithe le gach fíric foghlaithe, nótaí inmheánacha, caidreamh, socrú seoladh foirmiúil/neofoirmiúil agus staitisticí ríomhphoist. | email:read |
email_contact_update | Nuashonraigh teagmháil ríomhphoist fhoghlaithe. | email:write |
email_contacts_list | Liostaigh teagmhálacha ríomhphoist foghlaithe an chomhlachta (an r-phost is déanaí ar dtús) le caidreamh, seoladh foirmiúil/neofoirmiúil (formalAddress: true = seoladh foirmiúil 'Sie', false = neamhfhoirmiúil 'Du', null = uathoibríoch), comhaireamh fíricí agus réamhamharc nótaí. | email:read |
email_folder_create | Cruthaigh fillteán ríomhphoist faoin inbox (taispeánann an ceann atá ann má tá an t-ainm tógtha) le húsáid mar sprioc bogadh catagóir. | email:write |
email_folders_list | Liostaigh na fillteáin is féidir le catagóir ríomhphoist ríomhphoist a aistriú isteach iontu, beo ón mbosca poist: fo-fillteáin inbox, fillteáin uachtarleibhéil saincheaptha, cartlann, spam agus truflais (id 'deleteditems'). | email:read |
email_general_rules_list | Liostaigh na rialacha ar fud an chatbot a bhaineann le gach dréacht freagra ríomhphoist: treoracha croí gníomhacha le channel BOTH ("Chat + Email"), plus treoracha seanaimseartha ríomhphoist atá fós le hinimiriú i gcatagóir. | email:read |
Anailísíocht
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Toir comhrá (seisiúin tosaithe) thar am do chairteacha agus treochtaí: tréimhse week/month/quarter/year, garántúlachta hour/day/week/month, go roghnach do chatbot amháin. | analytics:read |
analytics_chatbot_stats | Feidhmíocht in aghaidh gach chatbot do chomhlacht i nglao amháin (tábla feidhmíochta chatbot sa dashboard): id, ainm, slug, isActive, seisiúin, teachtaireachtaí, FAQs agus luaidhe in aghaidh chatbot, rioscáilte de réir seisiún. | analytics:read |
analytics_forms | Staitisticí cúrsála foirm teag do chomhlacht nó chatbot amháin (widet anailíse dashboard): cúrsálacha de réir stádas (pending/approved/rejected/spam), líon foirmí, iomlán, ráta spam i gcéadán agus an tsraith cúrsálacha-in aghaidh-lá na 7 lá deireanacha. | analytics:read |
analytics_leads | Ualach luaidhe do chomhlacht nó chatbot amháin (widet anailíse dashboard): luaidhe de réir stádas (new/contacted/qualified/converted/lost), iomlán, ráta tiontaithe i gcéadán agus an tsraith luaidhe-in aghaidh-lá na 7 lá deireanacha. | analytics:read |
analytics_overview | Forbhreathnú anailíse do chomhlacht nó chatbot amháin: comhráite, teachtaireachtaí, ráta sástachta agus ceisteanna barr do thréimhse rothlach (day/week/month/year), plus widet forbhreathnaithe an dashboard (iomlán chatbots/FAQs foilseáilte/luaidhe, seisiúin inniu/an tseachtain/an mhí, luaidhe inniu/an tseachtain, cúrsálacha foirm iomlán/inniu/ar feitheamh). | analytics:read |
dashboard_activity | Cad a theastaíonn air faoi láthair (radharc baile dashboard): in aghaidh an chomhlachta, na chatbots le luaidhe nua inniu, moltaí FAQ ar feitheamh, cúrsálacha foirme ar feitheamh, comhráite beo ag fanacht/ghníomhach nó céim foghlama ar siúl. | any |
Samhlacha Sreafaí Oibre
Treoir Chroí a Chur Leis
Iarr ar do chúntóir AI:
"Cuir treoir chroí le mo chatbot 'Support Bot': tairgimid loingseoireacht saor in aisce ar orduithe thar €50"
Úsáidfidh an cúntóir chatbot_add_instruction leis na paraiméadair chuí.
Athbhreithniú Moltaí Feabhsúcháin
"Taispeáin dom na moltaí feabhsúcháin ar feitheamh do mo chatbot agus mínigh na hathruithe a mholann siad"
Déanfaidh an cúntóir:
improvement_proposals_pendinga úsáid chun moltaí a fheiceáil- Anailís agus achoimriú a dhéanamh ar gach moladh
- Faomhadh nó diúltú dóibh thar do shon le
improvement_proposal_approvenóimprovement_proposal_reject
Anailísíocht Feidhmíochta Comhrá
"Tabhair tuarascáil seachtainiúil ar thóir comhrá agus sásamh custaiméara do mo chatbot"
Úsáidfidh an cúntóir analytics_overview agus analytics_chat_volume chun tuarascáil chuimsitheach a chur le chéile.
Suíomh Gréasáin a Iompórtáil
"Scan https://example.com, iompórtáil na leathanaigh táirgí agus praghsála isteach i mo 'Support Bot' agus inis dom nuair a bheidh an crawl críochnaithe"
Glaofaidh an cúntóir crawler_preview_scan, roghnóidh sé na leathanaigh ábhartha, tosóidh an iompórtáil le crawler_start agus poll crawler_job_get go dtí go mbeidh an post críochnaithe.
Luaidhe agus Cúrsálacha Foirme a Athbhreithniú
"Taispeáin dom na luaidhe nua ón seachtain seo, sann na cinn cáilithe go Anna agus faomh na cúrsálacha foirme teag ar feitheamh"
Comhcheanglaíonn an cúntóir lead_list, lead_assign, form_submissions_list agus form_submission_update_status.
Glacadh le Comhrá Bheo
"Cuir mé ar fáil do chomhrá beo agus glac an comhrá is sine atá ag fanacht"
Úsáidfidh an cúntóir live_chat_set_availability, live_chat_queue agus live_chat_session_assign; téann freagraí tríd live_chat_message_send.
Slándáil
- Tá eochracha API scóipithe do do chomhlacht agus don réimsí ceadúnais a roghnaíonn tú nuair a chruthaíonn tú iad (féach colún an Scope thuas)
- Rithfidh eochracha le ceadanna úinéara an chomhlachta; tá teorainneacha plean agus geataí gné i bhfeidhm go díreach mar atá sa dashboard
- Is féidir eochracha a chealú ag am ar bith ón dashboard
- Tá rochtain API ar fáil ar phleananna íoctha — féach ar ár leathanach Praghsála
Eolas Fadhbacha
Teip Ceangail
- Dearbhaigh go bhfuil do eochair API ceart
- Seiceáil nach bhfuil an eochair cealaithe
- Bí cinnte go bhfuil do phlean ag cuimsíonn rochtain API
- Athchealraigh do chliaint MCP
Uirlis Níor Aimsíodh
Athchealraigh do chliaint MCP tar éis an chumraíocht a athrú ionas go luchtóidh siad na huirlisí ar fáil arís. Tá ainmneacha uirlisí i gcaighdeán ísealliotáin le sousvre: underscores (m.sh., faq_list).
An gá cabhrach? Déan teagmháil lenár bhfoireann tacaíochta →