Гайд

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 хвилин і не розкриває ключі й сесії.

Готові перейти до панелі?

Перегляньте обмеження сценарію перед запуском.

Створити акаунт