Гайд

MCP для Telegram: подключить ChatGPT и Claude

Как подключить панель TeleTraff к Claude и ChatGPT через MCP: адрес сервера, вход с ключом и без, лимиты, пробный запуск и что агент не делает.

Редакция TeleTraff·Опубликовано: · 8 мин чтения
  • Один адрес сервера и вход через OAuth или ключ из «Настроек → API & MCP»
  • Пробный запуск показывает, что произойдёт, до старта задачи
  • Архивные аккаунты и аккаунты без прокси в работу не попадают
  • Деньги и админка в API не входят

Чтобы подключить ChatGPT или Claude к TeleTraff, добавьте в них пользовательский MCP-сервер с адресом https://teletraff.com/api/public/mcp и войдите в панель кнопкой «Разрешить». После этого ассистент видит ваш парк аккаунтов, запускает модули и читает результаты, а действия идут через те же правила, что и в автоматизации TeleTraff.

Видео: как подключить ИИ-агента к TeleTraff через MCP и запустить рассылку одной фразой

Что такое MCP и какой адрес у сервера TeleTraff?

MCP (Model Context Protocol) — это общий способ, которым ИИ-ассистент получает доступ к внешним сервисам: сервис выдаёт список инструментов, а ассистент вызывает их по вашей просьбе. У TeleTraff такой сервер открыт для каждого рабочего пространства.

  • Адрес сервера: https://teletraff.com/api/public/mcp.
  • Протокол: Streamable HTTP, запросы отправляются POST. Сервер не хранит сессию между запросами.
  • Пароли, сессии Telegram-аккаунтов и данные прокси в ответы не попадают: ассистент видит статусы, счётчики и результаты.

Как войти: через ключ или без ключа?

  • Без ключа (OAuth): вы подтверждаете доступ на странице TeleTraff, ключ копировать не нужно. Вход действует 1 час и продлевается автоматически до 30 дней. Отключить его можно в «Настройки → API & MCP → Ключи API».
  • С ключом: в «Настройки → API & MCP» нажмите «Создать ключ», затем «Выпустить ключ». Перед формой панель просит подтвердить личность, а для выпуска нужен подтверждённый email. Ключ вставляется в настройки клиента как Bearer-токен.

Ключ показывают один раз

Сразу после выпуска панель пишет «Больше не покажем» и показывает ключ полностью только в этот момент. Сохраните его в менеджере паролей. Если ключ утёк, удалите его в «Ключах API», ассистент с этим ключом сразу потеряет доступ.

Как подключить Claude, ChatGPT и Claude Code?

  1. 1

    Claude (claude.ai и Claude Desktop)

    В панели откройте диалог «Подключить ИИ-агента» и нажмите «Открыть Claude»: форма уже заполнена. Можно и вручную: «Настройки → Коннекторы → Add custom connector», вставьте адрес сервера. В окне Claude нажмите «Continue», затем «Разрешить» на странице TeleTraff. Занимает меньше минуты.

  2. 2

    ChatGPT (нужен платный тариф)

    В ChatGPT откройте раздел Plugins, нажмите «Add», затем «Add custom MCP server». Вставьте имя и адрес сервера, отметьте «I understand and want to continue», нажмите «Create as a plugin» и подтвердите доступ кнопкой «Разрешить» на странице TeleTraff.

  3. 3

    Claude Code в терминале

    Выполните команду: claude mcp add --transport http teletraff https://teletraff.com/api/public/mcp. При первом обращении Claude Code откроет страницу входа в TeleTraff.

Проверьте подключение вопросом: «Сколько у меня активных аккаунтов в TeleTraff?». Правильный ответ ассистент берёт из сводки по аккаунтам, а архивные не считает. Какие модули можно запускать, описано в разделе «Автоматизация».

Что ассистент может делать и чего не может?

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

  • Чтение: аккаунты, переписки, задачи, наборы данных, справка.
  • Сообщения: отправка и получение входящих.
  • Вебхуки: создание и проверка доставок.
  • Задачи: запуск, пауза, возобновление и остановка модулей и расписаний.
  • Управление: архив и теги аккаунтов, пулы, прокси, наборы данных, настройки модулей, кампании.
  • Удаление: аккаунты, прокси и наборы данных. Панель предупреждает, что это необратимо, включайте область только осознанно.
  • Не больше 60 запросов за 60 секунд на один ключ. При превышении сервер отвечает ошибкой и временем ожидания.
  • Операции панели, которые что-то меняют: не больше 30 вызовов в минуту на ключ.
  • Пробный запуск (dry run) доступен для задач и для отправки сообщения: задача не создаётся, ассистент получает предпросмотр запуска.
  • Повтор одинаковой отправки не уйдёт дважды.
  • Холодные сообщения идут в заданном темпе. По умолчанию это осторожный: 5 сообщений в час и 20 в день с аккаунта. Сбалансированный даёт 10 и 40, быстрый 20 и 80. Ответы людям, которые написали последними, эти лимиты не тратят.
  • Архивные и выключенные аккаунты никогда не попадают в списки и запуски. Аккаунты без прокси панель отклоняет.

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

  1. 1

    Попросите сводку

    «Проверь мои аккаунты и скажи, сколько готово к рассылке». Ассистент берёт сводку и ёмкость парка. Допустим, из 30 аккаунтов 3 без прокси: они отклоняются, остаётся 27.

  2. 2

    Попросите прочитать правила

    Перед планом ассистент открывает справку по лимитам Telegram и описание модуля «Рассылка». Числа он берёт оттуда.

  3. 3

    Запросите пробный запуск

    «Подготовь рассылку по базе оффера в режиме dry run». Ничего не создаётся: вы видите, сколько аккаунтов задействуется и что получится.

  4. 4

    Запустите и следите по счётчикам

    После вашего «да» ассистент стартует задачу и ждёт её по событиям и результатам по получателям. Итог определяют счётчики доставки: созданная задача ещё не значит, что сообщения дошли.

