Telegram MCP サーバー
サーバーは、Telegram API と AI アシスタント間のブリッジであり、モデルコンテキストプロトコルに基づいています。
[!重要] このサーバーをご利用になる前に、 Telegram APIの利用規約を必ずお読みください。Telegram APIを不正に使用した場合、アカウントが停止される可能性があります。
目次
Related MCP server: Twitch MCP Server
MCPとは何ですか?
モデルコンテキストプロトコル（MCP）は、Claude DesktopやCursorなどのAIアプリが外部ツールやデータソースに接続できるようにするシステムです。これにより、AIアシスタントはユーザーの制御を維持しながら、ローカルサービスやAPIを明確かつ安全に操作できるようになります。
このサーバーは何をしますか?
機能
[x] 現在のアカウント情報を取得する（
tool: tg_me）[x] オプションの未読フィルター付きのダイアログを一覧表示する（
tool: tg_dialogs）[x] ダイアログを既読にする (
tool: tg_read)[x] 特定のダイアログからメッセージを取得する (
tool: tg_dialog)[x] 下書きメッセージを任意のダイアログに送信する (
tool: tg_send)
プロンプトの例
AI アシスタントで使用できるプロンプトの例を次に示します。
メッセージ管理
「Telegramに未読の重要なメッセージがないか確認してください」
「未読のTelegramメッセージをすべて要約する」
「未読メッセージを読んで分析し、必要に応じて返信の下書きを準備する」
「重要でない未読メッセージを確認し、簡単な概要を教えてください」
組織
「Telegramのダイアログを分析してフォルダ構造を提案してください」
「Telegramのチャットを重要度別に分類するのを手伝ってください」
「仕事関連の会話をすべて見つけて、整理する方法を提案します」
コミュニケーション
「[トピック]に関する最新情報については特定のチャットを監視する」
「[チャット]の最後のメッセージに対する丁寧な返信を作成してください」
「チャットに未回答の質問がないか確認してください」
インストール
自家製ビール
brew を使用して macOS/Linux にバイナリリリースをインストールできます。
NPX
npx を使用して最新バージョンを直接実行できます (macOS、Linux、Windows をサポート)。
NPX を使用する場合は、標準のコマンドと構成を次のように変更します。
認証コマンドは次のようになります。
Claude MCP サーバーの構成は次のようになります。
完全なセットアップ手順については、 「承認とクライアント構成」を参照してください。
リリースから
macOS
**注:**以下のコマンドは
/usr/local/binにインストールされます。他の場所にインストールする場合は、/usr/local/binPATH 内の任意のディレクトリに置き換えてください。
まず、アーキテクチャ用のアーカイブをダウンロードします。
次にバイナリをインストールします。
リナックス
**注:**以下のコマンドは
/usr/local/binにインストールされます。他の場所にインストールする場合は、/usr/local/binPATH 内の任意のディレクトリに置き換えてください。
まず、アーキテクチャ用のアーカイブをダウンロードします。
次にバイナリをインストールします。
ウィンドウズ
ウィンドウズ
ご使用のアーキテクチャの最新リリースをダウンロードしてください。
.zipファイルを解凍する抽出したディレクトリをPATHに追加するか、
telegram-mcp.exePATH内のディレクトリに移動します。
ソースから
要件：
Go 1.24以降
PATHのGOBIN
構成
承認
サーバーを使用する前に、Telegram API に接続する必要があります。
Telegram APIからAPI IDとハッシュを取得する
次のコマンドを実行します。
注: 2FA が有効になっている場合は、 --password <2fa_password> を追加してください。
**注:**既存のセッションを上書きする場合は、--new を追加してください。
telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>📩 Telegram から受け取ったコードを入力して API に接続します。
完了しました！このプロジェクトの開発をサポートするために、⭐️ を付けてください。
クライアント構成
Claude Desktop を Telegram MCP サーバーを認識するように構成する例。
Claude Desktop 構成ファイルを開きます。
MacOSでは、設定ファイルは
~/Library/Application Support/Claude/claude_desktop_config.jsonにあります。Windowsでは、構成ファイルは
%APPDATA%\Claude\claude_desktop_config.jsonにあります。
注: claude_desktop_config.json は Claude Desktop アプリの設定内にもあります。
サーバー構成を追加する
クロードデスクトップの場合:
{ "mcpServers": { "telegram": { "command": "telegram-mcp", "env": { "TG_APP_ID": "<your-app-id>", "TG_API_HASH": "<your-api-hash>", "PATH": "<path_to_telegram-mcp_binary_dir>", "HOME": "<path_to_your_home_directory" } } } }カーソルの場合:
{ "mcpServers": { "telegram-mcp": { "command": "telegram-mcp", "env": { "TG_APP_ID": "<your-app-id>", "TG_API_HASH": "<your-api-hash>" } } } }