Руководство по коннектору8 мин чтенияMCP-инструментов: 337 языков

Telegram MCP: подключить к Gemini CLI

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

HCАвтор: команда HelpCodeОбновлено 8 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Telegram Bot

Telegram Bot

Send Telegram messages, photos, albums, documents, audio, video, animations, stickers, contacts, venues, locations and polls from any AI agent via the Telegram Bot API, react to and pin messages, and manage group titles, invite links and forum topics. Bot-token auth. Outbound plus a lightweight read of recent updates (no long-polling).

инструментов

33

Регион

INTL

Категория

Мессенджеры

Аутентификация

API credentials

Требуемые env-vars

TELEGRAM_BOT_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Пошаговая настройка

Подключи Telegram Bot к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Telegram Bot в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для Telegram Bot

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Telegram Bot · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Telegram Bot, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Telegram Bot + Gemini

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TELEGRAM_BOT_TOKEN

Шаг 1 — Получите учётные данные

  1. В Telegram откройте чат с @BotFather, отправьте /newbot и выберите отображаемое имя и имя пользователя, оканчивающееся на bot.
  2. BotFather ответит токеном вида 123456789:ABCdef.... Храните его в секрете: любой, у кого он есть, может отправлять сообщения от имени вашего бота.
  3. Вставьте полный токен в TELEGRAM_BOT_TOKEN и установите коннектор. Telegram ожидает токен в адресе запроса, и коннектор подставляет его туда сам.
  4. Начните с telegram_bot_get_me, чтобы проверить, что токен работает.

Кому может писать бот: у каждого чата есть числовой chat_id. Пользователь должен хотя бы раз отправить вашему боту /start, а в группы и каналы бота нужно сначала добавить. Публичные каналы принимают и @channelusername; для приватных каналов нужен числовой id, который начинается с -100. telegram_bot_get_updates показывает последние входящие сообщения с их chat id.

Что он отправляет: текстовые сообщения (форматирование HTML надёжнее всего), фото, альбомы, документы, аудиофайлы, голосовые сообщения, видео, GIF-анимации, стикеры, карточки контактов, места, геопозиции (в том числе трансляцию геопозиции) и опросы или викторины. Он также может редактировать и удалять свои сообщения и читать сведения о чате.

Альбомы: telegram_bot_send_album отправляет от 2 до 10 фото и видео одним сгруппированным сообщением, либо от 2 до 10 документов, либо от 2 до 10 аудиофайлов; документы и аудио нельзя смешивать с другими типами. Подпись ставится к первому элементу. Если Telegram сообщает WEBPAGE_CURL_FAILED для какого-то элемента, он не смог скачать этот файл: ссылка должна быть публичной и вести прямо на файл, а не на веб-страницу.

Файлы: медиа отправляются по ссылке HTTPS (до 5 МБ для фото и до 20 МБ для остальных файлов) или по file_id ранее отправленного файла. Загрузить файл с вашего компьютера в том же вызове нельзя.

Реакции, закрепление и управление чатом: бот может поставить реакцию-эмодзи на сообщение и изменить подпись к фото, видео или документу, которые он отправил. В группах и каналах, где он администратор с нужным правом (закреплять сообщения, изменять информацию о чате, приглашать пользователей, управлять темами), он закрепляет и открепляет сообщения, переименовывает чат, меняет его описание, создаёт дополнительные пригласительные ссылки (с названием, сроком действия или лимитом вступлений) и открывает темы в группах-форумах. Ещё он может собрать готовые изображения в новый набор стикеров, принадлежащий пользователю, и добавлять в него стикеры. telegram_bot_get_webhook_info показывает, есть ли у бота webhook; пока он установлен, telegram_bot_get_updates отвечает 409 Conflict. telegram_bot_remove_webhook удаляет webhook и при установке выключен, потому что сервис, который его принимает (чат-бот, автоматизация), перестаёт получать сообщения: включайте его осознанно на странице коннектора; ИИ спрашивает перед каждым изменением.

Уже установлен? Новые инструменты попадают в ранее установленный коннектор через обновление каталога: откройте коннектор в AnythingMCP, в разделе Catalog update available проверьте список новых инструментов и нажмите Apply update. Ваш токен бота и инструменты, которые вы добавили сами, останутся без изменений, а telegram_bot_remove_webhook приходит выключенным, как при новой установке.

Лимиты отправки: около 30 сообщений в секунду в разные чаты, 1 в секунду в один и тот же чат и 20 в минуту в одну группу. При ответе 429 Telegram сообщает, сколько нужно подождать.

Коннектор читает последние обновления по запросу и не запускает чат-бота, который отвечает сам: для этого нужен webhook, размещённый у вас. Платежи, inline-режим и игры не поддерживаются.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти gemini.
  3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
  4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Telegram Bot.

