TalkToPlanB

TalkToPlanB MCP サーバー

AI アシスタント（Claude Desktop および任意の Model Context Protocol クライアント）が TalkToPlanB を利用できるようにします。チャットルームの一覧表示、メッセージの閲覧、メッセージの送信ができます。

TalkToPlanB の開発者向け REST API をラップし、stdio 経由で MCP と通信します。

ツール

ツール	説明
whoami	現在の API キーのアカウント情報（ユーザー ID、ユーザー名、スコープ）。
list_rooms	グループチャットとダイレクトメッセージを一覧表示します（ルーム ID を返します）。
read_messages	ルーム内の最近のメッセージを読み取ります（roomId、任意の limit）。
send_message	roomId または toPhone を指定してメッセージを送信します（text も指定）。

1. API キーを取得する

1. 開発者ポータルを開きます：https://talktoplanb.duckdns.org/portal
2. 登録またはログインし、キーを作成して、messages:read と messages:send のスコープを付与します。
3. キーをコピーします（ttpb_xxxxxxxx... のような形式です）。

2. Claude Desktop で使用する

Claude Desktop の設定ファイルに以下を追加します （Windows の場合は %APPDATA%\Claude\claude_desktop_config.json、 macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "talktoplanb": {
      "command": "npx",
      "args": ["-y", "talktoplanb-mcp"],
      "env": {
        "TALKTOPLANB_API_KEY": "ttpb_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動して、「TalkToPlanB のルームを一覧表示して」または 「+60123456789 に TalkToPlanB メッセージで hello と送信して」と試してください。

環境変数

変数	必須	デフォルト
TALKTOPLANB_API_KEY	✅	—
TALKTOPLANB_BASE_URL	❌	https://talktoplanb.duckdns.org

3. ローカル開発

cd mcp-server
npm install
npm run build      # compiles src → dist
TALKTOPLANB_API_KEY=ttpb_... npm start

4. npm に公開する（誰でも npx talktoplanb-mcp を使えるようにする）

cd mcp-server
npm login
npm publish --access public

公開後、MCP レジストリ（mcp.so、Glama、Smithery）に登録できます — ../marketing/listing-checklist.md を参照してください。

メモ

• Node.js 18 以降が必要です（組み込みの fetch を使用します）。
• stdout は MCP プロトコルを運び、すべてのログは stderr に出力されます。
• サーバーが実行できるのは、API キーに許可された操作（スコープ）のみです。