MCP Server

概要

BotBell MCP Server を使えば、AI アシスタントが iPhone や Mac にプッシュ通知を送信し、あなたの返信を読み取ることができます。設定すると、AI は以下のことが可能になります：

• 通知を送信 — タスク結果、アラート、リマインダー、質問
• 返信を読み取る — BotBell アプリで返信すると、AI がそれを読んで処理を続行
• Bot を管理 — Bot の一覧表示と作成（PAT モードのみ）

前提条件

1. iPhone または Mac に BotBell アプリをインストール
2. Bot を作成してトークンを取得（Bot Token または PAT）
3. Node.js 18+ がマシンにインストール済みであること

認証モード

MCP Server はプレフィックスからトークンの種類を自動検出します：

PAT の作成（推奨）

1. BotBell アプリを開く → 設定タブ
2. 「API Keys」をタップ → 右上の「+」ボタンをタップ
3. 名前を入力（例：「Claude Code」）、権限を選択して「作成」をタップ
4. pak_ で始まるトークンをコピー — 一度しか表示されません

インストール

npm install -g @botbell/mcp-server

設定

AI ツールの設定に BotBell MCP Server を追加してください：

Claude Desktop

設定ファイルを編集：

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "pak_your_pat_here"
      }
    }
  }
}

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "bt_your_token_here"
      }
    }
  }
}

Claude Code (CLI)

以下のコマンドを実行してサーバーを追加：

claude mcp add botbell -e BOTBELL_TOKEN=pak_your_pat_here -- botbell-mcp

claude mcp add botbell -e BOTBELL_TOKEN=bt_your_token_here -- botbell-mcp

追加トークン（上級）

複数アカウントの Bot に通知を送る場合、BOTBELL_EXTRA_TOKENS 環境変数で追加の Bot Token を設定できます：

形式：alias1:bt_token1,alias2:bt_token2

{
  "mcpServers": {
    "botbell": {
      "command": "botbell-mcp",
      "env": {
        "BOTBELL_TOKEN": "pak_your_pat_here",
        "BOTBELL_EXTRA_TOKENS": "team-ops:bt_abc123,home:bt_xyz789"
      }
    }
  }
}

追加トークン設定後、botbell_send と botbell_get_replies に alias パラメータが追加され、特定のトークンでメッセージを送信できます。

Cursor / その他の MCP クライアント

MCP 設定に追加：

{
  "botbell": {
    "command": "botbell-mcp",
    "env": {
      "BOTBELL_TOKEN": "pak_your_pat_here"
    }
  }
}

利用可能なツール

PAT モードのツール

PAT（pak_ プレフィックス）を使用すると、4 つのツールがすべて利用可能です：

botbell_list_bots

すべての Bot を一覧表示します。送信前に bot_id を確認するために使用します。

botbell_create_bot

新しい Bot を作成します。

botbell_send

特定の Bot からプッシュ通知を送信します。

botbell_get_replies

ユーザーの返信を確認します。取得したメッセージは消費されます。

Bot Token モードのツール

Bot Token（bt_ プレフィックス）を使用すると、botbell_send と botbell_get_replies の 2 つのツールが利用可能です。

bot_id パラメータは不要です — トークンが単一の Bot に紐づいています。

インタラクティブ Actions

AI エージェントはメッセージにクイック返信ボタンを含めることができます。これにより、ユーザーが選択肢を選んだりカスタム返信を入力したりする human-in-the-loop ワークフローが実現します — すべてプッシュ通知から直接操作可能です。

{
  "bot_id": "bot_abc123",
  "message": "3 files will be deleted. Proceed?",
  "title": "Confirmation Required",
  "actions": [
    {"key": "confirm", "label": "Yes, delete"},
    {"key": "cancel", "label": "Cancel"},
    {"key": "custom", "label": "Other...", "type": "input", "placeholder": "e.g. delete only the first two"}
  ]
}

インタラクションの流れ：

1. AI が botbell_send でアクションボタン付きのメッセージを送信
2. ユーザーがボタン付きのプッシュ通知を受信
3. ユーザーがボタンをタップ（または "input" タイプの場合はカスタム返信を入力）
4. AI が botbell_get_replies で返信を読み取り（アクションキーを含む）

使用例

AI アシスタントに自然言語で伝えるだけです：

通知を送信

"Send a notification to my phone saying the build succeeded"

アクションボタンで質問

"Ask me whether to deploy v2.3.0 to production, with approve/reject buttons and an option to type a custom response"

返信を確認

"Check if I have any replies in BotBell"

Bot を管理（PAT のみ）

"List my bots" / "Create a new bot called Deploy Alerts"