Доступные инструменты

ToolWhat it does
telegram_bot_get_meReturn the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries
telegram_bot_send_messageSend a text message to a chat
telegram_bot_send_photoSend a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id
telegram_bot_send_documentSend a document (any type, ≤20MB via URL) by HTTPS URL or file_id
telegram_bot_send_audioSend an audio file (MP3, M4A, ≤20MB via URL)
telegram_bot_send_voiceSend a voice note (OGG-Opus encoded)
telegram_bot_send_videoSend a video (MP4, H.264, AAC, ≤20MB via URL)
telegram_bot_send_locationSend a location point
telegram_bot_send_pollSend a poll (regular or quiz)
telegram_bot_edit_message_textEdit the text of a previously-sent message (your bot's own messages only)
telegram_bot_delete_messageDelete a message the bot sent (within ~48 hours for groups, anytime for own DMs)
telegram_bot_get_chatFetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions
telegram_bot_get_updatesLong-poll recent inbound messages (one-shot: pulls all updates since the last offset+1)
telegram_bot_send_albumSend 2 to 10 photos or videos as one album (sendMediaGroup), or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be…
telegram_bot_send_animationSend a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop
telegram_bot_send_stickerSend a sticker by file_id (any sticker the bot has seen, e.g. from telegram_bot_get_updates) or by HTTPS URL of a .WEBP image
telegram_bot_send_contactSend a phone contact card that the recipient can save or call
telegram_bot_send_venueSend a venue: a map pin with a name and address, e.g. a shop or meeting point
telegram_bot_get_fileLook up a file the bot received (photo, document, voice note, video) by its file_id, from a message in telegram_bot_get_updates
telegram_bot_download_fileDownload a file by the file_path telegram_bot_get_file returned
telegram_bot_fetch_sticker_setRead a sticker set (or custom emoji set) by its name: title, sticker_type (regular, mask, custom_emoji) and every sticker with its emoji…
telegram_bot_react_to_messageSet the bot's reaction on a message (the emoji under a message), or remove it with an empty list
telegram_bot_pin_messagePin a message in a chat, so it shows at the top
telegram_bot_unpin_chat_messageUnpin a pinned message in a chat; without message_id the most recently pinned message is unpinned
telegram_bot_rename_chatChange the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats
telegram_bot_update_chat_descriptionChange the description of a group, supergroup or channel (0 to 255 characters; empty removes it)
telegram_bot_add_forum_topicCreate a topic in a forum supergroup (a group with topics enabled)
telegram_bot_edit_message_captionEdit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it)
telegram_bot_create_chat_invite_linkCreate an additional invite link for a group, supergroup or channel, optionally named, expiring, limited to a number of joins, or requiring…
telegram_bot_create_sticker_setCreate a new sticker set owned by a user, with 1 to 50 first stickers from existing image files
telegram_bot_extend_sticker_setAdd one sticker to a sticker set the bot created (telegram_bot_create_sticker_set)
telegram_bot_get_webhook_infoShow whether the bot has a webhook: its url (empty when none), pending_update_count, the last error date and message, and allowed_updates
telegram_bot_remove_webhookRemove the bot's webhook so updates can be read with telegram_bot_get_updates again

Примеры запросов

  • «Отправьте фото по этим четырём ссылкам одним альбомом в канал нашей команды с подписью „Новая коллекция, доступна с сегодняшнего дня“.»
  • «Опубликуйте опрос в группе продаж: какой день подходит для квартального обзора, вторник или четверг?»
  • «Отправьте адрес нашего магазина как место в чат с клиентом, чтобы он мог открыть его в приложении карт.»
  • «Покажите сообщения, которые бот получил за последний час, и кто их отправил.»
  • «Закрепите в группе клиентов сообщение о часах работы в праздники и поставьте на него реакцию „палец вверх“.»
  • «Создайте пригласительную ссылку для бета-группы, которая истекает в пятницу и допускает не более 50 вступлений.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

Это руководство помогло?

Подключи Telegram Bot к Gemini за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Telegram Bot в пошаговой настройке и добавь свой MCP URL в Gemini. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Telegram MCP: подключить к Microsoft Copilot

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Коннекторы

Telegram MCP: подключить к Meta Muse

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Коннекторы

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

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Коннекторы

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

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Коннекторы

Telegram MCP: подключить к Cursor

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).

Коннекторы

Telegram MCP-сервер: сообщения и медиа

Отправляйте в Telegram сообщения, фото, альбомы, документы, аудио, видео, анимации, стикеры, контакты, места, геопозиции и опросы из любого ИИ-агента через Telegram Bot API. 33 инструмента, авторизация по токену бота. Отправка плюс облегчённое чтение последних обновлений (без long polling).