Connector guide2-minute read13 MCP toolsEnglish · Deutsch · Italiano

如何将 Telegram Bot 连接到 Claude — 通过 MCP

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Telegram Bot

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

Tools

13

Region

INTL

Category

Messaging

Authentication

Required env vars

TELEGRAM_BOT_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Telegram Bot in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

💡 无需安装? 直接使用 cloud.anythingmcp.com 登录、点击 Connectors → Telegram Bot、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

Telegram Bot + Claude

Send Telegram messages, photos, documents, audio, location and polls from any AI agent via the Telegram Bot API. 14 tools, bot-token auth. Outbound + lightweight read of recent updates (no long-polling).

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

TELEGRAM_BOT_TOKEN

步骤 1 — 获取凭证

telegram.org/bots/api).

Setup:

  1. In Telegram, open chat with @BotFather/newbot → pick a display name and a username ending in bot.
  2. BotFather replies with an HTTP API token like 123456789:ABCDEFghijklmnopqrstuvwxyz. Treat as a secret — anyone with it can send as your bot.
  3. Set TELEGRAM_BOT_TOKEN to the full token.

Authentication model (Telegram-specific): the bot token goes in the URL path, NOT in a header. The base URL is https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN} and every endpoint is appended as /methodName. The adapter substitutes the token via the {{TELEGRAM_BOT_TOKEN}} env-var template in baseUrl.

…(continued in the in-app connector instructions)

步骤 2 — 安装 adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

步骤 3 — 在 Claude 中添加连接器

推荐路径 — 在 claude.ai web 上工作,无需触碰任何配置文件。

  1. 打开 claude.ai/customize/connectors
  2. 点击 "Add custom connector"
  3. 填入:
    • Name: Telegram Bot
    • URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → 粘贴你的 MCP API key (来自 AnythingMCP → Profile → MCP API Keys → New Key)
  4. 点击 Connect 授权。

下面所有工具都会出现在你的聊天中 — 开始输入提示。

可用工具

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
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)

FAQ

Claude Code 和 Claude Desktop 一样工作吗? 是的 — 两者都指向 https://cloud.anythingmcp.com/mcp

下一步

Ready to ship

Your Telegram agent is one click away.

Install the connector, paste the key, prompt Claude. Free for 7 days, no credit card.