MCP Server

نظرة عامة

يتيح BotBell MCP Server لمساعدي الذكاء الاصطناعي إرسال إشعارات فورية إلى iPhone وMac الخاص بك، وقراءة ردودك. بعد التهيئة، يمكن لذكائك الاصطناعي:

• إرسال إشعارات لك — نتائج المهام، التنبيهات، التذكيرات، الأسئلة
• قراءة ردودك — ترد في تطبيق BotBell، والذكاء الاصطناعي يقرأ ويتابع
• إدارة بوتاتك — عرض وإنشاء البوتات (وضع PAT فقط)

المتطلبات الأساسية

1. ثبّت تطبيق BotBell على iPhone أو Mac الخاص بك
2. أنشئ بوتًا واحصل على رمزك (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

التهيئة

أضف 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:

التنسيق: 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"
      }
    }
  }
}

عند تكوين رموز إضافية، تصبح معلمة alias متاحة في botbell_send و botbell_get_replies لتوجيه الرسائل عبر رمز محدد.

Cursor / Other MCP Clients

أضف إلى تهيئة MCP الخاصة بك:

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

الأدوات المتاحة

أدوات وضع PAT

عند استخدام PAT (بادئة pak_)، تتوفر جميع الأدوات الأربعة:

botbell_list_bots

عرض جميع بوتاتك. استخدمها للعثور على bot_id قبل الإرسال.

botbell_create_bot

إنشاء بوت جديد.

botbell_send

إرسال إشعار فوري عبر بوت محدد.

botbell_get_replies

التحقق من ردود المستخدم. تُستهلك الرسائل عند الجلب.

أدوات وضع Bot Token

عند استخدام Bot Token (بادئة bt_)، تتوفر أداتان: botbell_send وbotbell_get_replies.

لا حاجة لمعامل bot_id — الرمز مرتبط ببوت واحد.

الإجراءات التفاعلية

يمكن لوكلاء الذكاء الاصطناعي تضمين أزرار رد سريع مع الرسائل. يتيح هذا سير عمل بمشاركة بشرية حيث يختار المستخدم خيارًا أو يكتب ردًا مخصصًا — كل ذلك من إشعار فوري.

{
  "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. المستخدم يتلقى إشعارًا فوريًا مع الأزرار
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"