Blujay

Blujay MCP サーバー

Claude、Cursor、VS Code、その他の AI アシスタントから Blujay アカウントを利用できます。会話を読んだり、返信が必要な相手を確認したり、Blujay の電話番号から iMessage、RCS、SMS を送信したりできます。

すべてのテキストは実際に送信されます。 Blujay にテストモードはありません。多くのアシスタントは、ツールを自動承認するように設定していない限り、送信のたびに確認を求めます。まずは --allow-send-to を自分の電話番号だけに制限して試してください（安全性を参照）。

できること

• 「今日、まだ返信していない相手は誰ですか？」
• 「Ava との会話を要約して、返信の下書きを作成してください。」
• 「+1 555 555 0123 に、10 分遅れます、とテキストを送ってください。」
• 「デスクトップにある beach.jpg の写真を Ava に送ってください。」
• 「ダウンロードフォルダーにあるリース契約書の PDF を Sam に送ってください。」
• 「Ava に風船の絵文字を添えて誕生日おめでとうと送ってください。」
• 「Sam に送った最後のメッセージは配信されましたか？」
• 「Ava 向けに Website demo texts ワークフローを開始してください。」
• 「この番号は iMessage に対応していますか？」
• 「新着メッセージ用の webhook を https://example.com/blujay に設定してください。」
• 「webhook の署名を検証する方法を教えてください。」

セットアップ

Node.js 20 以降と、Blujay の API タブで取得できる Blujay API キーが必要です。

ボタンを押すと、プレースホルダーキーを使ってサーバーが追加されます。blu_your_api_key をご自身のキーに置き換えてください。

Claude Desktop

Settings → Developer → Edit Config を開き、次を追加します。

{
  "mcpServers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "blu_your_api_key" }
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add blujay --env BLUJAY_API_KEY=blu_your_api_key -- npx -y blujay-mcp

Cursor

Cursor Settings → Tools & MCP → New MCP Server で、mcp.json に次を追加します。

{
  "mcpServers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "blu_your_api_key" }
    }
  }
}

VS Code

プロジェクトの .vscode/mcp.json に次を追加します。

{
  "servers": {
    "blujay": {
      "command": "npx",
      "args": ["-y", "blujay-mcp"],
      "env": { "BLUJAY_API_KEY": "${input:blujay-api-key}" }
    }
  },
  "inputs": [
    { "id": "blujay-api-key", "type": "promptString", "description": "Blujay API key", "password": true }
  ]
}

その他の MCP クライアント

BLUJAY_API_KEY を設定した状態で npx -y blujay-mcp を実行します。stdio 経由で MCP 通信を行います。

安全性

• アシスタントは送信前に確認を求めます。 すべてのツールには読み取りまたは操作のラベルが付いているため、クライアントは読み取りを承認し、相手に何かが届く前に確認を求めることができます。
• --allow-send-to +15555550123 を指定すると、送信と変更の対象を指定した番号に制限できます。まずはご自身の番号で試してください。
• --read-only を指定すると、送信、変更、削除を行うすべてのツールが除外されます。
• ファイルはフルパスでのみ指定できます： 写真、動画、ドキュメント、連絡先カード、音声ファイルは最大 100 MiB までで、内容を確認します。

これらのチェックで防げないことなどの詳細は、SECURITY.md をご覧ください。

ツール

ツール	機能	相手に届く
get_account	ワークスペースと電話番号、およびそれぞれでできることを確認します
list_conversations	最近の会話を一覧表示します。相手または電話番号で絞り込むこともできます
get_conversation	電話番号、メールアドレス、またはチャット ID で会話を検索し、トランスクリプトとして取得します
find_unanswered	相手からの返信を待たれている会話を検索します
get_message	メッセージの配信状況と失敗した理由を確認します
check_imessage	電話番号が iMessage を利用しているかを確認します
find_contacts	名前、電話番号、メールアドレスで連絡先を検索するか、保存済み（または未保存）の連絡先を一覧表示します
list_workflows	連絡先に対して開始できるワークフローを一覧表示します（有効、公開済み、手動で開始されたもの。タグをトリガーとするワークフローは save_contact で開始します）
list_webhooks	Webhook のサブスクリプションと最近の配信試行を一覧表示します
search_docs	docs.blujay.io を検索します
send_message	相手またはグループにテキストメッセージを送信するか、会話に返信します。コンピューター上の写真、動画、書類、連絡先カード、音声ファイル（ボイスメモとして送信）、リンク先の写真、動画、連絡先カード、または後続メッセージに風船やスラムなどの iMessage エフェクトを添付できます	はい
react_to_message	タップバックまたは絵文字リアクションを追加または削除します	はい
edit_message	送信済みの iMessage を編集します	はい
unsend_message	iMessage の送信を取り消します	はい
mark_conversation_read	会話を既読にします	はい（開封確認）
set_typing	入力中の吹き出しを表示または非表示にします	はい
update_group	iMessage グループの名前を変更するか、相手を追加または削除します	はい
save_contact	連絡先を作成または更新し、タグを付けます	可能：タグによって、相手にテキストメッセージを送るワークフローを開始できます
enroll_in_workflow	連絡先に対して手動ワークフローを開始します。再試行しても安全で、同じリクエストで二重登録されることはありません	はい：ワークフローから相手にテキストメッセージが送信されます
opt_out_contact	連絡先へのすべてのテキストメッセージ送信を停止します（--allow-send-to を指定するとオフになります）
create_webhook	Webhook サブスクリプションを作成します（--allow-send-to を指定するとオフになります）
invoke_api	任意の Blujay エンドポイントを呼び出します（--enable-invoke-api を指定した場合のみ）	場合によります

プロンプト

MCP クライアントでは、次のアクションをすぐに実行できます。

• 返信が必要なのは誰ですか？ あなたからの返信を待っている会話を検索し、それぞれの返信案を作成します。送信はしません。
• ある相手との会話を要約します。
• 自分の電話にテストメッセージを送信し、届いたことを確認します。

オプション

オプション	効果
--read-only	読み取り専用のツールのみを有効にします
--allow-send-to <numbers>	カンマ区切りで指定した電話番号にのみ連絡します
--enable-invoke-api	任意のエンドポイントを呼び出すための invoke_api を追加します。--read-only または --allow-send-to を指定した場合は GET のみです
--help、--version

トラブルシューティング

• 「set BLUJAY_API_KEY」：MCP クライアントの設定の env ブロックにキーを追加し、クライアントを再起動してください。
• 401、API_KEY_REVOKED、または API_KEY_EXPIRED：[email protected] にメールで新しいキーを依頼し、BLUJAY_API_KEY を更新してください。
• ツールが表示されない：ターミナルで npx -y blujay-mcp --version が動作することを確認し、MCP クライアントを再起動してください。

詳細

• Blujay API ドキュメント
• 独自のコードで使えるライブラリ：npm の blujay と PyPI の blujay
• 質問やバグの報告：[email protected] またはイシューを作成してください。セキュリティに関する問題：SECURITY.md

ライセンス

MIT