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 キーを発行 — 完了です。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).

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

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 — アダプターをインストール

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 キーを貼り付け (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.