HomeDocumentation

MCP Server Integration

ChatReact внедрява Model Context Protocol (MCP), което Ви позволява да свържете своя ChatReact акаунт с AI асистенти като Claude Desktop, Cursor и други инструменти, съвместими с MCP.

Какво е MCP?

Model Context Protocol е отворен стандарт, който дава възможност на AI асистенти да взаимодействат с външни услуги и източници на данни. С MCP интеграцията на ChatReact Вие можете:

  • Да управлявате чатботове директно от Вашия AI асистент
  • Да създавате и актуализирате ЧЗВ с естествен език
  • Да преглеждате аналитика и история на чатове
  • Да контролирате Improvement Agent за оптимизация на чатбота
  • Да водите сесии на живо без да напускате Вашия AI инструмент

Започване

1. Генериране на API ключ

  1. Отидете в DashboardSettingsAPI Keys
  2. Натиснете Create API Key
  3. Дайте на ключа описателно име (напр., "Claude Desktop")
  4. Копирайте генерирания ключ (започва с cr_)

Съхранявайте Вашия API ключ сигурно. Той не може да бъде възстановен след създаване.

2. Конфигуриране на Вашия MCP клиент

Claude Desktop

Добавете следното във файла за конфигурация на Claude Desktop:

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

Добавете в настройките на вашия Cursor MCP:

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

Локална разработка (stdio)

За локална разработка можете да използвате нашия npm пакет:

npm install -g @chatreact/mcp

Конфигурирайте във вашия MCP клиент:

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

3. Рестартирайте вашия AI асистент

След като запазите конфигурацията, рестартирайте Claude Desktop или Cursor, за да установите връзката.

Налични инструменти

ChatReact MCP предоставя над 30 инструмента, организирани в категории:

Управление на компанията и екипа

ToolDescription
company_listИзброява всички компании, до които Вие имате достъп
company_getВръща подробности за конкретна компания
company_team_listИзброява членове на екипа на компанията

Управление на чатботове

ToolDescription
chatbot_listИзброява всички чатботове в компанията
chatbot_getВръща детайли и конфигурация на чатбота
chatbot_createСъздава нов чатбот
chatbot_updateАктуализира настройките на чатбота
chatbot_get_instructionsВзема основните инструкции за чатбота
chatbot_add_instructionДобавя нова основна инструкция

Управление на ЧЗВ (FAQ)

ToolDescription
faq_listИзброява всички ЧЗВ за даден чатбот
faq_getВръща подробности за ЧЗВ
faq_createСъздава ново ЧЗВ
faq_updateАктуализира съществуващо ЧЗВ
faq_deleteИзтрива ЧЗВ
faq_categories_listИзброява категориите на ЧЗВ
faq_suggestГенерира ЧЗВ, предложени от AI

Knowledge Base

ToolDescription
knowledge_list_documentsИзброява качените документи
knowledge_list_websitesИзброява обхожданите уебсайтове
knowledge_crawl_websiteСтартира обхождане на уебсайт
knowledge_get_crawl_statusПроверява напредъка на обхождането

Аналитика

ToolDescription
analytics_overviewВръща общи метрики за производителност
analytics_chat_volumeВръща обема чатове във времето
analytics_feedbackВръща обратна връзка и оценки
analytics_chat_historyПреглед на чат сесиите
analytics_get_sessionВръща подробни данни за сесия

Improvement Agent

ToolDescription
improvement_list_sessionsИзброява сесиите за подобрение
improvement_start_sessionСтартира нова анализираща сесия
improvement_list_proposalsИзброява предложения за подобрение
improvement_get_proposalВръща подробности за предложение
improvement_create_proposalСъздава потребителско предложение
improvement_simulate_proposalПреглед на ефектите от предложението
improvement_apply_proposalПрилага предложение
improvement_reject_proposalОтхвърля предложение

Live Chat

ToolDescription
livechat_get_queueВръща чакащите чат сесии
livechat_get_active_sessionsИзброява активните сесии с човешки агенти
livechat_get_sessionВръща подробности за сесия
livechat_assign_sessionПрисвоява сесия на Вас като агент
livechat_send_messageИзпраща съобщение като агент
livechat_close_sessionЗатваря чат сесия
livechat_check_availabilityПроверява наличността на агентите

Примерни работни процеси

Създаване на нов чатбот

Попитайте Вашия AI асистент:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

Асистентът ще използва chatbot_create с подходящи параметри.

Преглед на предложения за подобрение

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Асистентът ще:

  1. Използва improvement_list_proposals за извличане на предложения
  2. Анализира и обобщи всяко предложение
  3. Помогне на Вас да решите кои да приложите

Анализ на представянето на чат

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

Асистентът ще използва analytics_overview и analytics_feedback за съставяне на цялостен отчет.

Сигурност

  • API keys са ограничени до Вашия потребителски акаунт и достъп до компанията
  • Всички заявки се записват в audit trail
  • Ключовете могат да бъдат оттеглени по всяко време от таблото за управление
  • Rate limits apply: 60 requests/minute

Отстраняване на неизправности

Неуспешна връзка

  1. Проверете дали Вашият API key е правилен
  2. Уверете се, че ключът не е бил оттеглен
  3. Уверете се, че имате активна интернет връзка
  4. Рестартирайте MCP клиента си

Инструментът не е намерен

Някои инструменти изискват специфични разрешения. Уверете се, че имате подходящата роля в компанията (Owner, Admin, или Manager).

Ограничение на скоростта (Rate Limited)

Ако виждате грешки за ограничение на скоростта, изчакайте една минута преди да опитате отново. Помислете за пакетиране на операциите, когато е възможно.


Нуждаете се от помощ? Contact our support team →