DomovDokumentacija

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č

  1. Pojdite na vaš DashboardCompany → zavihek API
  2. Kliknite Create API Key
  3. Poimenujte ključ z opisnim imenom (npr. "Claude Desktop") in izberite vsaj eno dovoljenje
  4. 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

ToolDescription
user_profilePridobi informacije o vašem profilu
user_companiesNavedite podjetje, za katerega je vaš API ključ dodeljen
user_notificationsPridobi vaše zadnje obvestila

Upravljanje podjetja in ekipe

ToolDescription
company_listNavedite podjetje, za katerega je vaš API ključ dodeljen
company_getPridobi podrobnosti o določenem podjetju
company_members_listNavedite člane podjetja z njihovimi vlogami
company_chatbots_listNavedite vse chatbote za podjetje
company_updatePosodobite ime podjetja, opis ali nastavitve

Upravljanje chatbotov

ToolDescription
chatbot_listNavedite vse chatbote s povzetnimi statistikami
chatbot_getPridobi podrobnosti in konfiguracijo chatbota
chatbot_get_instructionsPridobi osnovna navodila za chatbota
chatbot_add_instructionDodajte novo osnovno navodilo
chatbot_update_instructionPosodobite obstoječe osnovno navodilo
chatbot_delete_instructionIzbrišite osnovno navodilo
chatbot_update_personalityPosodobite ton, jezik in sporočila
chatbot_toggle_activeAktivirajte ali deaktivirajte chatbota
chatbot_toggle_learningOmogočite ali onemogočite fazo učenja
widget_settings_getPridobi trenutne nastavitve widgeta
widget_settings_updatePosodobite videz widgeta (barve, velikost, položaj)

Upravljanje FAQ

ToolDescription
faq_listNavedite vsa pogosta vprašanja za chatbota
faq_getPridobi podrobnosti FAQ
faq_createUstvarite novo FAQ
faq_updatePosodobite obstoječi FAQ
faq_deleteIzbrišite FAQ
faq_categories_listNavedite kategorije FAQ
faq_suggestions_listNavedite čakajoče predloge FAQ, ustvarjene iz pogovorov

Znanje (Knowledge Base)

ToolDescription
knowledge_documents_listNavedite dokumente v bazi znanja chatbota
knowledge_document_getPridobi podrobnosti o določenem dokumentu
knowledge_document_deleteIzbrišite dokument iz baze znanja
knowledge_statsPridobi statistiko baze znanja

Crawling spletnih strani se upravlja iz nadzorne plošče — glejte Knowledge Base.

Upravljanje lead-ov

ToolDescription
lead_listNavedite lead-e z možnostjo filtriranja po statusu ali kategoriji
lead_getPridobi popolne podrobnosti leada vključno z izvorno sejo pogovora
lead_updatePosodobite status leada, kategorijo ali zapiske
lead_deleteTrajno izbrišite leada
lead_categories_listNavedite kategorije lead-ov
lead_statsPridobi statistiko lead-ov, vključno s številom po statusih
lead_field_config_getPridobi konfiguracijo polj za zajem lead-ov

Zgodovina pogovorov

ToolDescription
chat_sessions_listNavedite seje pogovorov z možnostjo filtrov
chat_session_getPridobi sejo pogovora z vsemi sporočili
chat_session_searchIščite seje pogovorov po vsebini sporočil ali informacijah obiskovalca

Analitika

ToolDescription
analytics_overviewPridobi število pogovorov, število sporočil in stopnje zadovoljstva
analytics_chat_volumePridobi obseg pogovorov skozi čas za grafikone in trende

Improvement Agent

ToolDescription
improvement_sessions_listNavedite seje izboljšav
improvement_session_getPridobi podrobnosti seje vključno s predlogi
improvement_proposals_pendingNavedite čakajoče predloge, ki čakajo na pregled
improvement_proposal_approveOdobrite predlog in uporabite spremembo
improvement_proposal_rejectZavrnete predlog

Live Chat

ToolDescription
live_chat_sessions_listNavedite seje live chata
live_chat_session_getPridobi sejo live chata z vsemi sporočili
live_chat_queuePridobi 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:

  1. Uporabil improvement_proposals_pending za pridobitev predlogov
  2. Analiziral in povzel vsako sugestijo
  3. Na vaše mesto odobril ali zavrgel predloge z improvement_proposal_approve ali improvement_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

  1. Preverite, ali je vaš API ključ pravilen
  2. Preverite, da ključ ni razveljavljen
  3. Prepričajte se, da vaš paket vključuje dostop do API-ja
  4. 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 →