PočetnaDokumentacija

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 drugih alata kompatibilnih s MCP-om.

Što je MCP?

Model Context Protocol je otvoreni standard koji omogućuje AI asistentima interakciju s vanjskim uslugama i izvorima podataka. S MCP integracijom ChatReact-a možete:

  • Upravljati chatbotovima — ažurirati upute, osobnost i postavke widgeta
  • Kreirati i ažurirati FAQ-ove koristeći prirodni jezik
  • Pregledavati analitiku, povijest razgovora i potencijalne klijente (leads)
  • Pregledavati prijedloge Improvement Agenta i odobravati ili odbijati ih
  • Nadzor uživo chat sesija i reda čekanja

Početak rada

1. Generirajte API ključ

  1. Idite na vaš DashboardCompany → kartica API
  2. Kliknite Create API Key
  3. Dajte ključu opisno ime (npr. "Claude Desktop") i odaberite barem jednu dozvolu
  4. Kopirajte generirani ključ (počinje s cr_)

API keys su dostupni na plaćenim planovima — pogledajte našu Pricing page.

Pohranite vaš API ključ sigurno. Ne može se dohvatiti nakon stvaranja.

2. Konfigurirajte vaš MCP klijent

ChatReact MCP server je hostan na https://www.chatreact.ai/api/mcp i komunicira preko HTTP-a (JSON-RPC). Autentifikacija se vrši s headerom Authorization: Bearer — prihvaća se i header X-API-Key s istim ključem.

Cursor IDE

Cursor podržava udaljene MCP servere izravno. Dodajte sljedeće 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 komandama, stoga 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 konfiguracija zahtijeva instaliran Node.js. Primjer koristi header X-API-Key jer neki klijenti ne rukuju pouzdano razmacima u argumentima.

3. Ponovno pokrenite vaš AI asistenta

Nakon spremanja konfiguracije, ponovno pokrenite Claude Desktop ili Cursor kako biste uspostavili vezu.

Dostupni alati

ChatReact MCP pruža sveobuhvatan skup alata organiziranih u kategorije:

Vaš račun

ToolDescription
user_profileDohvati informacije o vašem profilu
user_companiesPopis tvrtke na koju je vaš API ključ ograničen
user_notificationsDohvati vaše nedavne obavijesti

Upravljanje tvrtkom i timom

ToolDescription
company_listPopis tvrtke na koju je vaš API ključ ograničen
company_getDohvati detalje o određenoj tvrtki
company_members_listPopis članova tvrtke s njihovim ulogama
company_chatbots_listPopis svih chatbotova za tvrtku
company_updateAžuriraj ime tvrtke, opis ili postavke

Upravljanje chatbotom

ToolDescription
chatbot_listPopis svih chatbotova sa sažetim statistikama
chatbot_getDohvati detalje i konfiguraciju chatbota
chatbot_get_instructionsDohvati osnovne upute za chatbota
chatbot_add_instructionDodaj novu osnovnu uputu
chatbot_update_instructionAžuriraj postojeću osnovnu uputu
chatbot_delete_instructionIzbriši osnovnu uputu
chatbot_update_personalityAžuriraj ton, jezik i poruke
chatbot_toggle_activeAktiviraj ili deaktiviraj chatbota
chatbot_toggle_learningOmogući ili onemogući fazu učenja
widget_settings_getDohvati trenutne postavke widgeta
widget_settings_updateAžuriraj izgled widgeta (boje, veličina, položaj)

Upravljanje FAQ-ovima

ToolDescription
faq_listPopis svih FAQ-ova za chatbota
faq_getDohvati detalje FAQ-a
faq_createKreiraj novi FAQ
faq_updateAžuriraj postojeći FAQ
faq_deleteIzbriši FAQ
faq_categories_listPopis kategorija FAQ-ova
faq_suggestions_listPopis na čekanju FAQ prijedloga generiranih iz razgovora

