言語: 日本語English

telegram プラグイン

カテゴリ
生産性
トピック
プロジェクト管理・チーム連携 · Claude Code 拡張・ワークフロー
初回確認
2026-07-09
最終確認
2026-07-13
解説の最終更新
2026-07-12

以下の解説は生成 AI によるものです。出典と照らし合わせてご確認ください。

telegram プラグインは、MCP サーバーを介して Telegram の bot と Claude Code を接続し、bot 宛のメッセージを Claude Code のセッションへ転送します。README によると、セットアップには Bun が必要で、BotFather での bot 作成、プラグインのインストール、/telegram:configure でのトークン設定、--channels plugin:telegram フラグ付きでの Claude Code 再起動、送られてくるコードによるペアリングという手順を踏みます。アクセス制御は /telegram:access コマンドで行い、pairing や allowlist などのポリシーは ACCESS.md に記載されています。アシスタントは reply・react(Telegram 固定の絵文字リストのみ)・edit_message(bot 自身が送ったメッセージの編集)の各ツールを使えますが、Telegram の Bot API はメッセージ履歴や検索機能を提供していないため、bot は到着したメッセージのみを認識します。

概要

これは単体の SaaS ではなく、Claude Code のプラグインです。Bun 上で動作するローカルの MCP サーバーが Telegram に bot としてログインし、ユーザーのメッセージを Claude Code のセッションへ転送します。あわせて reply・react・edit_message のツールをアシスタントに提供し、access.json に保存されたペアリングコードや allowlist でアクセスを管理する仕組みです。

telegram でできること

  • BotFather で Telegram bot を作成し、/telegram:configure と claude --channels plugin:telegram@claude-plugins-official 起動フラグで Claude Code に接続する
  • /telegram:access pair で Telegram アカウントをペアリングし、DM をアシスタントに届ける
  • ペアリング後は /telegram:access policy allowlist でアクセスを制限し、未承認の相手にペアリングコードの返信をしないようにする
  • アシスタントに chat への reply、Telegram 固定の絵文字による react、bot 自身が送ったメッセージの edit_message(進捗更新など)を行わせる
  • 最大50MBまでの画像・文書を送受信し、受信した画像は ~/.claude/channels/telegram/inbox/ に保存されアシスタントが読み取れる
  • TELEGRAM_STATE_DIR をインスタンスごとに分けることで、1台のマシン上で複数の bot をそれぞれ別のトークンと allowlist で動かす

出典

原文の説明(英語)

Telegram messaging bridge with built-in access control. Manage pairing, allowlists, and policy via /telegram:access.

telegram の変更履歴

一覧に戻る