MCP Server Integration
ChatReact izvaja Model Context Protocol (MCP), kar vam omogoča povezavo vašega ChatReact računa z AI asistenti, kot so Claude Desktop, Cursor in druga orodja, združljiva z MCP.
Kaj je MCP?
Model Context Protocol je odprt standard, ki omogoča AI asistentom interakcijo z zunanjimi storitvami in viri podatkov. Z MCP integracijo ChatReact lahko:
- Upravljate chatbot-e — posodobite navodila, osebnost in nastavitve widgeta
- Ustvarjate in posodabljate pogosta vprašanja (FAQ) z naravnim jezikom
- Ogledate si analitiko, zgodovino pogovorov in kontakte (leads)
- Pregledate predloge Improvement Agenta ter jih odobrite ali zavrnete
- Spremljate seje v živo in čakalno vrsto
Začetek
1. Ustvarite API ključ
- Pojdite na vaš Dashboard → Company → zavihek API
- Kliknite Create API Key
- Poimenujte ključ z opisnim imenom (npr. "Claude Desktop") in izberite vsaj eno dovoljenje
- Kopirajte ustvarjeni ključ (se začne z
cr_)
API keys so na voljo v plačljivih paketih — glejte našo Pricing page.
Shranite vaš API ključ varno. Po ustvarjanju ga ni mogoče pridobiti nazaj.
2. Konfigurirajte svoj MCP klient
ChatReact MCP strežnik je gostovan na https://www.chatreact.ai/api/mcp in komunicira preko HTTP (JSON-RPC). Avtentikacija poteka z glavo Authorization: Bearer — sprejet je tudi naslov z glavo X-API-Key z istim ključem.
Cursor IDE
Cursor neposredno podpira oddaljene MCP strežnike. Dodajte v vaše Cursor MCP nastavitve:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Konfiguracijska datoteka Claude Desktop podpira strežnike na osnovi ukazov, zato uporabite standardni most mcp-remote, da se povežete na gostujoči endpoint:
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"
]
}
}
}
Ta postavitev zahteva nameščen Node.js. Primer uporablja glavo X-API-Key, ker nekateri klienti ne obdelajo presledkov v argumentih zanesljivo.
3. Ponovno zaženite vaš AI asistenta
Po shranjevanju konfiguracije ponovno zaženite Claude Desktop ali Cursor, da vzpostavite povezavo.
Na voljo orodja
ChatReact MCP zagotavlja obsežen nabor orodij, razporejenih v kategorije:
Vaš račun
| Tool | Description |
|---|---|
user_profile | Pridobi informacije o vašem profilu |
user_companies | Navedite podjetje, za katerega je vaš API ključ dodeljen |
user_notifications | Pridobi vaše zadnje obvestila |
Upravljanje podjetja in ekipe
| Tool | Description |
|---|---|
company_list | Navedite podjetje, za katerega je vaš API ključ dodeljen |
company_get | Pridobi podrobnosti o določenem podjetju |
company_members_list | Navedite člane podjetja z njihovimi vlogami |
company_chatbots_list | Navedite vse chatbote za podjetje |
company_update | Posodobite ime podjetja, opis ali nastavitve |
Upravljanje chatbotov
| Tool | Description |
|---|---|
chatbot_list | Navedite vse chatbote s povzetnimi statistikami |
chatbot_get | Pridobi podrobnosti in konfiguracijo chatbota |
chatbot_get_instructions | Pridobi osnovna navodila za chatbota |
chatbot_add_instruction | Dodajte novo osnovno navodilo |
chatbot_update_instruction | Posodobite obstoječe osnovno navodilo |
chatbot_delete_instruction | Izbrišite osnovno navodilo |
chatbot_update_personality | Posodobite ton, jezik in sporočila |
chatbot_toggle_active | Aktivirajte ali deaktivirajte chatbota |
chatbot_toggle_learning | Omogočite ali onemogočite fazo učenja |
widget_settings_get | Pridobi trenutne nastavitve widgeta |
widget_settings_update | Posodobite videz widgeta (barve, velikost, položaj) |
Upravljanje FAQ
| Tool | Description |
|---|---|
faq_list | Navedite vsa pogosta vprašanja za chatbota |
faq_get | Pridobi podrobnosti FAQ |
faq_create | Ustvarite novo FAQ |
faq_update | Posodobite obstoječi FAQ |
faq_delete | Izbrišite FAQ |
faq_categories_list | Navedite kategorije FAQ |
faq_suggestions_list | Navedite čakajoče predloge FAQ, ustvarjene iz pogovorov |
Znanje (Knowledge Base)
| Tool | Description |
|---|---|
knowledge_documents_list | Navedite dokumente v bazi znanja chatbota |
knowledge_document_get | Pridobi podrobnosti o določenem dokumentu |
knowledge_document_delete | Izbrišite dokument iz baze znanja |
knowledge_stats | Pridobi statistiko baze znanja |
Crawling spletnih strani se upravlja iz nadzorne plošče — glejte Knowledge Base.
Upravljanje lead-ov
| Tool | Description |
|---|---|
lead_list | Navedite lead-e z možnostjo filtriranja po statusu ali kategoriji |
lead_get | Pridobi popolne podrobnosti leada vključno z izvorno sejo pogovora |
lead_update | Posodobite status leada, kategorijo ali zapiske |
lead_delete | Trajno izbrišite leada |
lead_categories_list | Navedite kategorije lead-ov |
lead_stats | Pridobi statistiko lead-ov, vključno s številom po statusih |
lead_field_config_get | Pridobi konfiguracijo polj za zajem lead-ov |
Zgodovina pogovorov
| Tool | Description |
|---|---|
chat_sessions_list | Navedite seje pogovorov z možnostjo filtrov |
chat_session_get | Pridobi sejo pogovora z vsemi sporočili |
chat_session_search | Iščite seje pogovorov po vsebini sporočil ali informacijah obiskovalca |
Analitika
| Tool | Description |
|---|---|
analytics_overview | Pridobi število pogovorov, število sporočil in stopnje zadovoljstva |
analytics_chat_volume | Pridobi obseg pogovorov skozi čas za grafikone in trende |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Navedite seje izboljšav |
improvement_session_get | Pridobi podrobnosti seje vključno s predlogi |
improvement_proposals_pending | Navedite čakajoče predloge, ki čakajo na pregled |
improvement_proposal_approve | Odobrite predlog in uporabite spremembo |
improvement_proposal_reject | Zavrnete predlog |
Live Chat
| Tool | Description |
|---|---|
live_chat_sessions_list | Navedite seje live chata |
live_chat_session_get | Pridobi sejo live chata z vsemi sporočili |
live_chat_queue | Pridobi seje, ki čakajo na agenta |
Orodja za live chat so samo za branje. Za neposredno komunikacijo z obiskovalci uporabite nadzorno ploščo Live Chat.
Primeri potekov dela
Dodajanje osnovnega navodila
Vprašajte vaš AI asistent:
"Dodajte osnovno navodilo v moj chatbot 'Support Bot': nudimo brezplačno poštnino za naročila nad €50"
Asistent bo uporabil chatbot_add_instruction z ustreznimi parametri.
Pregled predlogov izboljšav
"Pokaži mi vse čakajoče predloge za izboljšave za mojega chatbota in pojasni, kakšne spremembe predlagajo"
Asistent bo:
- Uporabil
improvement_proposals_pendingza pridobitev predlogov - Analiziral in povzel vsako sugestijo
- Na vaše mesto odobril ali zavrgel predloge z
improvement_proposal_approvealiimprovement_proposal_reject
Analiza uspešnosti pogovorov
"Daj mi tedensko poročilo o obsegu pogovorov in zadovoljstvu strank za mojega chatbota"
Asistent bo uporabil analytics_overview in analytics_chat_volume, da pripravi celovito poročilo.
Varnost
- API ključi so omejeni na vaše podjetje
- Ključe lahko kadar koli razveljavite iz nadzorne plošče
- Dostop do API-ja je na voljo v plačljivih paketih — glejte našo Pricing page
Odpravljanje težav
Povezava spodletela
- Preverite, ali je vaš API ključ pravilen
- Preverite, da ključ ni razveljavljen
- Prepričajte se, da vaš paket vključuje dostop do API-ja
- Ponovno zaženite vaš MCP klient
Orodje ni najdeno
Po spremembi konfiguracije ponovno zaženite vaš MCP klient, da znova naloži razpoložljiva orodja. Imena orodij so z malo začetnico in podčrtaji (npr. faq_list).
Potrebujete pomoč? Kontaktirajte našo podporo →