dialogbrain

Claude Code 向け DialogBrain

WhatsApp、Telegram、メール、ウェブサイトのチャットを1つの受信トレイに接続し、そこで顧客に応答するAIエージェントを構築できます。すべてClaude Codeから操作できます。

DialogBrainは顧客向けメッセージングプラットフォームです。すべてのチャネルが、連絡先、通話、タスクボード、AIエージェントを備えた共通の受信トレイに集約されます。このプラグインを使うと、ツールに加えて、各セットアップ作業の手順を把握した6つのスキルもClaude Code内で利用できます。

インストール

claude plugin marketplace add saloprj/dialogbrain-claude-plugin
claude plugin install dialogbrain@dialogbrain

次に、Claude Code内で/mcpを実行し、ブラウザーでDialogBrainにサインインしてください。コピーするAPIキーは不要です。このプラグインは、サインイン中のワークスペースでご自身のアカウントから実行できる操作だけを実行できます。

依頼できること

WhatsAppと仕事用メールを接続してください。

example.comにチャットウィジェットを設置してください。自分のドメインのみを許可し、
承認するまで返信は下書きのままにしてください。

WhatsAppとウェブサイトのチャットで顧客に応答するエージェントを作成してください。
価格を約束することは絶対にしないでください。誰にも応答する前にテストしてください。

今週、どこでリードを失いましたか？

スキルの内容

普段どおりの言葉で依頼すると、該当するスキルが自動で読み込まれます。その場合に限って読み込まれます。

• connect-channel — 「WhatsApp／メール／Telegramボットを接続して」： サインインが不要なもの（IMAPメールボックスやボットトークンなど）はチャットから直接接続し、それ以外は該当画面を直接開くリンクを送ります。
• setup-livechat-widget — 「サイトにチャットウィジェットを設置して」：ウィジェットを作成し、利用できるドメインを制限して、2つのスクリプトタグを提供し、エージェントが応答することを確認します。
• create-agent — 「顧客に応答するエージェントを作成して」：説明に基づいてエージェントを作成し、トリガーを設定して、テストメッセージを送信し、トレースを読み取ります。
• voice-agent — 「電話対応エージェントを作成して」：エージェントを作成し、音声を設定して、テスト用の電話をかけます。
• tasks-board — ワークスペースのタスクボードです。人やエージェントに作業を割り当て、期限超過のタスクを追跡し、スクリーンショット付きでコメントできます。
• lead-report — 「今週、どこでリードを失いましたか」：分析データを照会し、スレッドを読み、要約を1つ作成します。
• react-to-events — 「この人からメッセージが来たら教えて」「このグループを監視して」「新しいリードごとに通知して」：対象のメッセージに合わせてトリガーを絞り込み、その後、返信、自分へのメモ、人による対応への切り替え、ボード上のタスクなど、実行する内容を選びます。

DialogBrain からあなたに連絡できるようにする（まだ誰でも利用できるわけではありません）

このプラグインにはチャネルサーバーも含まれているため、DialogBrain エージェントは自分で回答する代わりに、このセッションに作業を渡せます。たとえば、判断が必要な新しい見込み客や、スマートフォンから割り当てられたタスクです。

試す前にお読みください。 Claude Code セッションへの受信プッシュは Claude Code の実験的な機能であり、こちらでは有効にできない条件が2つあります。

• アカウントで Channels 機能が有効になっていること。
• チャネルが承認されていること。承認は、Claude Code 自体が保持する許可リスト、または組織の管理設定によって行われます。どちらにも含まれていないプラグインは、ローカル開発用の --dangerously-load-development-channels を指定してセッションを起動しない限り拒否されます。

つまり、プラグインをインストールしても、この機能が使えるようにはなりません。フラグなしで使えるツール、スキル、エージェントが利用できるようになります。以下の手順の最後に Claude Code がチャネルは「承認済みチャネルの許可リストに含まれていない」と表示した場合、これはこの条件に該当しているのであり、操作ミスではありません。また、プラグイン側でこの制限を解除することはできません。

セットアップするまでは何も起こりません。API キーが設定されていなければチャネルはオフのままで、セッションには影響せず、プラグインのツールはこれまでどおり動作します。

PATH に Node.js 20 以降が必要です。スタンドアロンバイナリとしてインストールした Claude Code には、Node.js は含まれていません。Node.js がないとチャネルは起動せず、セッション独自の MCP ログに起動エラーが記録されるだけです。まず node --version を確認してください。

1. プラグインに API キー（cabinet → Settings → Developer）と、このマシンの名前を設定します。プラグインのインストール時に Claude が両方を尋ねます。キーはクライアントがシークレットを保存する方法で保存されるため、このリポジトリやシェルのプロファイルには書き込まれません。

   チェックアウトからインストールする場合は、同じ2つの値を ~/.claude/channels/dialogbrain/.env に設定することもできます。プラグインから値が指定されていない場合、チャネルはここから読み込みます。

   DIALOGBRAIN_TOKEN=<your key>
   DIALOGBRAIN_CHANNEL_NAME=<a name you will recognise>
   