В осторожном темпе 27 аккаунтов отправляют до 135 холодных сообщений в час и до 540 в день. Это верхняя граница: Telegram может ограничить аккаунт раньше. Аккаунт, получивший PeerFlood, API держит 24 часа и в новые запуски не берёт.

Что умеет AI-агент внутри панели?

Если подключать внешний ассистент не нужно, в самой панели есть «AI-агент». Он работает в чате и использует тот же набор инструментов, из которого собран публичный API. Статусы агента: «Готов к работе», «Работает», «Ждёт подтверждения», «Пишет ответ», «Требуется внимание». Подсказки в пустом чате: «Помоги настроить модуль», «Как настроить аккаунт», «Проверь аккаунты и прокси».

  • В «Разрешениях агента» есть переключатель «Полный доступ». С ним агент меняет обратимые настройки без лишних вопросов, а покупки, удаления и запуски всё равно требуют отдельного подтверждения.
  • Без полного доступа действие приходит карточкой «Ждёт подтверждения» с кнопками «Разрешить один раз» и «Отменить». Карточка действует 10 минут, если не ответить, действие не выполняется.
  • Агент не пишет и не отлаживает код, SQL и команды, не раскрывает пароли, сессии, ключи API и телефоны и не называет модель, на которой работает.
  • Инструкции из чужих текстов агент считает данными и не выполняет.

Риски и что панель не делает

  • Ключ с областью удаления может стереть аккаунты, прокси и наборы данных без возврата. Выдавайте её редко, для повседневной работы хватает чтения, задач и управления: архивировать можно, и это обратимо.
  • Утёкший ключ даёт тот же доступ, что и вам. Выпускайте отдельный ключ под каждый клиент и удаляйте ненужные.
  • Модель ошибается. Просите пробный запуск перед стартом и сверяйте счётчики задачи. Остановка задачи необратима.
  • Тексты из Telegram, события задач и доказательства написаны посторонними людьми. Ассистент обязан считать их данными: если в чужом сообщении просят что-то запустить, команды выполнять нельзя.
  • Деньги и админка в API не входят: ни покупка аккаунтов, ни тарифы, ни выплаты через ассистента недоступны. Запуски, которым нужен код из Telegram или подтверждение в панели, тоже недоступны.
  • Каждое изменение пишется в журнал панели, а в ответах нет телефонов, сессий и данных прокси.

Как проходить Telegram-ботов и мини-аппы на многих аккаунтах, описано в гайде про автоматизацию ботов. От $29 за 30 дней на тарифе Starter: 10 потоков в каждом модуле. Pro стоит $59 (50 потоков), Team $99 (150 потоков). Пробный период 3 дня начинается с первого импортированного аккаунта. Аккаунты и прокси покупаются отдельно.

Частые вопросы

Какой адрес MCP-сервера у TeleTraff?

https://teletraff.com/api/public/mcp. Один и тот же адрес подходит для Claude, ChatGPT и Claude Code, различается только способ входа.

Нужен ли ключ, чтобы подключить Claude или ChatGPT?

Нет. Вход без ключа идёт через OAuth: вы нажимаете «Разрешить» на странице TeleTraff. Ключ из «Настроек → API & MCP» нужен клиентам, которые OAuth не поддерживают. В ChatGPT понадобится платный тариф.

Может ли ассистент отправить сообщение или запустить рассылку сам?

Да, если у ключа или входа есть нужные области доступа. Перед стартом он должен сделать пробный запуск, а холодные сообщения идут в заданном темпе: по умолчанию 5 в час и 20 в день с аккаунта.

Увидит ли ассистент пароли и сессии моих аккаунтов?

Нет. В ответах API нет телефонов, сессий и данных прокси, а любое изменение попадает в журнал панели.

Чем MCP отличается от AI-агента в панели?

MCP подключает внешний ассистент, например Claude или ChatGPT, к вашему рабочему пространству. AI-агент живёт внутри панели, спрашивает подтверждение карточкой на 10 минут и не раскрывает ключи и сессии.

Готовы перейти к панели?

Изучите ограничения сценария перед запуском.

Создать аккаунт