Кратко
Отправляйте в 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 и запусти через этот коннектор.
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 — Получите учётные данные
- В Telegram откройте чат с @BotFather, отправьте
/newbotи выберите отображаемое имя и имя пользователя, оканчивающееся наbot. - BotFather ответит токеном вида
123456789:ABCdef.... Храните его в секрете: любой, у кого он есть, может отправлять сообщения от имени вашего бота. - Вставьте полный токен в
TELEGRAM_BOT_TOKENи установите коннектор. Telegram ожидает токен в адресе запроса, и коннектор подставляет его туда сам. - Начните с
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" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти
gemini. - Выполни
/mcpв Gemini CLI (илиgemini mcp listв терминале):anythingmcpдолжен отображаться как подключённый. - Начинай писать промпты: Gemini CLI теперь может вызывать инструменты
Telegram Bot.
Доступные инструменты
| Tool | What it does |
|---|---|
telegram_bot_get_me | Return the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries |
telegram_bot_send_message | Send a text message to a chat |
telegram_bot_send_photo | Send a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id |
telegram_bot_send_document | Send a document (any type, ≤20MB via URL) by HTTPS URL or file_id |
telegram_bot_send_audio | Send an audio file (MP3, M4A, ≤20MB via URL) |
telegram_bot_send_voice | Send a voice note (OGG-Opus encoded) |
telegram_bot_send_video | Send a video (MP4, H.264, AAC, ≤20MB via URL) |
telegram_bot_send_location | Send a location point |
telegram_bot_send_poll | Send a poll (regular or quiz) |
telegram_bot_edit_message_text | Edit the text of a previously-sent message (your bot's own messages only) |
telegram_bot_delete_message | Delete a message the bot sent (within ~48 hours for groups, anytime for own DMs) |
telegram_bot_get_chat | Fetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions |
telegram_bot_get_updates | Long-poll recent inbound messages (one-shot: pulls all updates since the last offset+1) |
telegram_bot_send_album | Send 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_animation | Send a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop |
telegram_bot_send_sticker | Send 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_contact | Send a phone contact card that the recipient can save or call |
telegram_bot_send_venue | Send a venue: a map pin with a name and address, e.g. a shop or meeting point |
telegram_bot_get_file | Look 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_file | Download a file by the file_path telegram_bot_get_file returned |
telegram_bot_fetch_sticker_set | Read 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_message | Set the bot's reaction on a message (the emoji under a message), or remove it with an empty list |
telegram_bot_pin_message | Pin a message in a chat, so it shows at the top |
telegram_bot_unpin_chat_message | Unpin a pinned message in a chat; without message_id the most recently pinned message is unpinned |
telegram_bot_rename_chat | Change the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats |
telegram_bot_update_chat_description | Change the description of a group, supergroup or channel (0 to 255 characters; empty removes it) |
telegram_bot_add_forum_topic | Create a topic in a forum supergroup (a group with topics enabled) |
telegram_bot_edit_message_caption | Edit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it) |
telegram_bot_create_chat_invite_link | Create 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_set | Create a new sticker set owned by a user, with 1 to 50 first stickers from existing image files |
telegram_bot_extend_sticker_set | Add one sticker to a sticker set the bot created (telegram_bot_create_sticker_set) |
telegram_bot_get_webhook_info | Show 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_webhook | Remove 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 показывает каждый сервер и статус подключения.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Meta Muse
- Подключить к Microsoft Copilot
Это руководство помогло?