Baza znanja

ToolDescription
knowledge_documents_listPopis dokumenata u bazi znanja chatbota
knowledge_document_getDohvati detalje određenog dokumenta
knowledge_document_deleteIzbriši dokument iz baze znanja
knowledge_statsDohvati statistike baze znanja

Crawlanje web stranica upravlja se iz dashboarda — vidi Knowledge Base.

Upravljanje leadovima

ToolDescription
lead_listPopis leadova s opcionalnim filtriranjem po statusu ili kategoriji
lead_getDohvati potpune detalje leada uključujući izvor chat sesije
lead_updateAžuriraj status leada, kategoriju ili bilješke
lead_deleteTrajno izbriši lead
lead_categories_listPopis kategorija leadova
lead_statsDohvati statistike leadova uključujući broj po statusu
lead_field_config_getDohvati konfiguraciju polja za prikupljanje leadova

Povijest razgovora

ToolDescription
chat_sessions_listPopis chat sesija s opcionalnim filtrima
chat_session_getDohvati chat sesiju sa svim porukama
chat_session_searchPretraži chat sesije po sadržaju poruka ili informacijama o posjetitelju

Analitika

ToolDescription
analytics_overviewDohvati brojeve razgovora, brojeve poruka i stope zadovoljstva
analytics_chat_volumeDohvati volumen razgovora tijekom vremena za grafikone i trendove

Improvement Agent

ToolDescription
improvement_sessions_listPopis sesija poboljšanja
improvement_session_getDohvati detalje sesije uključujući prijedloge
improvement_proposals_pendingPopis na čekanju prijedloga koji čekaju pregled
improvement_proposal_approveOdobri prijedlog i primijeni izmjenu
improvement_proposal_rejectOdbij prijedlog

Live Chat

ToolDescription
live_chat_sessions_listPopis live chat sesija
live_chat_session_getDohvati live chat sesiju sa svim porukama
live_chat_queueDohvati sesije koje čekaju agenta

Alati za live chat su samo za čitanje. Za izravan chat s posjetiteljima koristite Live Chat dashboard.

Primjeri tijekova rada

Dodavanje osnovne upute

Pitajte vašeg AI asistenta:

"Dodajte osnovnu uputu za mog chatbota 'Support Bot': nudimo besplatnu dostavu za narudžbe preko €50"

Asistent će koristiti chatbot_add_instruction s odgovarajućim parametrima.

Pregled prijedloga za poboljšanje

"Pokaži mi sve na čekanju prijedloge za poboljšanje za mog chatbota i objasni koje promjene predlažu"

Asistent će:

  1. Koristiti improvement_proposals_pending za dohvat prijedloga
  2. Analizirati i sažeti svaki prijedlog
  3. Odobriti ili odbiti ih u vaše ime koristeći improvement_proposal_approve ili improvement_proposal_reject

Analiza izvedbe razgovora

"Dajte mi tjedno izvješće o volumenu razgovora i zadovoljstvu korisnika za mog chatbota"

Asistent će koristiti analytics_overview i analytics_chat_volume za sastavljanje sveobuhvatnog izvješća.

Sigurnost

  • API keys su ograničeni na vašu tvrtku
  • Ključevi se mogu opozvati u bilo kojem trenutku iz dashboarda
  • API pristup je dostupan na plaćenim planovima — pogledajte našu Pricing page

Rješavanje problema

Veza nije uspjela

  1. Provjerite je li vaš API ključ točan
  2. Provjerite nije li ključ opozvan
  3. Provjerite uključuje li vaš plan API pristup
  4. Ponovno pokrenite vaš MCP klijent

Alat nije pronađen

Ponovno pokrenite vaš MCP klijent nakon promjene konfiguracije kako bi ponovno učitao dostupne alate. Nazivi alata su malim slovima s donjim crticama (npr. faq_list).


Trebate pomoć? Contact our support team →