2. プッシュを有効にして Claude Code を起動します。受信プッシュはデフォルトでオフになっており、起動済みのセッションで有効にすることはできません。自分のコンピューターでチャネルが Claude Code の承認済みリストに含まれていない場合は、開発用フラグを指定します（プラグインのエントリを指定します）。

   claude --dangerously-load-development-channels plugin:dialogbrain@dialogbrain
   # the same session again, keeping its id:
   claude --resume <session id> --dangerously-load-development-channels plugin:dialogbrain@dialogbrain
   

   管理設定で管理者がプラグインを承認している場合は、短い形式で十分です：claude --channels plugin:dialogbrain@dialogbrain。承認されていない場合、短い形式は拒否されます（「承認済みチャネルの許可リストに含まれていない」）。承認は /etc/claude-code/managed-settings.json に一度だけ設定します。

   { "channelsEnabled": true,
     "allowedChannelPlugins": [{ "plugin": "dialogbrain", "marketplace": "dialogbrain" }] }
   

3. 「新しい見込み客が届いたら、ここで知らせて」と自然な言葉で依頼します。残りの設定は react-to-events スキルが行います。

チャネル名を指定するフラグは1つだけにしてください。--channels と --dangerously-load-development-channels の両方に指定すると、チャネルが二重に登録されます。一方は開発用の印が付かないため、その印のない方がチェックに引っかかり、すべて拒否されます。

1つのセッションで使う DialogBrain チャネルは1つにしてください。プロジェクトの .mcp.json に手動設定した dialogbrain-channel もある場合は、削除してください。2つのチャネルは別々に登録され、異なるキーが割り当てられる可能性もあります。その場合、Claude Code がリッスンしていない方に作業が送られることがあります。

会話の相手側から届いたメッセージだけがプッシュを発生させます。接続中のアカウントが自分自身に送るメッセージは送信扱いとなり、通知は発生しません。

何も届かない場合は、DialogBrain に認識できるセッションを尋ねてください。リストに表示されていても、チャネルサーバーがサーバーに接続できたことしか証明されません。Claude Code が通知を配信するかどうかにかかわらず、チャネルサーバーはソケットを開きます。正確な状況はセッション独自の MCP ログで確認できます。そこには「チャネル通知を登録しました」と表示されるか、通知の登録がスキップされた理由が記録されます。

チャンネルから届く情報とそのタイミング

チャンネルサーバーは、このプラグインの中で自ら外部と通信する唯一の部分です。API キーを設定するまで何もせず、キーがなければ1行を出力して、どこにも接続しません。

キーを設定すると、そのキーに紐づく DialogBrain サーバー（接続先を変更しない限り https://api.dialogbrain.com）への WebSocket 接続を開き、セッションを登録します。これにより、相手はマシン名を指定してこのマシンに作業を依頼できます。この登録は再接続のたびに行われ、次の情報を送信します。

• このマシンに付けた名前。名前を付けていない場合は hostname:project-folder
• Claude Code のセッション ID、プロジェクトディレクトリ、作業ディレクトリ、ホスト名、プロセス ID
• 起動元の Claude Code エントリーポイントと、使用するサブエージェントモデル
• プロジェクトディレクトリの現在の git ブランチ
• セッションを表す1行のタイトル。セッションの概要、または最初に入力した内容を120文字に切り詰めたもの

最後の1行が、複数のデスクトップを並べたときに見分けるための情報です。また、マシンの外に送信されるセッション内容はこれだけです。それ以外は何も読み取らず、送信もしません。ファイルも会話も出力も対象外です。登録後に流れるのはすべて逆方向で、顧客から届いたメッセージがセッションにプッシュされます。

キーは、ディレクトリからインストールした場合は Claude Code に保存され、チェックアウトからインストールした場合は ~/.claude/channels/dialogbrain/.env に保存されます。キーは、それが紐づくサーバーへのヘッダーとしてのみ送信されます。

接続できるチャンネル

WhatsApp、Telegram、Telegram ボット、Instagram、Facebook Messenger、IMAP または Google 経由のメール、ウェブサイトに設置するチャットウィジェット、音声通話用の電話番号に対応しています。

実行しないこと

WhatsApp を接続するには、番号を所有するスマートフォンで QR コードをスキャンする必要があります。WhatsApp Web と同じ仕組みです。アシスタントが代わりにスキャンするべきではないため、このプラグインはスキャンを試みません。代わりに、該当手順の DialogBrain を開くリンクを送信します。メールボックスの接続では、メインのパスワードではなくアプリパスワードを求めます。アプリパスワードはいつでも取り消せます。エージェントの返信は、エージェントだけで返信してよいと決めるまで下書きとして保留されます。

サーバーのみ、スキルなし

claude mcp add --transport http dialogbrain https://api.dialogbrain.com/mcp/

同じアドレスは、OAuth サインインを使って ChatGPT、Claude、Cursor、Codex、Gemini CLI、その他の MCP クライアントでも利用できます。 https://dialogbrain.com/help/set-up-from-ai-assistant

必要条件

DialogBrain アカウント（dialogbrain.com）と Claude Code が必要です。新しいワークスペースには無料トライアルが付いているため、支払いの前にチャンネルを接続してエージェントをテストできます。

MIT ライセンスです。このリポジトリは、リリースごとに DialogBrain のモノレポから公開されています。変更はこのリポジトリではなく、モノレポで行います。