EtusivuDokumentaatio

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

  1. Siirtykää kohtaan DashboardCompanyAPI -välilehti
  2. Klikatkaa Create API Key
  3. Antakaa avaimelle kuvaava nimi (esim. "Claude Desktop") ja valitkaa vähintään yksi oikeus
  4. 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ökaluKuvaus
user_profileHakee profiilitietonne
user_companiesListaa yrityksen, johon API-avaimen oikeudet kohdistuvat
user_notificationsHakee viimeisimmät ilmoituksenne

Yritys- ja tiiminhallinta

TyökaluKuvaus
company_listListaa yrityksen, johon API-avaimen oikeudet kohdistuvat
company_getHakee tietyn yrityksen tiedot
company_members_listListaa yrityksen jäsenet ja heidän roolinsa
company_chatbots_listListaa kaikki yrityksen chatbotit
company_updatePäivittää yrityksen nimen, kuvauksen tai asetukset

Chatbot-hallinta

TyökaluKuvaus
chatbot_listListaa kaikki chatbotit tiivistelmätilastoineen
chatbot_getHakee chatbotin tiedot ja konfiguraation
chatbot_get_instructionsHakee chatbotin ydinohjeet
chatbot_add_instructionLisää uuden ydinohjeen
chatbot_update_instructionPäivittää olemassa olevan ydinohjeen
chatbot_delete_instructionPoistaa ydinohjeen
chatbot_update_personalityPäivittää sävyä, kieltä ja viestejä
chatbot_toggle_activeAktivoi tai deaktivoi chatbotin
chatbot_toggle_learningOta oppimisvaihe käyttöön tai pois käytöstä
widget_settings_getHakee nykyiset widget-asetukset
widget_settings_updatePäivittää widgetin ulkoasun (värit, koko, sijainti)

FAQ-hallinta

TyökaluKuvaus
faq_listListaa kaikki chatbotin FAQ-kohteet
faq_getHakee FAQ-kohteen tiedot
faq_createLuo uuden FAQ-kohteen
faq_updatePäivittää olemassa olevan FAQ-kohteen
faq_deletePoistaa FAQ-kohteen
faq_categories_listListaa FAQ-kategoriat
faq_suggestions_listListaa keskusteluista generoidut odottavat FAQ-ehdotukset

Tietopohja

TyökaluKuvaus
knowledge_documents_listListaa dokumentit chatbotin tietopohjassa
knowledge_document_getHakee tietyn dokumentin tiedot
knowledge_document_deletePoistaa dokumentin tietopohjasta
knowledge_statsHakee tietopohjan tilastot

Verkkosivujen indeksointi hallitaan hallintapaneelista — katso Knowledge Base.

Liidien hallinta

TyökaluKuvaus
lead_listListaa liidit valinnaisilla suodattimilla tilan tai kategorian mukaan
lead_getHakee liidin täydelliset tiedot mukaan lukien lähde-keskustelusessio
lead_updatePäivittää liidin tilan, kategorian tai muistiinpanot
lead_deletePoistaa liidin pysyvästi
lead_categories_listListaa liidikategoriat
lead_statsHakee liidien tilastot mukaan lukien lukumäärät tilan mukaan
lead_field_config_getHakee liidin keräyskenttien konfiguraation

Keskusteluhistoria

TyökaluKuvaus
chat_sessions_listListaa keskustelusessiot valinnaisilla suodattimilla
chat_session_getHakee keskustelusession kaikki viestit mukaan lukien
chat_session_searchEtsii keskustelusessioita viestisisällön tai kävijätietojen perusteella

Analytiikka

TyökaluKuvaus
analytics_overviewHakee keskustelumäärät, viestimäärät ja tyytyväisyysprosentit
analytics_chat_volumeHakee keskustelumäärän aikavälin mukaan kaavioita ja trendejä varten

Improvement Agent

TyökaluKuvaus
improvement_sessions_listListaa improvement-istunnot
improvement_session_getHakee istunnon tiedot mukaan lukien ehdotukset
improvement_proposals_pendingListaa odottavat ehdotukset, jotka odottavat tarkistusta
improvement_proposal_approveHyväksyy ehdotuksen ja ottaa muutoksen käyttöön
improvement_proposal_rejectHylkää ehdotuksen

Live-chat

TyökaluKuvaus
live_chat_sessions_listListaa live-chat-istunnot
live_chat_session_getHakee live-chat-istunnon kaikki viestit
live_chat_queueHakee 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:

  1. Käyttää improvement_proposals_pending hakemaan ehdotukset
  2. Analysoi ja tiivistää jokaisen ehdotuksen
  3. Hyväksyy tai hylkää ne puolestanne improvement_proposal_approve- tai improvement_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

  1. Varmistakaa, että API-avain on oikein
  2. Tarkistakaa, ettei avainta ole peruutettu
  3. Varmistakaa, että suunnitelmaanne sisältyy API-käyttö
  4. 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 →