自分の LINE を、手元の MCP から読む

最短ルート#

1. 1

   手順1 常時オンの機械で6サービスを立ち上げる#

   手元の Mac では OrbStack で、サーバーでは Docker で Compose の6サービスを動かし、管理画面から LINE と WhatsApp にログインします。セルフホスト

2. 2

   手順2 手元の MCP をつなぐ#

   手元の機械で stdio MCP をビルドし、AI クライアントに read の設定を書きます。MCP

3. 3

   手順3 1部屋を読む#

   line_list_rooms で得た room_id を line_get_recent_messages に渡し、エラーなしで返れば完了です。

構成#

HacoL は、Matrix を LINE と WhatsApp との接続に使い、context-app を AI から読むための仕組みに使います。

• Compose の6サービス（postgres、synapse、line-bridge、whatsapp-bridge、context-app、caddy）で動かします。7つ目のサービスは追加しません。
• caddy はリバースプロキシです。外からの HTTP と HTTPS を受け、context-app と synapse に振り分けます。
• context-app は Node.js 22 と TypeScript で書かれた1つのプロセスです（Fastify、pg、Zod）。取り込み、検索、送信を別サービスに分けていません。
• AI クライアントは、REST API を呼ぶローカル stdio MCP を使います。標準の構成では Remote MCP を公開しません。

つなげる AI のアプリ#

• Claude Desktopstdio
• Claude Codestdio
• ChatGPT デスクトップアプリ対応を確認中です
• Gemini CLI対応を確認中です

ChatGPT デスクトップアプリと Gemini CLI は、公式の文書では stdio の MCP に対応しています。HacoL との組み合わせは、まだ確かめていません。Web 版の ChatGPT と Gemini アプリは、手元の stdio MCP にはつなげないため、このサイトの手順の対象外です。各社の名称は、各社の商標です。

HacoL がすること、しないこと#

固定している原則#

READ_SCOPE=all_bridged_line_rooms
SEND_SCOPE=explicit_allowlist
DEFAULT_SEND=deny
AI_NEVER_RECEIVES_MATRIX_OWNER_TOKEN=true

• 送信は既定で拒否

  新しい部屋は allow_send=false で登録します。AI は、管理画面で許可した部屋にだけ、停止スイッチがオフのときに限り送信できます。

• 停止スイッチ

  管理画面の「バックアップと更新」で「送信を止める」を押すと、すべての送信が SEND_DISABLED（423）で止まります。.env の初期値は SEND_ENABLED=false です。

• AI に渡さない秘密

  Matrix の owner トークンは context-app だけが使います。AI に渡るのは read か agent の API キーだけです。

• MCP から変えられないもの

  許可リスト、停止スイッチ、トークンの取得は MCP のツールにありません。管理画面で人が操作します。

提供の形#

• セルフホスト版

  いま提供している形です。手元の Mac の OrbStack か、自分のサーバーの Docker で動かし、データはその機械に残ります。LINE と自分以外の、第三者のサーバーに認証を置きません。PC 版の LINE は要りません。

• クラウド版（準備中）

  クラウド版を準備中です。公開の条件は Threat model に書いています。

非公式のブリッジについて#

ページ一覧#

• セルフホストCompose の6サービスを、手元の機械か VPS で動かす手順です。
• MCPMCP サーバーのビルドと設定、read と agent のプロファイル、ツール一覧、送信の許可の仕組みです。
• Threat modelデータと鍵の置き場所、信頼の境界、許可リストと停止スイッチ、非公式のブリッジの限界です。
• FAQ開発者からよく出る質問と回答です。