StreamVi Account MCP

StreamVi Account MCP работает от имени аккаунта StreamVi с доступными ему проектами. Адрес сервера: https://mcp-streamvi-account.senler.io/mcp. Это отдельное подключение от проектного StreamVi MCP и от канала StreamVi, который передаёт сообщения трансляций в Senler.

Подготовьте подключение

Для посетителей виджета используйте готовое подключение StreamVi Account в режиме «По лидам» и добавьте его отвечающему агенту. Шаблон подключения должен поддерживать авторизацию по лидам и ручной токен. Добавление произвольного URL не заменяет установленное из шаблона подключение для сохранения пользовательских credentials.

Backend сайта получает действующий токен аккаунта StreamVi и определяет пользователя по своей авторизованной сессии. Не используйте проектный токен вместо аккаунтного и не передавайте общий токен всем посетителям.

Передайте токен с backend

В серверном запросе сохранения авторизации пользователя укажите credential_type: "bearer", auth_method: "manual" и такой secret_payload:

{
  "access_token": "<STREAMVI_ACCOUNT_TOKEN>",
  "token_type": "Bearer",
  "subject_type": "account",
  "subject_user_id": 123
}

subject_user_id обозначает пользователя StreamVi, которому принадлежит токен. Он не является project_id, ID лида Senler или ID установленного MCP. Значение определяет backend, а не текст сообщения посетителя.

Для ручного аккаунтного токена scope необязателен: StreamVi проверяет права при каждом запросе. Если передать scope, он дополнительно ограничит доступные методы. OAuth-авторизация использует выданные OAuth-разрешения; правила ручного токена не отменяют их.

Затем инициализируйте виджет с подписанным внешним ID. В external_user_id серверного запроса и user.external_id виджета должен быть один и тот же ID посетителя сайта. Токен остаётся на сервере, в браузер передаются только ID и user_hash. Обновление и отзыв описаны в той же инструкции.

Выберите проект для действия

Для операций над проектом агент сначала находит доступный проект, затем передаёт его числовой project_id конкретному методу. Текстовый код проекта в кабинете StreamVi не равен этому ID. MCP позволяет найти проект по внешнему коду; его нужно передавать без изменения регистра и ведущих нулей.

Пользовательский ID не подставляется вместо проекта. Для управления существующим каналом также нужен внутренний ID, который возвращает поиск каналов, а не ID платформы. Агент должен читать схему найденного метода и использовать возвращённые идентификаторы. Разрешения аккаунта проверяются StreamVi независимо от того, что попросил посетитель в чате.