НачалоДокументация

Интеграция с MCP сървър

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

Какво е MCP?

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

  • Управлявате чатботове — актуализирате инструкции, личност и настройки на widget-а
  • Създавате и актуализирате ЧЗВ с помощта на естествен език
  • Преглеждате аналитика, история на чатове и лийдове
  • Преглеждате предложения от Improvement Agent и ги одобрявате или отхвърляте
  • Мониторите живи чат сесии и опашката за изчакване

Започване

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

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

API ключовете са налични в платените планове — вижте нашата Pricing page.

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

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

ChatReact MCP сървърът е хостван на https://www.chatreact.ai/api/mcp и комуникира по HTTP (JSON-RPC). Аутентикирайте се с хедър Authorization: Bearer — също се приема и хедър X-API-Key със същия ключ.

Cursor IDE

Cursor поддържа отдалечени MCP сървъри директно. Добавете в настройките на Cursor MCP:

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

Claude Desktop

Файлът за конфигурация на Claude Desktop поддържа сървъри, базирани на команди, затова използвайте стандартния мост mcp-remote, за да се свържете с хоствания крайна точка:

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"
      ]
    }
  }
}

Тази настройка изисква инсталиран Node.js. Примера използва хедъра X-API-Key, защото някои клиенти не обработват правилно интервали в аргументите.

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

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

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

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

Вашият акаунт

ToolDescription
user_profileПолучаване на информация за Вашия профил
user_companiesИзброяване на компанията, към която е обвързан Вашият API ключ
user_notificationsПолучаване на последните Ви известия

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

ToolDescription
company_listИзброяване на компанията, към която е обвързан Вашият API ключ
company_getПолучаване на детайли за конкретна компания
company_members_listИзброяване на членовете на компанията с техните роли
company_chatbots_listИзброяване на всички чатботове за компанията
company_updateАктуализиране на име на компанията, описание или настройки

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

ToolDescription
chatbot_listИзброяване на всички чатботове с обобщена статистика
chatbot_getПолучаване на детайли и конфигурация на чатбот
chatbot_get_instructionsПолучаване на основните инструкции за чатбот
chatbot_add_instructionДобавяне на нова основна инструкция
chatbot_update_instructionАктуализиране на съществуваща основна инструкция
chatbot_delete_instructionИзтриване на основна инструкция
chatbot_update_personalityАктуализиране на тоналност, език и съобщения
chatbot_toggle_activeАктивиране или деактивиране на чатбот
chatbot_toggle_learningВключване или изключване на фазата на обучение
widget_settings_getПолучаване на текущите настройки на widget-а
widget_settings_updateАктуализиране на външния вид на widget-а (цветове, размер, позиция)

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

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

База от знания

ToolDescription
knowledge_documents_listИзброяване на документи в базата знания на чатбот
knowledge_document_getПолучаване на детайли за конкретен документ
knowledge_document_deleteИзтриване на документ от базата знания
knowledge_statsПолучаване на статистика за базата знания

Обходът на уебсайтове се управлява от таблото — вижте Knowledge Base.

Управление на лийдове

ToolDescription
lead_listИзброяване на лийдове с опционален филтър по статус или категория
lead_getПолучаване на пълни детайли за лийд, включително източника (чат сесия)
lead_updateАктуализиране на статус, категория или бележки за лийд
lead_deleteТрайно изтриване на лийд
lead_categories_listИзброяване на категории лийдове
lead_statsПолучаване на статистика за лийдовете, включително брой по статус
lead_field_config_getПолучаване на конфигурацията на полетата за улавяне на лийдове

История на чата

ToolDescription
chat_sessions_listИзброяване на чат сесии с опционални филтри
chat_session_getПолучаване на чат сесия с всички съобщения
chat_session_searchТърсене в чат сесии по съдържание на съобщения или информация за посетителя

Аналитика

ToolDescription
analytics_overviewПолучаване на брой чатове, брой съобщения и показатели за удовлетвореност
analytics_chat_volumeПолучаване на обем чатове във времето за графики и трендове

Improvement Agent

ToolDescription
improvement_sessions_listИзброяване на сесии за подобрения
improvement_session_getПолучаване на детайли за сесия, включително предложения
improvement_proposals_pendingИзброяване на чакащи предложения за преглед
improvement_proposal_approveОдобряване на предложение и прилагане на промяната
improvement_proposal_rejectОтхвърляне на предложение

Жив чат

ToolDescription
live_chat_sessions_listИзброяване на живи чат сесии
live_chat_session_getПолучаване на жива чат сесия с всички съобщения
live_chat_queueПолучаване на сесии, чакащи за агент

Инструментите за жив чат са само за четене. За да разговаряте директно с посетители, използвайте таблото Live Chat.

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

Добавяне на основна инструкция

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

"Добавете основна инструкция към моя чатбот 'Support Bot': предлагаме безплатна доставка за поръчки над €50"

Асистентът ще използва chatbot_add_instruction със съответните параметри.

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

"Покажи ми всички чакащи предложения за подобрения за моя чатбот и обясни какви промени предлагат"

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

  1. Използва improvement_proposals_pending, за да извлече предложенията
  2. Анализира и обобщи всяко предложение
  3. Одобри или отхвърли от Ваше име с improvement_proposal_approve или improvement_proposal_reject

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

"Дай ми седмичен отчет за обема на чатове и удовлетвореността на клиентите за моя чатбот"

Асистентът ще използва analytics_overview и analytics_chat_volume, за да състави подробен отчет.

Сигурност

  • API ключовете са обвързани с Вашата компания
  • Ключовете могат да бъдат отзовани по всяко време от таблото
  • Достъп до API е наличен в платените планове — вижте нашата Pricing page

Отстраняване на проблеми

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

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

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

Рестартирайте MCP клиента след промяна на конфигурацията, за да презареди наличните инструменти. Имената на инструментите са с малки букви и долни черти (например faq_list).


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