Руководство по использованию прокси аккаунта Telegram

Это не бот Telegram Bot API. Не используйте его для спама, массовых холодных рассылок или обхода ограничений Telegram. Перед отправкой, редактированием или удалением контента третьим лицам ваш Agent должен получить явное подтверждение.

​

Развёртывание и вход

1. Создайте прокси аккаунта Telegram в Консоль → Приложения, после оформления подписки нажмите развёртывание. Ресурсы экземпляра автоматически настраиваются платформой.
2. После готовности экземпляра нажмите «Сгенерировать QR-код для входа». QR-код действует ограниченное время; после истечения срока его можно сгенерировать повторно.
3. В Telegram откройте Настройки → Устройства → Подключить устройство компьютера и отсканируйте QR-код.
4. Если статус изменится на password_required, введите в консоли пароль двухэтапной проверки Telegram. Пароль отправляется только в экземпляр вашего арендатора и не записывается в конфигурацию платформы.
5. После изменения статуса на authenticated консоль отобразит текущий аккаунт, адрес MCP и токен доступа Bearer.

​

Аутентификация и проверка работоспособности

Authorization: Bearer <访问令牌>

curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/health
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/readyz

{"status":"ok"}

{"status":"ready","gateway_connected":true,"login_state":"login_required"}

​

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

​

Claude Code

claude mcp add \
  --transport http \
  --header "Authorization: Bearer <访问令牌>" \
  telegram \
  https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp

​

Cursor и другие клиенты, поддерживающие статические заголовки запросов

{
  "mcpServers": {
    "telegram": {
      "type": "http",
      "url": "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer <访问令牌>"}
    }
  }
}

​

Инструменты MCP

​

REST API

​

Примеры

# 当前账号
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/whoami \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 最近会话
curl "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/chats?limit=20&unread_only=false" \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 给 Saved Messages 发一条测试消息
curl -X POST https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/messages \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"me","text":"Hello from my Telegram proxy"}'

​

Полный список интерфейсов

​

Часто задаваемые вопросы

• 401：Bearer-токен отсутствует или неверен. Убедитесь, что токен помещён в заголовок запроса, а не в параметры URL-запроса.
• 503：токен доступа к прокси не настроен, или клиент Telegram ещё не готов. Сначала проверьте /readyz; если токен доступа к прокси не настроен, защищённые интерфейсы также вернут 503.
• 400：параметры или JSON недействительны; для поиска необходимо указать q, а limit должен быть целым числом, большим или равным 1.
• 403 / 404：текущая учётная запись не имеет прав, либо target / message ID не существует.
• 429：сработало ограничение частоты Telegram. Прочитайте retry_after и подождите, не повторяйте запросы параллельно.
• QR-код всё ещё не завершён：создайте QR-код заново и убедитесь, что используется вход Telegram для сканирования «Подключить устройство».
• После перезапуска требуется повторный вход：проверьте, нормально ли работает постоянный том экземпляра; после выхода вручную, отзыва сессии в списке устройств Telegram или истечения срока действия сессии требуется повторное сканирование.

​

Область проверки