MCP Server

Descripción general

BotBell MCP Server permite que los asistentes de IA envíen notificaciones push a tu iPhone y Mac, y lean tus respuestas. Una vez configurado, tu IA puede:

• Enviarte notificaciones — resultados de tareas, alertas, recordatorios, preguntas
• Leer tus respuestas — respondes en la app BotBell, la IA lo lee y continúa
• Gestionar tus bots — listar y crear bots (solo en modo PAT)

Requisitos previos

1. Instalar la app BotBell en tu iPhone o Mac
2. Crear un bot y obtener tu token (Bot Token o PAT)
3. Node.js 18+ instalado en tu máquina

Modos de autenticación

El servidor MCP detecta automáticamente el tipo de token por su prefijo:

Crear un PAT (recomendado)

1. Abrir la app BotBell → pestaña Ajustes
2. Tocar "API Keys" → tocar el botón "+"
3. Introducir un nombre (ej. "Claude Code"), seleccionar permisos y tocar "Crear"
4. Copiar el token que empieza con pak_ — solo se muestra una vez

Instalación

npm install -g @botbell/mcp-server

Configuración

Añade el servidor MCP de BotBell a la configuración de tu herramienta de IA:

Claude Desktop

Edita el archivo de configuración:

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

Ejecuta un solo comando para añadir el servidor:

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

Tokens adicionales (Avanzado)

Para enviar notificaciones a Bots de múltiples cuentas, configura Bot Tokens adicionales mediante la variable BOTBELL_EXTRA_TOKENS:

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

Con tokens adicionales configurados, un parámetro alias estará disponible en botbell_send y botbell_get_replies para enviar mensajes por un token específico.

Cursor / Other MCP Clients

Añade a tu configuración MCP:

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

Herramientas disponibles

Herramientas en modo PAT

Al usar un PAT (prefijo pak_), las 4 herramientas están disponibles:

botbell_list_bots

Listar todos tus bots. Úsalo para encontrar el bot_id antes de enviar.

botbell_create_bot

Crear un nuevo bot.

botbell_send

Enviar una notificación push a través de un bot específico.

botbell_get_replies

Consultar respuestas del usuario. Los mensajes se consumen al obtenerlos.

Herramientas en modo Bot Token

Al usar un Bot Token (prefijo bt_), hay 2 herramientas disponibles: botbell_send y botbell_get_replies.

No se necesita el parámetro bot_id — el token está vinculado a un solo bot.

Acciones interactivas

Los agentes de IA pueden incluir botones de respuesta rápida con los mensajes. Esto permite flujos de trabajo con humano en el bucle donde el usuario elige una opción o escribe una respuesta personalizada — todo desde una notificación 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"}
  ]
}

El flujo de interacción:

1. La IA envía un mensaje con botones de acción a través de botbell_send
2. El usuario recibe una notificación push con los botones
3. El usuario toca un botón (o escribe una respuesta personalizada para el tipo "input")
4. La IA lee la respuesta a través de botbell_get_replies, incluyendo la clave de acción

Ejemplos de uso

Simplemente dile a tu asistente de IA lo que necesitas en lenguaje natural:

Enviar una notificación

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

Preguntar con botones de acción

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

Consultar respuestas

"Check if I have any replies in BotBell"

Gestionar bots (solo PAT)

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