MCP Server

Übersicht

Der BotBell MCP Server ermöglicht KI-Assistenten, Push-Benachrichtigungen an dein iPhone und deinen Mac zu senden und deine Antworten zu lesen. Nach der Konfiguration kann deine KI:

• Dir Benachrichtigungen senden — Aufgabenergebnisse, Alarme, Erinnerungen, Fragen
• Deine Antworten lesen — du antwortest in der BotBell-App, die KI liest sie und fährt fort
• Deine Bots verwalten — Bots auflisten und erstellen (nur PAT-Modus)

Voraussetzungen

1. Installiere die BotBell-App auf deinem iPhone oder Mac
2. Erstelle einen Bot und hole dir deinen Token (Bot Token oder PAT)
3. Node.js 18+ auf deinem Rechner installiert

Authentifizierungsmodi

Der MCP Server erkennt den Token-Typ automatisch anhand seines Präfixes:

PAT erstellen (empfohlen)

1. BotBell App öffnen → Einstellungen-Tab
2. "API Keys" antippen → "+"-Button oben rechts antippen
3. Namen eingeben (z.B. "Claude Code"), Berechtigungen auswählen und "Erstellen" antippen
4. Token mit pak_ kopieren — wird nur einmal angezeigt

Installation

npm install -g @botbell/mcp-server

Konfiguration

Füge den BotBell MCP Server zur Konfiguration deines KI-Tools hinzu:

Claude Desktop

Bearbeite die Konfigurationsdatei:

~/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)

Führe einen einzelnen Befehl aus, um den Server hinzuzufügen:

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

Zusätzliche Tokens (Erweitert)

Um Benachrichtigungen an Bots von mehreren Konten zu senden, konfigurieren Sie zusätzliche Bot Tokens über die Umgebungsvariable BOTBELL_EXTRA_TOKENS:

Format: 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"
      }
    }
  }
}

Mit konfigurierten Extra-Tokens wird ein alias-Parameter für botbell_send und botbell_get_replies verfügbar.

Cursor / Andere MCP-Clients

Füge es zu deiner MCP-Konfiguration hinzu:

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

Verfügbare Tools

PAT-Modus-Tools

Bei Verwendung eines PAT (pak_-Präfix) sind alle 4 Tools verfügbar:

botbell_list_bots

Alle deine Bots auflisten. Verwende dies, um die bot_id vor dem Senden zu finden.

botbell_create_bot

Einen neuen Bot erstellen.

botbell_send

Eine Push-Benachrichtigung über einen bestimmten Bot senden.

botbell_get_replies

Benutzerantworten abrufen. Nachrichten werden beim Abrufen verbraucht.

Bot Token-Modus-Tools

Bei Verwendung eines Bot Token (bt_-Präfix) sind 2 Tools verfügbar: botbell_send und botbell_get_replies.

Kein bot_id-Parameter nötig — der Token ist an einen einzelnen Bot gebunden.

Interaktive Actions

KI-Agenten können Schnellantwort-Buttons in Nachrichten einfügen. Dies ermöglicht Human-in-the-Loop-Workflows, bei denen der Benutzer eine Option wählt oder eine benutzerdefinierte Antwort eingibt — alles direkt aus einer Push-Benachrichtigung.

{
  "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"}
  ]
}

Der Interaktionsablauf:

1. KI sendet eine Nachricht mit Action-Buttons über botbell_send
2. Benutzer erhält eine Push-Benachrichtigung mit den Buttons
3. Benutzer tippt auf einen Button (oder gibt eine benutzerdefinierte Antwort für Typ "input" ein)
4. KI liest die Antwort über botbell_get_replies, einschließlich des Action-Keys

Anwendungsbeispiele

Sag deinem KI-Assistenten einfach in natürlicher Sprache, was du brauchst:

Benachrichtigung senden

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

Mit Action-Buttons fragen

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

Antworten abrufen

"Check if I have any replies in BotBell"

Bots verwalten (nur PAT)

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