Автоматизация сетки Telegram-аккаунтов в Claude Code: протокол MCP и REST API

В современной разработке концепция «ИИ с доступом к инструментам» превратилась в базовый стандарт. Протокол MCP (Model Context Protocol) позволяет нейросетевым агентам вроде Claude и Claude Code нативно обращаться к сторонним сервисам. В DarkTelegram реализована поддержка полноценного MCP-сервера и публичного REST API, поэтому всю линейку возможностей — менеджмент аккаунтов, переписку, прогрев, инвайт, масс-директ, нейрокомментинг и работу со сторис — можно вызывать программно.

Зачем подключать аккаунты Telegram к ИИ-агенту

Веб-кабинет удобен при точечной работе. Если же вы держите массив профилей и одновременно ведёте прогрев, сбор базы, инвайтинг и рассылку, ручные манипуляции отнимают часы. Подключение ИИ-агента кардинально меняет подход благодаря трём ключевым преимуществам:

• Управление человеческими фразами. Подайте команду вида «Найди все учетки в статусе active, поставь прогрев на 48 часов и выдай отчёт», а агент самостоятельно сформирует цепочку запросов.
• Собственные цепочки автоматизации. Эндпоинты REST API без проблем интегрируются в приватные сервисы или связки n8n/Make: парсинг целевой аудитории → сборка кампании → старт → мониторинг ошибок в полностью автономном режиме.
• Сквозная логика между модулями. ИИ мгновенно обрабатывает ответы на предыдущие шаги: собрал активную аудиторию из целевой группы → отсеял спам-профили → отправил контакты в модуль инвайтинга без смены контекста.

Самое важное: за запросами стоит единое технологическое ядро сервиса с аналогичными правилами лимитов, алгоритмами прогрева, распределением прокси и шардингом. Агент выступает лишь более удобным командным интерфейсом.

Сравнение MCP и REST API: что выбрать

Оба решения обращаются к одинаковым микросервисам и используют один API-токен. Выбор зависит от архитектуры вашего решения.

	MCP	REST API
