Blooio

Blooio MCP サーバー

Model Context Protocol サーバーで、Blooio v4 API に対応しています。Claude、ChatGPT、Cursor、およびその他の MCP クライアントから、iMessage、SMS、RCS、WhatsApp のメッセージを送受信できます。また、チャネル、番号、連絡先、チャット、グループ、通話、10DLC 登録、サポートチケット、Webhook、イベントフィードを管理できます。

これは薄いラッパーです。各ツールは、接続したユーザーの認証情報を使って Blooio API を 1 回呼び出します。

接続

このサーバーの URL を MCP クライアントに追加してください。

https://mcp.blooio.com/v4

クライアントがブラウザーウィンドウを開くので、Blooio にサインインし、接続する組織を選択して、権限を承認します。アクセストークンは自動的に更新されます。アクセス権は、Blooio dashboard の組織のインストール済みアプリからいつでも取り消せます。

クライアントが OAuth に対応していない場合は、代わりに Blooio API キーを渡してください。

Authorization: Bearer bl_live_...

ツール

公開済みの OpenAPI 仕様から生成されるため、v4 API の各操作に対してツールが 1 つずつ用意されており、ツールセットは常にドキュメントと一致します。ツールの引数は、操作の以下の項目で構成されます。

• snake_case 形式のパスパラメーター（/chats/{chatId} の場合は chat_id を指定します）
• クエリパラメーター
• リクエストボディのフィールド（トップレベルにフラット化）
• Idempotency-Key ヘッダーを受け付ける操作の idempotencyKey

ファイルをアップロードする操作（set_group_icon、set_chat_background、upload_contact_card_avatar）では、公開 URL を指定します。サーバーがファイルをダウンロードし、Blooio にアップロードします。

呼び出しに失敗すると、API のエラーがツールの結果として返されるため、モデルはその内容を読み取って呼び出しを修正できます。

リソース（blooio://account/info、blooio://channels、blooio://webhooks）と、いくつかのスタータープロンプト（send_quick_message、check_delivery、send_with_attachment、verify_contact、setup_webhook、start_group_chat）も利用できます。

サインインの仕組み

このサーバーは MCP クライアント向けの OAuth 2.1 認可サーバーです。動的クライアント登録、PKCE（S256）を使った認可コード、リフレッシュトークンに対応しています。実際のログイン処理は Blooio の OAuth に委任します。

1. MCP クライアントが /oauth/register に登録し、/oauth/authorize を開きます。
2. 確認ページにクライアント名とリダイレクト先が表示され、その後、Blooio MCP アプリとして Blooio の同意画面に移動します。
3. Blooio が /oauth/callback にリダイレクトします。ユーザーの複数の組織にアプリがインストールされている場合、サーバーはこの接続で使用する組織を尋ねます。
4. クライアントは、組織情報でラップされた Blooio のトークン（bmcp_<organization_id>.<token>）を受け取るため、すべてのツール呼び出しは選択した組織に固定されます。サーバーは長期間有効なトークンを保存せず、更新リクエストを Blooio に転送します。

検出用ドキュメントは /.well-known/oauth-authorization-server と /.well-known/oauth-protected-resource で提供されます。有効な認証情報なしで呼び出すと、後者を示す WWW-Authenticate ヘッダーとともに 401 が返されます。

エンドポイント

エンドポイント	用途
POST /v4	MCP JSON-RPC（Streamable HTTP、JSON レスポンス）
GET /v4/manifest	ツール、リソース、プロンプトを JSON 形式で取得
POST /v4/call	JSON-RPC のフレーミングを使わないツール呼び出し 1 件：{ "tool": "...", "arguments": {...} }
ALL /v4/<path>	https://api.blooio.com/v4/<path> へのパススルー
/oauth/*、/.well-known/*	OAuth と検出

開発

Node 22 以降が必要です。

npm install
npm test            # unit tests
npm start           # wrangler dev on http://localhost:8787

ローカルでサインインを実行するには、ダッシュボード（Developers → Apps）で Blooio アプリを作成し、リダイレクト URI に http://localhost:8787/oauth/callback を設定します。クライアント ID を wrangler.toml の BLOOIO_OAUTH_CLIENT_ID に、シークレットを .dev.vars に設定してください。

BLOOIO_OAUTH_CLIENT_SECRET=blosec_...

次に、MCP Inspector で http://localhost:8787/v4 を指定してください。

ツールの更新

src/operations.json は OpenAPI 仕様からコンパイルされます。再生成するには、次のコマンドを実行してください。

npm run sync-spec -- https://docs.blooio.com/openapi.v4.json

ライセンス

Apache 2.0