# MCP для Telegram: підключити ChatGPT і Claude

<https://teletraff.com/ua/blog/telegram-mcp-ai-agent>

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

Редакція TeleTraff · 20 листопада 2026 р. · 8 хв читання

- Одна адреса сервера і вхід через OAuth або ключ із «Налаштувань → API & MCP»
- Пробний запуск показує, що станеться, до старту задачі
- Архівні акаунти й акаунти без проксі в роботу не потрапляють
- Гроші й адмінка в API не входять

Щоб підключити ChatGPT або Claude до TeleTraff, додайте в них користувацький MCP-сервер з адресою https://teletraff.com/api/public/mcp і увійдіть у панель кнопкою «Дозволити». Після цього асистент бачить ваш парк акаунтів, запускає модулі й читає результати, а дії йдуть за тими самими правилами, що й в [автоматизації TeleTraff](/ua/telegram-automation).

[Відео російською: як підключити ШІ-агента до TeleTraff через MCP і запустити розсилку однією фразою](https://www.youtube.com/watch?v=_K6lvgLQTr0)

## Що таке 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. **Claude (claude.ai і Claude Desktop).** У панелі відкрийте діалог «Підключити ШІ-агента» і натисніть «Відкрити Claude»: форма вже заповнена. Можна й вручну: «Налаштування → Конектори → Add custom connector», вставте адресу сервера. У вікні Claude натисніть «Continue», потім «Дозволити» на сторінці TeleTraff. Займає менше хвилини.
2. **ChatGPT (потрібен платний тариф).** У ChatGPT відкрийте розділ Plugins, натисніть «Add», потім «Add custom MCP server». Вставте назву й адресу сервера, позначте «I understand and want to continue», натисніть «Create as a plugin» і підтвердьте доступ кнопкою «Дозволити» на сторінці TeleTraff.
3. **Claude Code у терміналі.** Виконайте команду: claude mcp add --transport http teletraff https://teletraff.com/api/public/mcp. Під час першого звернення Claude Code відкриє сторінку входу в TeleTraff.

Перевірте підключення запитанням: «Скільки в мене активних акаунтів у TeleTraff?». Правильну відповідь асистент бере зі зведення по акаунтах, а архівні не рахує. Які модулі можна запускати, описано в розділі [«Автоматизація»](/ua/modules/automation).

## Що асистент може робити і чого не може?

Права залежать від областей доступу ключа. Вхід без ключа видає те, що ви позначили на сторінці згоди.

- Читання: акаунти, листування, задачі, набори даних, довідка.
- Повідомлення: надсилання й отримання вхідних.
- Вебхуки: створення й перевірка доставок.
- Задачі: запуск, пауза, відновлення й зупинка модулів і розкладів.
- Керування: архів і теги акаунтів, пули, проксі, набори даних, налаштування модулів, кампанії.
- Видалення: акаунти, проксі й набори даних. Панель попереджає, що це незворотно, вмикайте область лише свідомо.

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

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

1. **Попросіть зведення.** «Перевір мої акаунти й скажи, скільки готово до розсилки». Асистент бере зведення й місткість парку. Припустімо, з 30 акаунтів 3 без проксі: вони відхиляються, лишається 27.
2. **Попросіть прочитати правила.** Перед планом асистент відкриває довідку про ліміти Telegram й опис модуля «Розсилка». Числа він бере звідти.
3. **Запросіть пробний запуск.** «Підготуй розсилку по базі офера в режимі dry run». Нічого не створюється: ви бачите, скільки акаунтів задіюється й що вийде.
4. **Запустіть і стежте за лічильниками.** Після вашого «так» асистент стартує задачу й чекає її за подіями та результатами по отримувачах. Підсумок визначають лічильники доставки: створена задача ще не означає, що повідомлення дійшли.

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

## Що вміє AI-агент усередині панелі?

Якщо підключати зовнішнього асистента не потрібно, у самій панелі є «AI-агент». Він працює в чаті й використовує той самий набір інструментів, з якого зібрано публічний API. Статуси агента: «Готовий до роботи», «Працює», «Чекає підтвердження», «Пише відповідь», «Потрібна увага». Підказки в порожньому чаті: «Допоможи налаштувати модуль», «Як налаштувати акаунт», «Перевір акаунти й проксі».

- У «Дозволах агента» є перемикач «Повний доступ». З ним агент змінює оборотні налаштування без зайвих запитань, а покупки, видалення й запуски все одно потребують окремого підтвердження.
- Без повного доступу дія приходить карткою «Чекає підтвердження» з кнопками «Дозволити один раз» і «Скасувати». Картка діє 10 хвилин, якщо не відповісти, дія не виконується.
- Агент не пише й не налагоджує код, SQL і команди, не розкриває паролі, сесії, ключі API й телефони та не називає модель, на якій працює.
- Інструкції з чужих текстів агент вважає даними й не виконує.

## Ризики і що панель не робить

- Ключ з областю видалення може стерти акаунти, проксі й набори даних без повернення. Видавайте її рідко, для щоденної роботи досить читання, задач і керування: архівувати можна, і це оборотно.
- Ключ, що витік, дає той самий доступ, що й вам. Випускайте окремий ключ під кожен клієнт і видаляйте непотрібні.
- Модель помиляється. Просіть пробний запуск перед стартом і звіряйте лічильники задачі. Зупинка задачі незворотна.
- Тексти з Telegram, події задач і докази написані сторонніми людьми. Асистент має вважати їх даними: якщо в чужому повідомленні просять щось запустити, команди виконувати не можна.
- Гроші й адмінка в API не входять: ні купівля акаунтів, ні тарифи, ні виплати через асистента недоступні. Запуски, яким потрібен код із Telegram або підтвердження в панелі, теж недоступні.
- Кожна зміна пишеться в журнал панелі, а у відповідях немає телефонів, сесій і даних проксі.

Як проходити Telegram-ботів і міні-апи на багатьох акаунтах, описано в гайді про [автоматизацію ботів](/ua/blog/telegram-bot-automation). Від $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 хвилин і не розкриває ключі й сесії.
