Интеграция с MCP сървър
ChatReact реализира Model Context Protocol (MCP), което Ви позволява да свържете Вашия ChatReact акаунт с AI асистенти като Claude Desktop, Cursor и други инструменти съвместими с MCP.
Какво е MCP?
Model Context Protocol е отворен стандарт, който позволява на AI асистентите да взаимодействат с външни услуги и източници на данни. С MCP интеграцията на ChatReact, Вие можете да:
- Управлявате чатботове — актуализирате инструкции, личност и настройки на widget-а
- Създавате и актуализирате ЧЗВ с помощта на естествен език
- Преглеждате аналитика, история на чатове и лийдове
- Преглеждате предложения от Improvement Agent и ги одобрявате или отхвърляте
- Мониторите живи чат сесии и опашката за изчакване
Започване
1. Генерирайте API ключ
- Отидете във Вашия Dashboard → Company → таб API
- Кликнете Create API Key
- Дайте на ключа описателно име (напр., "Claude Desktop") и изберете поне едно разрешение
- Копирайте генерирания ключ (започва с
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 предоставя обширен набор от инструменти, организирани в категории:
Вашият акаунт
| Tool | Description |
|---|---|
user_profile | Получаване на информация за Вашия профил |
user_companies | Изброяване на компанията, към която е обвързан Вашият API ключ |
user_notifications | Получаване на последните Ви известия |
Управление на компанията и екипа
| Tool | Description |
|---|---|
company_list | Изброяване на компанията, към която е обвързан Вашият API ключ |
company_get | Получаване на детайли за конкретна компания |
company_members_list | Изброяване на членовете на компанията с техните роли |
company_chatbots_list | Изброяване на всички чатботове за компанията |
company_update | Актуализиране на име на компанията, описание или настройки |
Управление на чатботове
| Tool | Description |
|---|---|
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-а (цветове, размер, позиция) |
Управление на ЧЗВ
| Tool | Description |
|---|---|
faq_list | Изброяване на всички ЧЗВ за чатбот |
faq_get | Получаване на детайли за ЧЗВ |
faq_create | Създаване на нова ЧЗВ запис |
faq_update | Актуализиране на съществуваща ЧЗВ запис |
faq_delete | Изтриване на ЧЗВ запис |
faq_categories_list | Изброяване на категории на ЧЗВ |
faq_suggestions_list | Изброяване на чакащи предложения за ЧЗВ, генерирани от разговори в чата |
База от знания
| Tool | Description |
|---|---|
knowledge_documents_list | Изброяване на документи в базата знания на чатбот |
knowledge_document_get | Получаване на детайли за конкретен документ |
knowledge_document_delete | Изтриване на документ от базата знания |
knowledge_stats | Получаване на статистика за базата знания |
Обходът на уебсайтове се управлява от таблото — вижте Knowledge Base.
Управление на лийдове
| Tool | Description |
|---|---|
lead_list | Изброяване на лийдове с опционален филтър по статус или категория |
lead_get | Получаване на пълни детайли за лийд, включително източника (чат сесия) |
lead_update | Актуализиране на статус, категория или бележки за лийд |
lead_delete | Трайно изтриване на лийд |
lead_categories_list | Изброяване на категории лийдове |
lead_stats | Получаване на статистика за лийдовете, включително брой по статус |
lead_field_config_get | Получаване на конфигурацията на полетата за улавяне на лийдове |
История на чата
| Tool | Description |
|---|---|
chat_sessions_list | Изброяване на чат сесии с опционални филтри |
chat_session_get | Получаване на чат сесия с всички съобщения |
chat_session_search | Търсене в чат сесии по съдържание на съобщения или информация за посетителя |
Аналитика
| Tool | Description |
|---|---|
analytics_overview | Получаване на брой чатове, брой съобщения и показатели за удовлетвореност |
analytics_chat_volume | Получаване на обем чатове във времето за графики и трендове |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Изброяване на сесии за подобрения |
improvement_session_get | Получаване на детайли за сесия, включително предложения |
improvement_proposals_pending | Изброяване на чакащи предложения за преглед |
improvement_proposal_approve | Одобряване на предложение и прилагане на промяната |
improvement_proposal_reject | Отхвърляне на предложение |
Жив чат
| Tool | Description |
|---|---|
live_chat_sessions_list | Изброяване на живи чат сесии |
live_chat_session_get | Получаване на жива чат сесия с всички съобщения |
live_chat_queue | Получаване на сесии, чакащи за агент |
Инструментите за жив чат са само за четене. За да разговаряте директно с посетители, използвайте таблото Live Chat.
Примерни работни потоци
Добавяне на основна инструкция
Попитайте Вашия AI асистент:
"Добавете основна инструкция към моя чатбот 'Support Bot': предлагаме безплатна доставка за поръчки над €50"
Асистентът ще използва chatbot_add_instruction със съответните параметри.
Преглед на предложения за подобрения
"Покажи ми всички чакащи предложения за подобрения за моя чатбот и обясни какви промени предлагат"
Асистентът ще:
- Използва
improvement_proposals_pending, за да извлече предложенията - Анализира и обобщи всяко предложение
- Одобри или отхвърли от Ваше име с
improvement_proposal_approveилиimprovement_proposal_reject
Анализ на представянето на чат
"Дай ми седмичен отчет за обема на чатове и удовлетвореността на клиентите за моя чатбот"
Асистентът ще използва analytics_overview и analytics_chat_volume, за да състави подробен отчет.
Сигурност
- API ключовете са обвързани с Вашата компания
- Ключовете могат да бъдат отзовани по всяко време от таблото
- Достъп до API е наличен в платените планове — вижте нашата Pricing page
Отстраняване на проблеми
Неуспешна връзка
- Проверете дали API ключът е правилен
- Уверете се, че ключът не е бил отзован
- Уверете се, че планът Ви включва достъп до API
- Рестартирайте MCP клиента си
Инструментът не е намерен
Рестартирайте MCP клиента след промяна на конфигурацията, за да презареди наличните инструменти. Имената на инструментите са с малки букви и долни черти (например faq_list).
Нуждаете се от помощ? Contact our support team →