Telegram MCP by usefulapi

usefulapi の Telegram MCP

Claude、Cursor、または任意の MCP クライアントから、Telegram アカウントを利用できます。チャット、ボットのメンバーや管理者を読み取り、ボットでメッセージを送信、編集、削除できます。ホスト型のため、ローカルへのインストールは不要です。独自の認証情報で接続できます。

ライブエンドポイント： https://telegram.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://telegram.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http telegram https://telegram.usefulapi.io/mcp を実行し、続けて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： リモート MCP サーバーとして URL を追加します。

{
  "mcpServers": {
    "telegram": {
      "url": "https://telegram.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Telegram の認証情報を求めます。

手順に沿ったセットアップ、認証情報の確認方法、FAQ：https://usefulapi.io/telegram/

初回接続時に、Telegram ボットトークンを入力します（Telegram で @BotFather を開き、/newbot または /mybots を送信してから、API Token を取得します）。サーバーはトークンを検証し、ユーザーごとに保存します。設定ファイルにキーを保存する必要はありません。

ツール

ツール	種類	説明
telegram_get_me	読み取り	ボットを取得
telegram_get_chat	読み取り	チャットを取得
telegram_get_chat_member_count	読み取り	チャットのメンバー数を取得
telegram_get_chat_member	読み取り	チャットメンバーを取得
telegram_get_chat_administrators	読み取り	チャット管理者の一覧を取得
telegram_get_updates	書き込み	保留中の更新を取得
telegram_send_message	書き込み	メッセージを送信
telegram_edit_message_text	書き込み	メッセージを編集
telegram_delete_message	書き込み	メッセージを削除
telegram_usage_status	メタ	使用状況（無料プランの利用状況）
telegram_request_feature	メタ	不足している機能をリクエスト
telegram_upgrade	メタ	Pro にアップグレード（無制限*）
telegram_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	制限
Free	$0	月 50 回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2 か月分無料）	無制限*

*Pro には、このサーバーで月 10,000 回のツール呼び出しという公正利用制限があります。それ以上必要な場合は、[email protected] までご連絡ください。

Pro が適用されるのはこのサーバーのみです。telegram_upgrade を使って登録してください（Stripe Checkout のリンクが返されます）。telegram_cancel_subscription を使えばいつでもキャンセルできます。Pro は有料期間の終了まで継続され、現在の期間分の返金はありません。それより前に telegram_upgrade を実行すると、キャンセルは取り消されます。または [email protected] までご連絡ください。

ライセンス

MIT — LICENSE を参照してください。ドキュメントのみです。サーバーはホストされています。