Целевые потребители	Claude Code, Claude Desktop, автономные ИИ-агенты	кастомный код, бэкенд-сервисы, платформы n8n / Make
Протокол взаимодействия	JSON-RPC 2.0 со строгой типизацией функций	Стандартные HTTP REST-запросы с JSON-пайлоадом
Контроль выполнения	Включённый по умолчанию dry_run для проверки плана	Прямое исполнение вызовов под управлением вашей логики
Эндпоинты	/api/v1/mcp	/api/v1/* и песочница /api/v1/docs

Резюмируя: для диалогового контроля текстовыми командами используйте MCP, а для программной автоматизации — REST API. Уровень доступа и ключи идентичны.

Пошаговое подключение к Claude Code

Сгенерируйте секретный токен dtg_live_… в панели управления (вкладка «Агенты и API», доступ открыт для тарифов Trial, Pro и Ultra). После этого выполните в терминале команду:

# Подключение remote-MCP сервера DarkTelegram в консоли Claude Code
claude mcp add --transport http darktelegram \
  https://darktelegram.pro/api/v1/mcp \
  --header "Authorization: Bearer dtg_live_ваш_ключ"

Для проверки успешности авторизации и загрузки списка доступных функций запустите:

claude mcp list
# darktelegram — ✓ подключено (45 инструментов)

При использовании Claude Desktop или других MCP-клиентов с файловой конфигурацией внесите настройки в JSON-файл:

{
  "mcpServers": {
    "darktelegram": {
      "type": "http",
      "url": "https://darktelegram.pro/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer dtg_live_ваш_ключ"
      }
    }
  }
}

Готово. Теперь агент готов принимать распоряжения по работе с сессиями. Важно: авторизационный токен хранится локально, а ИИ обращается к профилям только по их ID — файлы сессий (.session) и настройки прокси остаются в защищенном контуре сервиса.

Обзор 40+ инструментов для управления аккаунтами

Сразу после инициализации агенту открывается весь инструментарий. Разберём основные блоки:

• Управление профилями — получение списка аккаунтов с фильтрацией, выгрузка подробной информации, проверка валидности сессий через Telethon, безопасное удаление.
• Работа с чатами (web-tg) — история сообщений, полнотекстовый поиск, получение снимков переписок вместе с вложениями, определение @username, рассылка сообщений, простановка реакций и инвайтинг в группы. ИИ распознаёт прикрепленные изображения.
• Массовые операции — прогрев сессий, нейрокомментинг, инвайтинг, накрутка реакций/просмотров, Нейродиалоги, создание и запуск масс-директа, упоминания в сторис, автоматический граббер постов и ИИ-менеджер продаж. Каждый модуль поддерживает команды запуска, остановки и мониторинга.
• Шаблоны и аналитика — подгрузка каналов-доноров, готовые пресеты настроек и получение единого статуса выполнения процессов по их ID.

Все инструменты снабжены строгими JSON-схемами, созданными на основе внутренних моделей платформы. Агент заранее видит обязательные аргументы и не допускает ошибок в синтаксисе. К примеру, при вызове warmup_start передаются account_ids, max_messages, интервалы и общее время работы — те же опции, что и в графическом меню.

Примеры готовых промптов для работы

Ниже приведены практические сценарии запросов и логика их выполнения на сервере:

• «Выведи количество валидных аккаунтов и список тех, что находятся на прогреве» → вызов list_accounts в связке с feature_status warmup. Результат формируется в виде наглядного отчёта.
• «Включи 48-часовой прогрев для всех аккаунтов с меткой active» → серия вызовов list_accounts → warmup_start (с обязательной фазой предварительной проверки предпросмотра).
• «Отправь канал @target в модуль граббера и выведи свежие публикации» → исполнение grabber_add_channel с последующим grabber_channel_posts.
• «Запроси историю сообщений с @client через профиль ID 17 и сделай краткую выжимку» → цепочка chat_resolve_username → chat_snapshot с анализом текста и графических вложений.

Кастомные связки легко конструируются прямо по ходу общения: ИИ анализирует выгрузку предыдущей функции и на её основе выбирает следующий инструмент, что избавляет от необходимости совершать сотни кликов руками.

Защита аккаунтов от бана и ошибок агента

Делегирование управления реальными сессиями нейросети требует повышенной надежности. В DarkTelegram механизмы безопасности зашиты в архитектуру API, а не зависят от «внимательности» ИИ:

Кроме того, вы можете в один клик отозвать токен в кабинете управления, а строгая привязка к owner_id гарантирует изоляцию ваших ресурсов.

Прямой доступ через REST API

Для классической автоматизации без нейросетевого слоя используйте прямые HTTP-запросы. API всегда возвращает предсказуемую структуру ответа {data, error, request_id}:

# Запрос списка аккаунтов в статусе active
curl https://darktelegram.pro/api/v1/accounts?status=active \
  -H "Authorization: Bearer dtg_live_ваш_ключ"

# Старт прогрева с защитным заголовком Idempotency-Key
curl -X POST https://darktelegram.pro/api/v1/actions/warmup/start \
  -H "Authorization: Bearer dtg_live_ваш_ключ" \
  -H "Idempotency-Key: run-2026-06-06-01" \
  -H "Content-Type: application/json" \
  -d '{"account_ids":[17,18,19],"duration_hours":48}'

Интерактивная спецификация всех доступных эндпоинтов с функциями тестирования размещена в Swagger по адресу /api/v1/docs.

Архитектура и внутреннее устройство

Высокая скорость и отказоустойчивость системы при работе с сотнями аккаунтов на распределенных шардах обеспечиваются следующими архитектурными решениями:

• MCP как обёртка над REST. Запросы от MCP-сервера обращаются к единому бэкенду, проходя аналогичную валидацию, лимитирование и авторизацию.
• Привязка шардов к владельцу. Ресурсоемкие процессы обрабатываются именно на тех узлах, где запущены сессии Telethon, что устраняет проблемы с рассинхронизацией данных.
• Stateless-архитектура MCP. Сервер не сохраняет состояние между вызовами, обеспечивая легкое горизонтальное масштабирование и стабильность при обновлениях.

В итоге вы получаете простой инструмент: активируете ключ и отдаёте команды всей сети аккаунтов простыми словами, а вопросы балансировки, управления прокси и соблюдения лимитов платформа берёт на себя.