Управление Deskgram 2 через MCP

Управление Deskgram 2 через MCP

Подключите MCP-клиент к запущенному Deskgram 2, чтобы агент мог читать список аккаунтов, получать настройки модулей и работать с задачами. Для подключения используется локальный HTTP-адрес и токен из настроек программы.

Подключение агента

Откройте «Настройки → MCP» в Deskgram 2. Задайте токен, включите MCP listener и сохраните настройки. Проверьте статус и показанный адрес; по умолчанию это http://127.0.0.1:8765/mcp.

В MCP-клиенте укажите этот URL и заголовок Authorization: Bearer <token>. В OpenCode подключение задаётся в mcp.deskgram с type: remote, url, headers и enabled: true. Подставьте свой токен из настроек, а не placeholder из deskgram_get_mcp_instructions.

Адрес 127.0.0.1 относится к компьютеру, на котором работает клиент. Облачный агент не получает доступ к вашему Deskgram по этому адресу. Приложение должно оставаться запущенным.

Начните с deskgram_health, deskgram_echo и tools/list. Обмен идёт через POST JSON-RPC; авторизованный GET /mcp сейчас возвращает 405, отдельного SSE-потока нет. Совместимость каждого MCP-клиента проверяется отдельно.

Какие инструменты доступны

Подключение: deskgram_health, deskgram_echo, deskgram_get_mcp_instructions. Каталог модулей: deskgram_list_modules, deskgram_get_module_schema, deskgram_get_profile_setup_schema.

Аккаунты и папки: deskgram_list_accounts, deskgram_list_account_folders, deskgram_get_account, deskgram_get_account_limits. Для задач: deskgram_list_tasks, deskgram_get_task, deskgram_create_task и deskgram_stop_task.

Пакеты и проверка аккаунта: deskgram_validate_batch, deskgram_create_batch, deskgram_validate_account. Текущий каталог содержит 17 инструментов; фактические имена и схемы аргументов запрашиваются через tools/list.

Схемы модулей и границы доступа

Подробные проверяемые схемы доступны для profile_setup.validate_account, search_channels_groups и collect_audience. Агент получает параметры, значения по умолчанию и пример через deskgram_get_module_schema.

Для остальных разрешённых модулей может использоваться generic_adapter: общий запуск задачи без подробного контракта каждого поля. Наличие модуля в списке не означает одинаковую полноту схем.

Выберите allowed_modules и лимиты аккаунтов и входных получателей в настройках MCP. Планировщик scheduler через create_task не запускается. Прямое перемещение, архивирование, обновление данных и сброс лимитов аккаунтов через прежние MCP-инструменты заблокированы.

Проверка параметров и реальный запуск

Dry-run по умолчанию включён. Он проверяет структуру команды, действие и лимиты, но не подключается к Telegram и не проверяет session, прокси или доступ к выбранному чату.

Для реального создания задачи нужны allow_dangerous_tools=true и dry_run=false. Токен подключения сам по себе не разрешает запуск. Предпросмотр выполняйте через dry-run: создание с execute=false сейчас не поддерживается.

Например, сначала запросите схему search_channels_groups, укажите выбранные аккаунты и keywords, проверьте payload с dry_run=true. Запуск передаёт задачу существующему диспетчеру Deskgram; агент не заменяет его.

Результат, остановка и повтор команды

Ответ на создание возвращается до окончания задачи. Сохраните task_id и запросите deskgram_get_task с include_result=true. Завершение задачи не означает успешную обработку каждого аккаунта: проверяйте результат и ошибки.

После разрыва подключения сначала проверьте список задач. Idempotency-key для повторного создания пока нет, поэтому повтор команды может запустить вторую задачу. Для остановки есть deskgram_stop_task; разрешение dangerous-mode для неё не требуется.

Подключение клиента, dry-run и выполнение с живыми Telegram-аккаунтами — разные проверки. Схемы и локальный HTTP listener проверены изолированно; работа всех клиентов и всех модулей с реальными аккаунтами не заявляется.

Другие модули Deskgram 2