AIエージェント向けTelegram MCPサーバー

MetricgramはTelegram Bot APIをホスト型MCPサーバーとして提供します。権限を絞ったキーを使い、AIエージェントがTelegramグループの閲覧、投稿、モデレーション、管理を行えます。ボットのコードを保守する必要はありません。

  • 70以上のTelegram Bot APIメソッドをMCPツールとして提供
  • Claude、ChatGPT、Cursor、Codexに対応
  • すべての呼び出しは自分のグループに限定
  • 分析、メンバー、サブスクライバー情報も同じサーバーで
無料トライアルを始める
クレジットカード不要 2分でセットアップ完了

使い方

1

ボットを追加してグループを接続

Metricgramボット（または独自のカスタムボット）を管理者としてTelegramグループに追加します。サーバー、Webhook、ポーリングの運用は不要です。

2

権限を絞ったAPIキーを作成

Elite APIキーを発行し、エージェントに許可する操作を細かく選びます。Telegramの読み取り専用アクセスから、投稿、モデレーション、チャット設定まで指定できます。

3

AIクライアントに接続

Claude、Cursor、Codexなど任意のMCPクライアントに設定ブロックを1つ貼り付けるだけ。許可したTelegramの操作がすべてツールとしてエージェントに表示されます。

1つの指示で、実際のTelegram操作を

エージェントが適切なBot API呼び出しを選び、Metricgramが正しいグループで実行して構造化された結果を返します。

metricgram · mcp

あなたの指示

Crypto Talkに今週のAMA告知を投稿して、通知なしでピン留めし、「AMAの質問」トピックを作成して、金曜日に期限切れになる招待リンクを発行して。

エージェントの呼び出し

  • send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
  • pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
  • manage_forum_topic(group_id: 42, action: "create", name: "…")
  • create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")

あらゆるMCPクライアントを接続

ホスト型エンドポイントとAPIキーを使うだけ。Claude Desktopのユーザーはmcp-remoteで接続できます。

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

エージェントが使えるツール

メッセージとメディア

send_telegram_message send_telegram_media send_telegram_poll edit_telegram_message delete_telegram_messages forward_telegram_message react_to_telegram_message

ピン留めとフォーラムトピック

pin_telegram_message manage_forum_topic createForumTopic closeGeneralForumTopic unpinAllForumTopicMessages

モデレーションと参加リクエスト

ban_member restrict_member promote_member handle_telegram_join_request banChatSenderChat setChatAdministratorCustomTitle

チャット設定と招待リンク

update_telegram_chat_settings create_telegram_invite_link revokeChatInviteLink setChatPermissions setChatStickerSet

分析とコミュニティデータ

analytics_overview active_users list_members list_messages gamification_rankings get_subscriber_health

対応するすべてのBot APIメソッド

telegram_api_methods telegram_bot_api get_telegram_chat get_telegram_chat_member

AIエージェントのためにラップされたTelegram Bot API

エージェント向けにTelegram連携を作るには、通常ボットのホスティング、Webhookの処理、トークンの保管、エンドポイントごとのツール作成が必要です。Metricgramのボットはすでにあなたのグループで動いているため、エージェントは1つのホスト型エンドポイントから、すぐに使えるMCPツールとしてBot APIを利用できます。
01

型付きツールと完全なBot APIゲートウェイ

メッセージ、メディア、投票、ピン留め、トピック、招待リンクといったよく使う操作には、説明の充実した専用ツールがあります。それ以外はtelegram_bot_apiで実行でき、公式のBot APIメソッド名とパラメーターをそのまま受け付けるため、対応カタログ内の操作はすべて利用できます。
02

自分のグループだけに限定

エージェントがchat_idを選ぶことはありません。Metricgramはあなたが所有するグループからchat_idを導き出し、転送や引用のメッセージがあなたの他のグループのものかを確認し、他のチャットに届く可能性のある操作はすべて拒否します。
03

信頼度に応じたスコープ

リサーチ用エージェントにはtelegram:read、投稿やトピックにはtelegram:write、BANや参加リクエストにはtelegram:moderate、肩書き、権限、招待リンクにはtelegram:adminを付与します。キーはいつでも取り消せます。
04

