Настройка чата (JSBOX) через MCP

Обновлено: Sep 6, 2026Раздел: Начало работы

Skill для агента: минимум правил для настройки интеграции JSBOX (чат-виджет) через Mailoo MCP. Расширяйте этот документ по факту подтверждённых сценариев --- не добавляйте шаги сверх перечисленных инструментов.

Когда использовать

  • Создать или найти интеграцию JSBOX, затем прочитать или обновить настройки виджета / подключения.
  • Прочитать lifetime counts сообщений и чат-сессий для одной JSBOX интеграции (только числа).

Инструменты

  • list_projects / create_project
  • list_integrations с type=JSBOX (или create_integration с type=JSBOX --- только OWNER)
  • manage_jsbox_integration_settings --- action=get, action=update, upload_kb_file или delete_kb_file
  • get_activity_digest --- опционально; недавние счётчики за окно времени (фильтр integrationIds)
  • manage_blog_media --- только если задаёте chatWidget.agent.imageMediaId

Правила

  1. Для настроек после создания используйте manage_jsbox_integration_settings. Не полагайтесь на сырой config в create_integration для дальнейших изменений.
  2. При update: опущенное поле сохраняется; null на секцию очищает её; опущенный chatWidget.agent сохраняет текущего агента.
  3. Если chatWidget.agent.enabled равен true, обязательны name, kbIntegrationId, instructions, kbDigestPrompt и kbArticlePrompt. kbIntegrationId должен быть интеграцией BLOG в том же проекте. Файлы KB --- upload_kb_file / delete_kb_file.
  4. get возвращает настройки и counts (всего сообщений; всего сессий и по статусам OPEN / PENDING / CLOSED). Не возвращает id сессий, данные посетителя и тела сообщений.
  5. Список сессий, ответ, assign и close через MCP недоступны. Для этого --- дашборд.
  6. Доступ не шире владельца MCP-токена: membership EDITOR или выше по проекту / интеграции.

См. также

  • mailoo-mcp{.interpreted-text role="doc"} --- токены, endpoint, полный список инструментов
  • chat-widget{.interpreted-text role="doc"} --- поведение продукта JSBOX
📚