HomeDocumentation

MCP Server Integration

ChatReact toteuttaa Model Context Protocol (MCP) -protokollan, jonka avulla voitte yhdistää ChatReact-tilinne 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 voitte:

  • Hallita chatboteja suoraan AI-avustajastanne
  • Luoda ja päivittää usein kysyttyjä kysymyksiä (FAQ) luonnollisella kielellä
  • Tarkastella analytiikkaa ja keskusteluhistoriaa
  • Ohjata Improvement Agentia chatbotin optimointia varten
  • Käsitellä live-chat-istuntoja ilman, että tarvitsette poistua AI-työkalustanne

Aloittaminen

1. Luo API-avain

  1. Siirtykää DashboardSettingsAPI Keys
  2. Klikatkaa Create API Key
  3. Antakaa avaimelle kuvaava nimi (esim. "Claude Desktop")
  4. Kopioikaa luotu avain (alkaa cr_-etuliitteellä)

Säilyttäkää API-avain turvallisesti. Sitä ei voi hakea uudelleen luomisen jälkeen.

2. Määrittäkää MCP-asiakas

Claude Desktop

Lisätkää seuraava Claude Desktopin konfiguraatiotiedostoon:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Lisää Cursor MCP -asetuksiisi:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Paikallinen kehitys (stdio)

Paikalliseen kehitykseen voitte käyttää npm packageamme:

npm install -g @chatreact/mcp

Määritä MCP clientissanne:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Käynnistä tekoäpiavustajasi uudelleen

Konfiguraation tallentamisen jälkeen käynnistä Claude Desktop tai Cursor uudelleen yhteyden muodostamiseksi.

Käytettävissä olevat työkalut

ChatReact MCP tarjoaa yli 30 työkalua, jotka on järjestetty kategorioihin:

Yrityksen ja tiimin hallinta

ToolDescription
company_listListaa kaikki yritykset, joihin teillä on pääsy
company_getHae tietoja tietystä yrityksestä
company_team_listListaa yrityksen tiimin jäsenet

Chatbotin hallinta

ToolDescription
chatbot_listListaa kaikki yrityksen chatbotit
chatbot_getHae chatbotin tiedot ja konfiguraatio
chatbot_createLuo uusi chatbot
chatbot_updatePäivitä chatbotin asetuksia
chatbot_get_instructionsHae chatbotin ydinohjeet
chatbot_add_instructionLisää uusi ydinohje

FAQ-hallinta

ToolDescription
faq_listListaa kaikki chatbotin UKK:t
faq_getHae UKK:n tiedot
faq_createLuo uusi UKK
faq_updatePäivitä olemassa oleva UKK
faq_deletePoista UKK
faq_categories_listListaa UKK-kategoriat
faq_suggestGeneroi tekoälyn ehdottamia UKK:ja

Knowledge Base

ToolDescription
knowledge_list_documentsListaa ladatut dokumentit
knowledge_list_websitesListaa indeksoidut verkkosivustot
knowledge_crawl_websiteAloita verkkosivuston indeksointi
knowledge_get_crawl_statusTarkista indeksoinnin eteneminen

Analytics

ToolDescription
analytics_overviewHae yleiset suorituskykymittarit
analytics_chat_volumeHae keskustelumäärät ajan mukaan
analytics_feedbackHae palautteet ja arviot
analytics_chat_historySelaa keskustelusessioita
analytics_get_sessionHae yksityiskohtaiset sessiotiedot

Improvement Agent

ToolDescription
improvement_list_sessionsListaa parannussessiot
improvement_start_sessionAloita uusi analyysisessio
improvement_list_proposalsListaa parannusehdotukset
improvement_get_proposalHae ehdotuksen tiedot
improvement_create_proposalLuo mukautettu ehdotus
improvement_simulate_proposalEsikatsele ehdotuksen vaikutuksia
improvement_apply_proposalKäytä ehdotusta
improvement_reject_proposalHylkää ehdotus

Live Chat

ToolDescription
livechat_get_queueHae odottavat keskustelusessiot
livechat_get_active_sessionsListaa aktiiviset ihmiskontaktit-sessiot
livechat_get_sessionHae session tiedot
livechat_assign_sessionOta itsellesi vastuulle sessio
livechat_send_messageLähetä viesti agenttina
livechat_close_sessionSulje keskustelusessio
livechat_check_availabilityTarkista agentin saatavuus

Esimerkkityönkulut

Uuden chatbotin luominen

Kysy tekoäpiavustajaltasi:

"Luo uusi chatbot nimeltä 'Support Bot' yritykselleni 'acme-corp' ystävällisellä, ammattimaisella äänensävyllä"

Avustaja käyttää chatbot_create-toimintoa sopivilla parametreilla.

Parannusehdotusten tarkastelu

"Näytä kaikki odottavat parannusehdotukset chatbotilleni ja selitä, mitä muutoksia ne ehdottavat"

Avustaja:

  1. Käyttää improvement_list_proposals hakemaan ehdotukset
  2. Analysoi ja tiivistää jokaisen ehdotuksen
  3. Auttaa teitä päättämään, mitkä ottaa käyttöön

Keskustelujen suorituskyvyn analysointi

"Anna viikoittainen raportti keskustelumääristä ja asiakastyytyväisyydestä chatbotilleni"

Avustaja käyttää analytics_overview ja analytics_feedback koostamaan kattavan raportin.

Tietoturva

  • API-avaimet on sidottu käyttäjätiliinne ja yritysvaltuuksiinne
  • Kaikki pyynnöt kirjataan audit trailiin
  • Avaimet voidaan mitätöidä milloin tahansa hallintapaneelista
  • Nopeusrajoituksia sovelletaan: 60 pyyntöä/minuutti

Vianmääritys

Yhteys epäonnistui

  1. Varmistakaa, että API-avaimenne on oikein
  2. Tarkistakaa, ettei avainta ole mitätöity
  3. Varmistakaa, että teillä on aktiivinen internet-yhteys
  4. Käynnistäkää MCP-asiakasohjelma uudelleen

Työkalua ei löydy

Jotkut työkalut vaativat erityisiä oikeuksia. Varmistakaa, että teillä on asianmukainen rooli yrityksessä (Owner, Admin tai Manager).

Nopeusrajoitus

Jos näette nopeusrajoitusvirheitä, odottakaa minuutin ennen uudelleenyrittämistä. Harkitkaa toimintojen ryhmittelyä, kun mahdollista.


Tarvitsetteko apua? Ota yhteyttä tukitiimiimme →