安全なリトライと明確なエラー

書き込み系ツールは冪等キーに対応しているため、リトライしても二重投稿になりません。Telegramのエラーやレート制限はretry_afterを含む構造化された結果として返るので、エージェントが自分で対処できます。
05

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

同じサーバーでMetricgramの分析、メンバー履歴、取得済みメッセージ、ゲーミフィケーション、AI要約、Stripeサブスクライバーの健全性も公開しているため、エージェントは行動する前に何をすべきか判断できます。

Metricgramと手動管理の比較

Metricgram 手動管理
ホスト型MCPエンドポイント、ボットサーバー不要
70以上のTelegram Bot APIメソッドをツール化
chat_idを自分のグループに固定
スコープ別に取り消せるAPIキー
書き込み系ツールの冪等なリトライ
判断材料になる分析とメンバー履歴
リアルタイムのチャットデータ、管理者、権限
独自のカスタムボットでも利用可能

よくある質問

Telegram MCPサーバーとは何ですか？
Telegramの操作を、AIエージェントが呼び出せるツールとして公開するModel Context Protocolサーバーです。Metricgramが、すでにあなたのグループを管理しているボットを使ってホストします。
どのAIクライアントで使えますか？
HTTP経由でMCPに対応したクライアントならどれでも使えます。Claude Code、Claude Desktop（mcp-remote経由）、Cursor、Codex、OpenAIやAnthropicのSDKで構築したカスタムエージェントなどです。
Telegram Bot APIのすべてをカバーしていますか？
メッセージ、メディア、投票、編集、リアクション、ピン留め、フォーラムトピック、モデレーション、参加リクエスト、チャット設定、招待リンクなど、グループ関連の70以上のメソッドをカバーしています。Webhook、決済、グループからの退出など、他のチャットやボット自体に影響するメソッドは意図的に除外しています。
自分が所有していないグループにエージェントが投稿できますか？
できません。すべての呼び出しは接続済みのあなたのグループのいずれかに紐づきます。chat_idはMetricgramが設定し、転送や返信で参照できるのも自分のグループだけです。
これはTelegramのユーザーAPI（MTProto）ですか？
いいえ。グループのボットを通じて公式のBot APIを使うため、エージェントはボットとして動作し、あなたの個人のTelegramアカウントとして動くことはありません。
MCPサーバーはどのプランに含まれますか？
MCPとAPIへのアクセスはEliteプランに含まれます。14日間の無料トライアルではEliteレベルのアクセスが使えるので、支払い前にエージェントを接続できます。
エージェントにできることを制限できますか？
はい。APIキーごとにスコープを設定でき、読み取り専用のリサーチ、投稿、モデレーション、管理用にそれぞれ別のキーを作成できます。

探索を続ける

実践ガイドを探したり、活発なコミュニティを見たり、Metricgramの活用法をさらに見つけたりできます。

ガイド

ブログ

成長、収益化、モデレーション、Telegramコミュニティ運営に関する実践的なプレイブックをお読みください。

探索する

コミュニティディレクトリ

Telegramコミュニティディレクトリ

カテゴリー、言語、ポジショニング別にアクティブなTelegramコミュニティを閲覧しましょう。

探索する

セクションハブ

ソリューション

このセクションのページをまとめて確認できます。

探索する

ソリューション のその他

Telegramグループ管理ツール Telegramグループの分析と指標 グループ管理用Telegramボット Telegramグループを自動化しましょう 有料コミュニティ向けTelegramメンバーシップボット グループおよびチャンネル向けTelegram決済ボット

さらに詳しく

Telegramグループ管理ツール Telegramグループの分析と指標 グループ管理用Telegramボット Telegramグループを自動化しましょう 有料コミュニティ向けTelegramメンバーシップボット グループおよびチャンネル向けTelegram決済ボット 定期収益のためのTelegramサブスクリプションボット Telegramチャンネルの収益化を簡単に Telegram VIPグループの作成と管理 Telegram サポートをアカウントインテリジェンスへ MCP API AIチャットボット アシスタント
14日間の無料トライアルを開始

数分で始められます

数分でTelegramグループを接続し、すべての機能を14日間無料でお試しいただけます。

料金を見る