MCP Server

Обзор

BotBell MCP Server позволяет ИИ-ассистентам отправлять push-уведомления на ваш iPhone и Mac, а также читать ваши ответы. После настройки ваш ИИ может:

• Отправлять вам уведомления — результаты задач, оповещения, напоминания, вопросы
• Читать ваши ответы — вы отвечаете в приложении BotBell, ИИ читает и продолжает
• Управлять вашими ботами — просматривать и создавать ботов (только в режиме PAT)

Предварительные требования

1. Установите приложение BotBell на iPhone или Mac
2. Создайте бота и получите токен (Bot Token или PAT)
3. Node.js 18+ установлен на вашем компьютере

Режимы аутентификации

MCP-сервер автоматически определяет тип токена по его префиксу:

Создание PAT (рекомендуется)

1. Откройте приложение BotBell → вкладка «Настройки»
2. Нажмите «API Keys» → нажмите кнопку «+»
3. Введите имя (например, «Claude Code»), выберите разрешения и нажмите «Создать»
4. Скопируйте токен, начинающийся с pak_ — он отображается только один раз

Установка

npm install -g @botbell/mcp-server

Настройка

Добавьте 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 Token через переменную BOTBELL_EXTRA_TOKENS:

Формат: 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_id перед отправкой.

botbell_create_bot

Создать нового бота.

botbell_send

Отправить push-уведомление через определённого бота.

botbell_get_replies

Проверить ответы пользователя. Сообщения удаляются после получения.

Инструменты режима Bot Token

При использовании Bot Token (префикс bt_) доступны 2 инструмента: botbell_send и botbell_get_replies.

Параметр bot_id не нужен — токен привязан к одному боту.

Интерактивные действия

ИИ-агенты могут добавлять кнопки быстрого ответа к сообщениям. Это позволяет реализовать рабочие процессы с участием человека, где пользователь выбирает вариант или вводит свой ответ — прямо из push-уведомления.

{
  "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. ИИ отправляет сообщение с кнопками действий через botbell_send
2. Пользователь получает push-уведомление с кнопками
3. Пользователь нажимает кнопку (или вводит свой ответ для типа "input")
4. ИИ читает ответ через botbell_get_replies, включая ключ действия

Примеры использования

Просто скажите вашему ИИ-ассистенту, что вам нужно, на естественном языке:

Отправить уведомление

"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"

Управление ботами (только PAT)

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