Elfsight AI Chatbot — MCP Server

В этом репозитории находятся документация и манифест реестра (server.json) MCP-сервера Elfsight AI Chatbot. Сам сервер размещён на стороне Elfsight: здесь ничего не нужно собирать или запускать. Если вам нужна помощь, обратитесь в Справочный центр Elfsight.

Удалённый сервер Model Context Protocol, предоставляющий доступ к данным виджета

Elfsight AI Chatbot. Подключите к нему AI-агента с поддержкой MCP: он сможет просматривать переписки, лиды, базу знаний и аналитику, а также добавлять ответы в базу знаний — без копирования и вставки данных в окно чата.

Сервер привязан к аккаунту: после входа агент получит доступ ко всем виджетам AI Chatbot в вашем аккаунте Elfsight, но ни к каким другим данным или продуктам Elfsight.

URL сервера: https://widget-data.service.elfsight.com/mcp/ai_chat (Streamable HTTP).

Подключение

Для входа используется OAuth. Добавьте URL сервера в свой MCP-клиент. Клиент откроет окно браузера, где вы войдёте в Elfsight и подтвердите доступ. Копировать ключ не нужно.

Claude Code

claude mcp add --transport http elfsight-ai-chatbot https://widget-data.service.elfsight.com/mcp/ai_chat

Затем выполните /mcp в Claude Code и выберите Authenticate для elfsight-ai-chatbot.

Cursor

Этот репозиторий также является плагином Cursor: манифест находится в .cursor-plugin/plugin.json, настройки подключения сервера — в mcp.json, а правила с инструкциями для агента — в rules/.

Чтобы подключиться без плагина, добавьте сервер в .cursor/mcp.json и пройдите аутентификацию по запросу Cursor:

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Cline

В Cline откройте MCP Servers → Remote Servers и добавьте сервер:

Имя сервера: elfsight-ai-chatbot
URL сервера: https://widget-data.service.elfsight.com/mcp/ai_chat
Транспорт: Streamable HTTP

Затем выберите Authenticate для сервера и войдите в Elfsight в открывшемся окне браузера.

Те же настройки можно внести в файл настроек Cline cline_mcp_settings.json. В последних версиях он находится в

~/.cline/data/settings/, в более ранних — в каталоге редактора

User/globalStorage/saoudrizwan.claude-dev/settings/. Не удаляйте type: без него Cline переключается на устаревший транспорт SSE. Файл .vscode/mcp.json предназначен для встроенной поддержки MCP в VS Code; Cline его не читает.

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "type": "streamableHttp",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Другие клиенты

К серверу можно подключить любой клиент, поддерживающий удалённые MCP-серверы с OAuth (динамическую регистрацию клиента и PKCE), указав только URL сервера. **Мы проверили работу только с Claude Code, Cursor

(через плагин), Cline и VS Code**. Приведённый ниже пример для VS Code проверен; пример для Windsurf соответствует стандартной структуре его конфигурации.

VS Code:

или добавьте сервер в .vscode/mcp.json:

{
  "servers": {
    "elfsight-ai-chatbot": {
      "type": "http",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Windsurf (mcp_config.json):

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "serverUrl": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

О чём можно спросить

list_assistants — «Какие виджеты AI Chatbot у меня есть?»
get_analytics — «Как работал мой AI Chatbot за последние 30 дней?»
search_conversations — «Покажи переписки за прошлую неделю о доставке».
get_conversation — «Что произошло в переписке ``?»
list_leads — «Покажи новые лиды за эту неделю, которые я ещё не проверил».
search_knowledge — «Есть ли в моей базе знаний информация о возврате средств?»
list_knowledge_gaps — «О чём спрашивают посетители, на что мой ассистент не может ответить?»
answer_knowledge_gap — «Добавь это в базу знаний как ответ и закрой этот пробел».

answer_knowledge_gap — единственный инструмент, который вносит изменения. Три готовых промпта помогают выполнить типовые сценарии от начала до конца: weekly_report, knowledge_gaps_review, lead_followup.

Конфиденциальность

Всё, что возвращает инструмент, может быть отправлено вашему AI-провайдеру (Anthropic, OpenAI и другим) в рамках беседы с агентом. Учитывайте это:

Контактные данные лидов по умолчанию маскируются. Имя, адрес электронной почты и номер телефона лида возвращаются в замаскированном виде (например, j***@example.com, +7***4567). Передайте contacts: "full" в get_conversation или list_leads, чтобы получить реальные данные в этом вызове.
Маскируются только эти поля. Текст сообщений, URL страниц и ссылки на вложения возвращаются без изменений. Посетители часто указывают адрес электронной почты или номер телефона прямо в чате, поэтому get_conversation может показать контактные данные, даже если поля лида замаскированы. Считайте, что в любых данных, возвращаемых инструментом, могут содержаться персональные данные.
Вложения представлены ссылками, а не содержимым. Файловые вложения возвращаются в виде URL, поэтому вызов инструмента не передаёт содержимое файла в контекст модели.

Внутренние и тестовые переписки не исключаются из результатов инструментов. Если вы тестируете собственный виджет, учитывайте, что эти обращения также будут отображаться в результатах.

Ограничения и лимиты запросов

search_conversations, list_leads, search_knowledge и list_knowledge_gaps по умолчанию возвращают 20 элементов, максимум — 100. Если результат усечён, об этом сообщается вместе с общим количеством элементов.

search_conversations и list_leads поддерживают постраничную загрузку с помощью cursor; для двух остальных инструментов сузьте запрос.

get_conversation по умолчанию возвращает 100 последних сообщений, максимум — 500.
Периоды задаются как скользящие интервалы, заканчивающиеся текущим моментом: 7d, 30d или 90d. Указывать произвольный диапазон дат нельзя. list_leads также можно вызвать без периода — тогда будут показаны данные за всю историю.
Для аккаунта и клиента действуют ограничения на частоту запросов. При превышении лимита сервер возвращает 429 с заголовком Retry-After. Подождите и повторите запрос.

Поддержка

Если у вас возникли вопросы или проблемы, обратитесь в Справочный центр Elfsight или к своему менеджеру аккаунта.