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č
- Idite na vaš Dashboard → Company → kartica API
- Kliknite Create API Key
- Dajte ključu opisno ime (npr. "Claude Desktop") i odaberite barem jednu dozvolu
- 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
| Tool | Description |
|---|---|
user_profile | Dohvati informacije o vašem profilu |
user_companies | Popis tvrtke na koju je vaš API ključ ograničen |
user_notifications | Dohvati vaše nedavne obavijesti |
Upravljanje tvrtkom i timom
| Tool | Description |
|---|---|
company_list | Popis tvrtke na koju je vaš API ključ ograničen |
company_get | Dohvati detalje o određenoj tvrtki |
company_members_list | Popis članova tvrtke s njihovim ulogama |
company_chatbots_list | Popis svih chatbotova za tvrtku |
company_update | Ažuriraj ime tvrtke, opis ili postavke |
Upravljanje chatbotom
| Tool | Description |
|---|---|
chatbot_list | Popis svih chatbotova sa sažetim statistikama |
chatbot_get | Dohvati detalje i konfiguraciju chatbota |
chatbot_get_instructions | Dohvati osnovne upute za chatbota |
chatbot_add_instruction | Dodaj novu osnovnu uputu |
chatbot_update_instruction | Ažuriraj postojeću osnovnu uputu |
chatbot_delete_instruction | Izbriši osnovnu uputu |
chatbot_update_personality | Ažuriraj ton, jezik i poruke |
chatbot_toggle_active | Aktiviraj ili deaktiviraj chatbota |
chatbot_toggle_learning | Omogući ili onemogući fazu učenja |
widget_settings_get | Dohvati trenutne postavke widgeta |
widget_settings_update | Ažuriraj izgled widgeta (boje, veličina, položaj) |
Upravljanje FAQ-ovima
| Tool | Description |
|---|---|
faq_list | Popis svih FAQ-ova za chatbota |
faq_get | Dohvati detalje FAQ-a |
faq_create | Kreiraj novi FAQ |
faq_update | Ažuriraj postojeći FAQ |
faq_delete | Izbriši FAQ |
faq_categories_list | Popis kategorija FAQ-ova |
faq_suggestions_list | Popis na čekanju FAQ prijedloga generiranih iz razgovora |
Baza znanja
| Tool | Description |
|---|---|
knowledge_documents_list | Popis dokumenata u bazi znanja chatbota |
knowledge_document_get | Dohvati detalje određenog dokumenta |
knowledge_document_delete | Izbriši dokument iz baze znanja |
knowledge_stats | Dohvati statistike baze znanja |
Crawlanje web stranica upravlja se iz dashboarda — vidi Knowledge Base.
Upravljanje leadovima
| Tool | Description |
|---|---|
lead_list | Popis leadova s opcionalnim filtriranjem po statusu ili kategoriji |
lead_get | Dohvati potpune detalje leada uključujući izvor chat sesije |
lead_update | Ažuriraj status leada, kategoriju ili bilješke |
lead_delete | Trajno izbriši lead |
lead_categories_list | Popis kategorija leadova |
lead_stats | Dohvati statistike leadova uključujući broj po statusu |
lead_field_config_get | Dohvati konfiguraciju polja za prikupljanje leadova |
Povijest razgovora
| Tool | Description |
|---|---|
chat_sessions_list | Popis chat sesija s opcionalnim filtrima |
chat_session_get | Dohvati chat sesiju sa svim porukama |
chat_session_search | Pretraži chat sesije po sadržaju poruka ili informacijama o posjetitelju |
Analitika
| Tool | Description |
|---|---|
analytics_overview | Dohvati brojeve razgovora, brojeve poruka i stope zadovoljstva |
analytics_chat_volume | Dohvati volumen razgovora tijekom vremena za grafikone i trendove |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Popis sesija poboljšanja |
improvement_session_get | Dohvati detalje sesije uključujući prijedloge |
improvement_proposals_pending | Popis na čekanju prijedloga koji čekaju pregled |
improvement_proposal_approve | Odobri prijedlog i primijeni izmjenu |
improvement_proposal_reject | Odbij prijedlog |
Live Chat
| Tool | Description |
|---|---|
live_chat_sessions_list | Popis live chat sesija |
live_chat_session_get | Dohvati live chat sesiju sa svim porukama |
live_chat_queue | Dohvati 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:
- Koristiti
improvement_proposals_pendingza dohvat prijedloga - Analizirati i sažeti svaki prijedlog
- Odobriti ili odbiti ih u vaše ime koristeći
improvement_proposal_approveiliimprovement_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
- Provjerite je li vaš API ključ točan
- Provjerite nije li ključ opozvan
- Provjerite uključuje li vaš plan API pristup
- 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 →