Активности с помощью MCP

Агент может подготовить черновик активности, изменить его и запросить запуск. Для работы с черновиками нужен боевой ключ на Pro или Enterprise с правами activities:read и activities:draft. Для запроса запуска нужен боевой ключ Enterprise с правом activities:control. Подключение даёт те же права.

Запуск и остановку подтверждаете вы в приложении. Агент вернёт ссылку на запрос; перед подтверждением проверьте настройки активности. Если запрос недоступен, проверьте тариф и права ключа или управляйте активностью в кабинете.

Три примера запросов#

Фразы можно адаптировать под свою задачу. Для работы с черновиками агенту нужны activities:read и activities:draft.

  1. Создать активность. «Подготовь черновик конкурса для моего канала [название]: название — [название], запуск — [дата и время], окончание — [дата и время], часовой пояс — [пояс]. Условия участия: [условия], призы: [призы]. Если каких-то данных не хватает, спроси меня. Покажи итог для проверки». Агент создаёт черновик, а не запускает его.
  2. Изменить черновик. «Найди мой черновик [название или ID], покажи текущие условия и призы, затем измени [что именно]. Покажи результат и сообщи, если нужное изменение недоступно». Инструменты изменения работают с черновиками.
  3. Подготовить запуск и анонс. «Проверь черновик [название или ID] и покажи его настройки. Если доступен запрос запуска, отправь его мне на подтверждение. Также подготовь в контент-плане [название] черновик анонса на [дата и время] с условиями и ссылкой [ссылка]». Для запроса запуска нужен боевой ключ Enterprise с правом activities:control или подключение с тем же правом; для поста нужны content:read и content:draft. Проверьте и подтвердите запуск в приложении, а пост согласуйте по правилам контент-плана.

Для тех, кто пишет интеграцию#

activities_list и activities_get читают активности; инструменты activities_draft_* создают и изменяют черновики. При записи нужен уникальный operation_id, а при изменении — актуальный expected_revision. Инструменты activities_request_launch и activities_request_stop создают запрос подтверждения, а activities_get_action_request показывает его состояние. Если у активности есть условие «комментарий», activities_get добавляет telegramCommentSetupWarnings с кодами tg_no_discussion_group и tg_bot_not_discussion_admin, когда проверка Telegram подтвердила проблему. Пустой список значит, что явной проблемы нет. Новое условие «комментарий» при tg_no_discussion_group не сохраняется: сначала привяжите группу обсуждений. Код tg_bot_not_discussion_admin условие не отклоняет, это предупреждение.