MCP-palvelimen integrointi
ChatReact toteuttaa Model Context Protocol (MCP) -protokollan, joka mahdollistaa ChatReact-tilinne yhdistämisen AI-avustajiin kuten Claude Desktop, Cursor ja muihin MCP-yhteensopiviin työkaluihin.
Mikä on MCP?
Model Context Protocol on avoin standardi, joka mahdollistaa AI-avustajien vuorovaikutuksen ulkoisten palveluiden ja tietolähteiden kanssa. ChatReactin MCP-integraation avulla te voitte:
- Hallinnoida chatbotteja — päivittää ohjeita, persoonallisuutta ja widget-asetuksia
- Luoda ja päivittää FAQ-sivuja luonnollisella kielellä
- Tarkastella analytiikkaa, keskusteluhistoriaa ja liidejä
- Käsitellä Improvement Agent -ehdotuksia ja hyväksyä tai hylätä ne
- Valvoa live-chat-istuntoja ja odotusjonoa
Aloittaminen
1. Luo API-avain
- Siirtykää kohtaan Dashboard → Company → API -välilehti
- Klikatkaa Create API Key
- Antakaa avaimelle kuvaava nimi (esim. "Claude Desktop") ja valitkaa vähintään yksi oikeus
- Kopioikaa luotu avain (alkaa
cr_)
API-avaimet ovat saatavilla maksullisissa suunnitelmissa — katso Pricing page.
Säilyttäkää API-avain turvallisesti. Sitä ei voi hakea takaisin luomisen jälkeen.
2. Konfiguroikaa MCP-asiakas
ChatReact MCP -palvelin isännöidään osoitteessa https://www.chatreact.ai/api/mcp ja se kommunikoi HTTP:n yli (JSON-RPC). Todentakaa Authorization: Bearer -otsikolla — sama avain hyväksytään myös X-API-Key-otsikolla.
Cursor IDE
Cursor tukee etä-MCP-palvelimia suoraan. Lisätkää seuraava asetukseen Cursorin MCP-asetuksissa:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktopin konfiguraatiotiedosto tukee komentopohjaisia palvelimia, joten käyttäkää vakiomuotoista mcp-remote-siltaratkaisua yhdistämään isännöityyn päätepisteeseen:
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"
]
}
}
}
Tämä asetus vaatii Node.js:n asentamisen. Esimerkissä käytetään X-API-Key-otsikkoa, koska jotkin asiakkaat eivät käsittele välilyöntejä argumenteissa luotettavasti.
3. Käynnistäkää AI-avustajanne uudelleen
Konfiguraation tallentamisen jälkeen käynnistäkää Claude Desktop tai Cursor uudelleen yhteyden muodostamiseksi.
Saatavilla olevat työkalut
ChatReact MCP tarjoaa kattavan valikoiman työkaluja, jotka on järjestetty kategorioihin:
Tilinne
| Työkalu | Kuvaus |
|---|---|
user_profile | Hakee profiilitietonne |
user_companies | Listaa yrityksen, johon API-avaimen oikeudet kohdistuvat |
user_notifications | Hakee viimeisimmät ilmoituksenne |
Yritys- ja tiiminhallinta
| Työkalu | Kuvaus |
|---|---|
company_list | Listaa yrityksen, johon API-avaimen oikeudet kohdistuvat |
company_get | Hakee tietyn yrityksen tiedot |
company_members_list | Listaa yrityksen jäsenet ja heidän roolinsa |
company_chatbots_list | Listaa kaikki yrityksen chatbotit |
company_update | Päivittää yrityksen nimen, kuvauksen tai asetukset |
Chatbot-hallinta
| Työkalu | Kuvaus |
|---|---|
chatbot_list | Listaa kaikki chatbotit tiivistelmätilastoineen |
chatbot_get | Hakee chatbotin tiedot ja konfiguraation |
chatbot_get_instructions | Hakee chatbotin ydinohjeet |
chatbot_add_instruction | Lisää uuden ydinohjeen |
chatbot_update_instruction | Päivittää olemassa olevan ydinohjeen |
chatbot_delete_instruction | Poistaa ydinohjeen |
chatbot_update_personality | Päivittää sävyä, kieltä ja viestejä |
chatbot_toggle_active | Aktivoi tai deaktivoi chatbotin |
chatbot_toggle_learning | Ota oppimisvaihe käyttöön tai pois käytöstä |
widget_settings_get | Hakee nykyiset widget-asetukset |
widget_settings_update | Päivittää widgetin ulkoasun (värit, koko, sijainti) |
FAQ-hallinta
| Työkalu | Kuvaus |
|---|---|
faq_list | Listaa kaikki chatbotin FAQ-kohteet |
faq_get | Hakee FAQ-kohteen tiedot |
faq_create | Luo uuden FAQ-kohteen |
faq_update | Päivittää olemassa olevan FAQ-kohteen |
faq_delete | Poistaa FAQ-kohteen |
faq_categories_list | Listaa FAQ-kategoriat |
faq_suggestions_list | Listaa keskusteluista generoidut odottavat FAQ-ehdotukset |
Tietopohja
| Työkalu | Kuvaus |
|---|---|
knowledge_documents_list | Listaa dokumentit chatbotin tietopohjassa |
knowledge_document_get | Hakee tietyn dokumentin tiedot |
knowledge_document_delete | Poistaa dokumentin tietopohjasta |
knowledge_stats | Hakee tietopohjan tilastot |
Verkkosivujen indeksointi hallitaan hallintapaneelista — katso Knowledge Base.
Liidien hallinta
| Työkalu | Kuvaus |
|---|---|
lead_list | Listaa liidit valinnaisilla suodattimilla tilan tai kategorian mukaan |
lead_get | Hakee liidin täydelliset tiedot mukaan lukien lähde-keskustelusessio |
lead_update | Päivittää liidin tilan, kategorian tai muistiinpanot |
lead_delete | Poistaa liidin pysyvästi |
lead_categories_list | Listaa liidikategoriat |
lead_stats | Hakee liidien tilastot mukaan lukien lukumäärät tilan mukaan |
lead_field_config_get | Hakee liidin keräyskenttien konfiguraation |
Keskusteluhistoria
| Työkalu | Kuvaus |
|---|---|
chat_sessions_list | Listaa keskustelusessiot valinnaisilla suodattimilla |
chat_session_get | Hakee keskustelusession kaikki viestit mukaan lukien |
chat_session_search | Etsii keskustelusessioita viestisisällön tai kävijätietojen perusteella |
Analytiikka
| Työkalu | Kuvaus |
|---|---|
analytics_overview | Hakee keskustelumäärät, viestimäärät ja tyytyväisyysprosentit |
analytics_chat_volume | Hakee keskustelumäärän aikavälin mukaan kaavioita ja trendejä varten |
Improvement Agent
| Työkalu | Kuvaus |
|---|---|
improvement_sessions_list | Listaa improvement-istunnot |
improvement_session_get | Hakee istunnon tiedot mukaan lukien ehdotukset |
improvement_proposals_pending | Listaa odottavat ehdotukset, jotka odottavat tarkistusta |
improvement_proposal_approve | Hyväksyy ehdotuksen ja ottaa muutoksen käyttöön |
improvement_proposal_reject | Hylkää ehdotuksen |
Live-chat
| Työkalu | Kuvaus |
|---|---|
live_chat_sessions_list | Listaa live-chat-istunnot |
live_chat_session_get | Hakee live-chat-istunnon kaikki viestit |
live_chat_queue | Hakee agenttia odottavat istunnot |
Live-chat-työkalut ovat vain luku -tilassa. Keskustellaksenne kävijöiden kanssa suoraan, käyttäkää Live Chat -hallintapaneelia.
Esimerkkityönkulut
Ydinohjeen lisääminen
Kysykää AI-avustajaltanne:
"Lisää ydinohje chatbotilleni 'Support Bot': tarjoamme ilmaisen toimituksen yli 50 € tilauksiin"
Avustaja käyttää chatbot_add_instruction-työkalua asianmukaisilla parametreilla.
Improvement-ehdotusten tarkastelu
"Näytä kaikki odottavat improvement-ehdotukset chatbotilleni ja selitä, mitä muutoksia ne ehdottavat"
Avustaja suorittaa:
- Käyttää
improvement_proposals_pendinghakemaan ehdotukset - Analysoi ja tiivistää jokaisen ehdotuksen
- Hyväksyy tai hylkää ne puolestanne
improvement_proposal_approve- taiimprovement_proposal_reject-toiminnolla
Keskustelusuorituksen analysointi
"Anna minulle viikoittainen raportti keskustelumääristä ja asiakastyytyväisyydestä chatbotilleni"
Avustaja käyttää analytics_overview- ja analytics_chat_volume-työkaluja koostaakseen kattavan raportin.
Tietoturva
- API-avaimet kohdistuvat yritykseenne
- Avaimet voidaan peruuttaa milloin tahansa hallintapaneelista
- API-käyttö on saatavilla maksullisissa suunnitelmissa — katso Pricing page
Vianmääritys
Yhteyden muodostaminen epäonnistui
- Varmistakaa, että API-avain on oikein
- Tarkistakaa, ettei avainta ole peruutettu
- Varmistakaa, että suunnitelmaanne sisältyy API-käyttö
- Käynnistäkää MCP-asiakas uudelleen
Työkalua ei löydy
Käynnistäkää MCP-asiakas uudelleen konfiguraation muuttamisen jälkeen, jotta saatavilla olevat työkalut latautuvat uudelleen. Työkalujen nimet ovat pienaakkosilla ja alaviivoin eroteltuna (esim. faq_list).
Tarvitsetteko apua? Ota yhteyttä tukitiimiimme →