Telegram MCPサーバーとは？AIエージェントにTelegram Bot APIのすべてを安全に提供する方法

AIエージェントにTelegramのラッパーが必要な理由

AIエージェントは実際のツールを操作するのがどんどん上手になっています。ダッシュボードを読み、何が重要かを判断し、次の一手を打てます。しかしTelegramの中で行動するには橋渡しが必要です。「AMAの告知をピン留めして質問用のトピックを作って」という一文を、正しいTelegram APIの呼び出しに変換する仕組みです。

その橋渡しこそが Telegram MCPサーバー です。

Model Context Protocol（MCP）は、Claude、ChatGPT、Cursor、CodexなどのAIクライアントがツールを見つけて呼び出せるようにするオープン標準です。Telegram MCPサーバーはTelegramの操作をツールとして公開し、モデルが従える明確な説明と入力スキーマを提供します。

Metricgramは、すでにあなたのグループを管理しているボットを使って、このサーバーをホストするようになりました。

「Telegram Bot APIをラップする」とは実際に何をすることか

机上では、エージェント向けにBot APIをラップするのは簡単に思えます。実際には次のような作業が必要です。

• ボットをホストし、トークンを秘密に保ち、稼働させ続ける。
• Webhookまたはポーリングで更新を受け取る。
• エージェントに使わせたいエンドポイントごとにツール定義を書く。
• 触れてはいけないチャットにエージェントが投稿しないよう制御する。
• レート制限、移行されたスーパーグループ、Telegramのエラーメッセージに対応する。
• 不安定な通信1回で同じメッセージが二重投稿されないよう、リトライを安全にする。
• 後で説明が必要になったときのために、エージェントの操作を記録する。

多くのチームは「メッセージ送信」で止まってしまいます。それ以外は膨大な裏方作業になるからです。その結果、話すことはできてもコミュニティを本当に管理できないエージェントが生まれます。

Metricgram Telegram MCPサーバーの仕組み

Metricgramはすでに管理者ボット（または独自のカスタムボット）としてあなたのTelegramグループにいます。MCPサーバーは、ホスト型エンドポイントを通じてAIクライアントがそのボットを使えるようにするだけです。

1. グループをMetricgramに接続 し、ボットに管理者権限を与えます。
2. 管理画面でAPIキーを作成 し、スコープを選びます。
3. エンドポイントをAIクライアントに追加 します。これだけです。サーバー、Webhook、トークンを管理する必要はありません。

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktopのユーザーは mcp-remote で同じエンドポイントに接続できます。各クライアント用の正確なスニペットは、管理画面のMCPページにあります。

70以上のBot APIメソッドと2つの呼び出し方

サーバーはTelegram Bot APIを2つのレイヤーで提供します。

日常業務向けの型付きツール

よく使う操作には、わかりやすいパラメーターを備えた専用ツールがあり、モデルが正しく使いやすくなっています。

• send_telegram_message：トピック、返信、URLボタンに対応
• send_telegram_media：写真、動画、GIF、ドキュメント、音声、ステッカー
• send_telegram_poll：投票とクイズ
• edit_telegram_message、delete_telegram_messages、react_to_telegram_message
• pin_telegram_message と forward_telegram_message
• manage_forum_topic：トピックの作成、名前変更、クローズ、再開、削除
• get_telegram_chat と get_telegram_chat_member：リアルタイムのチャットデータ
• handle_telegram_join_request、create_telegram_invite_link、update_telegram_chat_settings

完全なBot APIゲートウェイ

それ以外の操作はすべて telegram_bot_api を通じて行います。エージェントは公式のBot APIメソッド名とパラメーターを渡します。たとえば setChatPermissions、banChatSenderChat、editMessageMedia、hideGeneralForumTopic、revokeChatInviteLink などです。補助ツールの telegram_api_methods は現在のキーで使えるメソッドをすべて一覧表示するので、エージェントは何が使えるかを常に把握できます。

セキュリティ：エージェントがchat_idを選ばない理由

最も重要な設計上の判断は、エージェントに何が できない かです。

• チャットは固定されています。 エージェントが渡すのはMetricgramの group_id です。サーバーはあなたが所有するグループからTelegramの chat_id を導き出し、それ以外のチャットは拒否します。
• 転送と引用はチェックされます。 メッセージの転送、コピー、引用は自分のグループからしか行えません。
• ボット全体に関わる操作は除外されています。 Webhook、決済、ボットのプロフィール変更、グループからの退出は公開されていません。
• ボタンは安全です。 インラインボタンはURLを開いたりテキストをコピーしたりできますが、ボットへのコールバックは発生させられません。
• スコープは信頼度に対応します。 telegram:read、telegram:write、telegram:moderate、telegram:admin はそれぞれ独立しており、権限の異なる複数のキーを使い分けられます。
• リトライは冪等です。 書き込み系ツールは idempotency_key に対応しており、リトライされた呼び出しは二度実行されず最初の結果を返します。
• すべての呼び出しが記録されます。 使われたツールとBot APIメソッドも残ります。

エージェントは公式のBot APIを通じてボットとして動作し、あなたの個人のTelegramアカウントとして動くことはありません。

素のボットにはないコンテキスト

単純なBot APIラッパーは操作はできても、あまり多くを見ることができません。Metricgram MCPサーバーはコミュニティのインテリジェンスも提供します。

• 分析の概要とアクティビティの時系列
• アクティブメンバー、メンバー履歴、取得済みメッセージ
• ゲーミフィケーションのランキングと報酬
• グループで起きたことのAI要約
• Stripeサブスクライバーの健全性と解約リスクのある更新

つまりエージェントは「今月参加しなくなったのは誰？」に答え、その人たちに心のこもったメッセージを送るところまで、1つの会話で完結できます。

ワークフローの例

毎週の告知。「Crypto Talkに毎週のAMA告知を投稿して、全員に通知せずにピン留めし、AMA質問用のトピックを作り、金曜日に期限切れになる招待リンクを作成して。」

モデレーションの一斉チェック。「直近200件のメッセージからスパムリンクを探して削除し、送信者を24時間制限して。」

コミュニティレポート。「今週と先週のアクティビティを比較して、最もアクティブなメンバー5人を挙げ、Generalトピックに短いお礼のメッセージを投稿して。」

参加リクエストの仕分け。「アクティブなサブスクライバーからの保留中の参加リクエストを承認し、残りは拒否して。」

こんな方におすすめ

• コミュニティオーナー：日常の管理業務を任せられるアシスタントがほしい方。
• 代理店：多数のクライアントグループを管理し、すべてを1つのエージェントで扱いたい方。
• サポート・カスタマーサクセスチーム：Telegramで顧客コミュニティを運営している方。
• 開発者：ボットのインフラを運用せずに、エージェントの技術スタックにTelegramを組み込みたい方。

はじめ方

MCPサーバーはEliteプランに含まれています。14日間の無料トライアルではEliteレベルのアクセスが使えるので、支払い前にエージェントを接続できます。

詳しくは Telegram MCPサーバーのページ と MCP機能の概要 をご覧ください。準備ができたら管理画面で最初のキーを作成しましょう。