Claude
اسأل Claude عن كنيستك بلغة بسيطة، وسيجيبك من بيانات B1 الخاصة بك، بما في ذلك دروس FreePlay وفصولها. أسئلة مثل "كم عدد الزوار لأول مرة الذين حضروا يوم الأحد؟" أو "من انضم إلى مجموعة صغيرة هذا الشهر؟" — أو اطلب منه تنفيذ مهام، مثل "أضف صفحة جديدة إلى موقعنا باسم Events." يستغرق الإعداد أقل من 3 دقائق، ولا تحتاج إلى أي مهارات تقنية أو برامج للتثبيت.
ما تحتاج إليه
- حساب Claude. الخطة المجانية تعمل — وهي طريقة جيدة لتجربته. ومع ذلك، فإن الحسابات المجانية لها حد يومي للرسائل، والبحث عن معلومات في B1 يستهلك الرسائل بسرعة، لذلك إذا كنت ستستخدمه بانتظام، نوصي بخطة Claude Pro (حوالي 20 دولارًا شهريًا).
- تسجيل الدخول إلى B1 — هو نفسه الذي تستخدمه في B1 Admin.
Claude هو أسهل طريقة لربط B1 بالذكاء الاصطناعي، ويعمل مع الخطة المجانية من Claude — وهي طريقة مثالية لكنيستك لتجربته قبل دفع أي مبلغ.
هناك طريقتان للربط. الخيار 1 هو الأسهل — لا يتطلب مفتاحًا ولا تثبيت أي شيء.
الخيار 1 — تسجيل الدخول باستخدام B1 (الأسهل)
يعمل على موقع Claude، وتطبيق Claude للحاسوب، وتطبيق Claude للهاتف — قم بالإعداد مرة واحدة، وسيعمل على جميعها.
الخطوة 1 — افتح إعدادات الموصلات في Claude
- اذهب إلى claude.ai وسجّل الدخول (أو أنشئ حسابًا مجانيًا).
- انقر على اسمك في الزاوية السفلية اليسرى، ثم Customize ← Connectors.
الخطوة 2 — أضف B1
- انقر على Add، ثم Add custom connector.
- Name: اكتب
B1. - URL: الصق
https://api.churchapps.org/mcp - اترك الخيارات الأخرى كما هي وانقر على Add.
الخطوة 3 — سجّل الدخول إلى B1
- انقر على Connect. ستفتح صفحة تسجيل دخول B1.
- سجّل الدخول بحساب B1 الخاص بك. إذا كنت تنتمي إلى أكثر من كنيسة، تأكد من ظهور الكنيسة الصحيحة في أعلى الصفحة.
- يعرض B1 ما يطلب Claude القيام به، ويؤكد أنك ستُعاد إلى claude.ai. انقر على Allow.
ستعود إلى Claude، وسيظهر B1 على أنه متصل.
الخطوة 4 — اسأله شيئًا
ابدأ محادثة جديدة وجرّب:
- "كم عدد الأشخاص في كنيستنا؟"
- "اعرض قائمة بالمجموعات النشطة لدينا."
- "لخّص تبرعات هذا الشهر حسب الصندوق."
- "من انضم إلى الكنيسة خلال الـ 30 يومًا الماضية؟"
في المرة الأولى، سيطلب Claude إذنك لاستخدام B1 — انقر على Allow.
الخيار 2 — إضافة سطح مكتب باستخدام مفتاح B1
استخدم هذا الخيار إذا كنت تفضّل منح Claude مفتاحًا بصلاحيات محدودة (مثلاً، للقراءة فقط). يعمل في تطبيق Claude للحاسوب على Mac أو Windows، وتحتاج إلى صلاحية إدارة إعدادات الكنيسة في B1 لإنشاء المفتاح.
الخطوة 1 — احصل على تطبيق Claude
نزّل تطبيق Claude من claude.com/download، وثبّته، وافتحه، وسجّل الدخول.
الخطوة 2 — أنشئ مفتاح B1 الخاص بك
المفتاح هو ما يتيح لـ Claude الوصول إلى B1 الخاص بكنيستك — فكّر فيه كأنه كلمة مرور خاصة بـ Claude فقط.
- سجّل الدخول إلى B1 Admin واذهب إلى Settings ← Developer.
- في تبويب API Keys، انقر على New API Key.
- Name: اكتب
Claude. - Scopes: حدّد ما يحق لـ Claude فعله. لكل مجال مربع read (للاطلاع فقط) ومربع write (لإجراء التغييرات). لست متأكدًا؟ حدّد مربعات read فقط للبداية — يمكنك إنشاء مفتاح جديد بصلاحيات أوسع لاحقًا.
- انقر على Save، ثم على Copy لنسخ المفتاح. يُعرض مرة واحدة فقط، لذا انتقل مباشرة إلى الخطوة 3.
الخطوة 3 — أضف B1 إلى Claude
- نزّل إضافة B1.
- انقر نقرًا مزدوجًا على الملف الذي نزّلته (
b1-churchapps.mcpb). سيفتح Claude ويعرض B1 (ChurchApps). - انقر على Install.
- عندما يطلب منك مفتاح B1 API، الصق المفتاح من الخطوة 2 واحفظه.
- أغلق Claude بالكامل (على Mac: Cmd+Q · على Windows: انقر بزر الماوس الأيمن على أيقونة Claude في شريط المهام ← Quit) ثم أعد فتحه.
إذا لم يفتح Claude عند النقر المزدوج، فانتقل إلى Settings ← Extensions ← Advanced settings ← Install Extension… داخل Claude، واختر الملف الذي نزّلته. ثم ابدأ محادثة جديدة واسأله أي شيء.
لا حاجة لأي إجراء — FreePlay يعمل من خلال الاتصال نفسه. الاستثناء الوحيد هو الإصدار 1.1.0، الذي طلب بريدًا إلكترونيًا وكلمة مرور لـ B1: نزّل الإضافة وثبّتها مرة أخرى للتحديث. مفتاحك سيبقى كما هو.
هل هو آمن؟
- يمكن لـ Claude أن يرى بيانات كنيستك فقط.
- عند تسجيل الدخول (الخيار 1): لا يمكن لـ Claude أن يفعل أكثر مما يستطيعه تسجيل دخولك الخاص إلى B1. تعرض صفحة تسجيل الدخول في B1 كل ما يحق لـ Claude فعله قبل أن تنقر على Allow.
- باستخدام مفتاح (الخيار 2): لا يمكن لـ Claude إلا فعل ما يسمح به المفتاح في B1 — المفتاح الذي تُحدَّد فيه مربعات read فقط يمكنه الاطلاع فقط ولا يمكنه إجراء أي تغييرات أبدًا. يعمل FreePlay بالطريقة نفسها، وبالمفتاح نفسه.
- لإيقافه: في B1 Admin اذهب إلى Settings ← Developer وألغِ التطبيق من Connected Apps (الخيار 1) أو احذف المفتاح من API Keys (الخيار 2). يتوقف الوصول فورًا. يمكنك أيضًا النقر على Disconnect في موصل B1 داخل Claude.
ما التكلفة؟
اتصال B1 مجاني — فهو جزء من ChurchApps. Claude نفسه لديه خطة مجانية؛ وتمنحك خطة Claude Pro (حوالي 20 دولارًا شهريًا) استخدامًا أكبر بكثير. اطلع على claude.com/pricing.
التفاصيل التقنية
هذه الصفحة المتبقية موجهة للمستخدمين التقنيين والمساعدات الذكية: النطاقات، وطرق الربط الأخرى، وكيفية عمل الاتصال.
النطاقات (Scopes)
يتواصل Claude مع B1 عبر خادم Model Context Protocol (MCP) المدمج في واجهة B1 البرمجية (https://api.churchapps.org/mcp). تمر كل استدعاء عبر قواعد المصادقة والصلاحيات وحصر الكنيسة نفسها التي تُطبَّق على الطلبات من B1 Admin. يقتصر Claude على الصلاحيات والنطاقات الخاصة بمفتاح API، ولا يمكنه الوصول إلى Webhooks أو نقاط نهاية OAuth الإدارية أو غيرها من المسارات المخصصة للمشغّل.
مجموعات النطاقات الأولية الشائعة:
- مساعد للقراءة فقط:
people:read،groups:read،attendance:read،donations:read،content:read - قراءة + إضافة ملاحظات / مهام: أضف
people:write - مساعد تشغيلي كامل: أضف نطاقات
:writeالمطابقة التي تريدها
يتيح مفتاح donations:read لـ Claude تلخيص التبرعات، لكنه لا يستطيع تسجيل هدية. ويمكن لمفتاح people:write إضافة شخص، لكنه لا يستطيع رؤية التبرعات. اطلع على API Keys لمعرفة ما يسمح به كل نطاق.
طرق أخرى للربط
Claude Code (CLI)
في الطرفية:
claude mcp add --scope user --transport http b1 https://api.churchapps.org/mcp \
--header "Authorization: Bearer cak_<prefix>.<secret>"
هذا كل شيء. داخل أي جلسة Claude Code، اكتب /mcp للتأكد من اتصال الخادم b1، ثم اسأل Claude أي سؤال عن كنيستك.
Claude Desktop — إعداد يدوي (متقدم)
إذا كنت تفضّل عدم استخدام الإضافة، فعدّل ملف إعدادات Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
أضف إدخال خادم b1 يربط بـ B1 عبر mcp-remote (يتطلب Node.js):
{
"mcpServers": {
"b1": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://api.churchapps.org/mcp",
"--header", "Authorization:Bearer cak_<prefix>.<secret>"
]
}
}
}
أعد تشغيل Claude Desktop. ستعرض قائمة الموصلات في مربع كتابة المحادثة الخادم b1 مع أدواته.
Claude.ai (الويب) — موصل مخصص
راجع الخيار 1 أعلاه. يستخدم الموصل OAuth 2.1: يكتشف Claude خادم التفويض الخاص بـ B1 من https://api.churchapps.org/.well-known/oauth-protected-resource، ويسجّل نفسه عبر Dynamic Client Registration، ويسجّل الدخول باستخدام PKCE. في خطط Team وEnterprise قد يحتاج المالك إلى إضافة الموصل للمؤسسة أولاً. لا يطلب Claude نطاقات محددة، لذا تعرض صفحة الموافقة كل ما يمكن لحساب B1 المسجَّل الوصول إليه. ألغِ الربط من Settings ← Developer ← Connected Apps في B1 Admin.
كيف يعمل
تعرض واجهة B1 البرمجية نقطة نهاية MCP واحدة عند /mcp. يتصل Claude بها، ويصادق باستخدام مفتاح cak_… الخاص بك، ويحصل على الوصول إلى أربع أدوات:
| الأداة | ما تفعله |
|---|---|
list_endpoints | تعرض نقاط نهاية REST التي يمكن لـ Claude استدعاؤها، مع إمكانية التصفية حسب المسار. تُستخدم للاكتشاف. |
describe_endpoint | تعرض ملخصًا قصيرًا ومثال طلب/استجابة لنقطة نهاية محددة. |
api_call | تستدعي نقطة نهاية REST فعليًا بصفتك المستخدم المصادَق عليه. |
describe_page_builder | دليل لإنشاء صفحات موقع كنيستك وتحريرها، ويقرأه Claude قبل العمل على محتوى الموقع. |
هذه هي نفس واجهة /membership/people و/giving/donations و/attendance/visits وغيرها التي يستخدمها B1Admin — وتنطبق كل قواعد التفويض نفسها. تُدرج نقاط نهاية FreePlay (lessons.church) تحت /lessons/*؛ وتُحوَّل استدعاءات Claude لها إلى FreePlay بصفتك المستخدم نفسه، وبالصلاحيات نفسها.
الأمان والحدود
- عزل كل كنيسة على حدة. يرتبط مفتاح API بكنيسة واحدة. لا يستطيع Claude رؤية بيانات الكنائس الأخرى.
- محكوم بالصلاحيات. إذا أزلت صلاحية من الشخص الذي أنشأ المفتاح في B1Admin، يفقدها Claude عند الاستدعاء التالي — فورًا.
- قابل للإلغاء. احذف المفتاح من Settings ← Developer ← API Keys، فينتهي وصول Claude فورًا.
- قائمة الحظر. لا يمكن استدعاء Webhooks الخاصة بالمزودين، ونقاط نهاية إدارة عملاء OAuth، ومسار
apiEmailsالمخصص للمشغّل عبر MCP. - حد حجم الاستجابة. تُحدّ الاستجابة الواحدة للأداة بـ 64 كيلوبايت حتى لا تُثقل سياق Claude بالقوائم الطويلة — وسيقلّص Claude الاستعلام باستخدام الفلاتر عند حدوث ذلك.
- سجل التدقيق. تمر التعديلات عبر سجل التدقيق نفسه لإجراءات B1Admin؛ يمكنك مراجعتها من Settings ← Audit Log.
استكشاف الأخطاء وإصلاحها
يطلب Claude بريدًا إلكترونيًا وكلمة مرور لـ B1 لاستخدام FreePlay: لديك الإصدار 1.1.0 من إضافة سطح المكتب. نزّل الإضافة وثبّتها مرة أخرى للتحديث — الإصدارات الأحدث تستخدم المفتاح فقط.
يبلغ Claude عن "Unauthorized" أو خطأ 401: رمز الحامل (bearer token) مفقود أو غير صالح، أو تم إلغاء المفتاح. إذا استخدمت الإضافة، فافتح Settings ← Extensions ← B1 (ChurchApps) داخل Claude، والصق المفتاح مرة أخرى. وإلا فتحقق من ترويسة Authorization: Bearer cak_… مرة أخرى (لاحظ المسافة وكلمة Bearer كما هي).
تُرجع استدعاء أداة الخطأ 403: مفتاح API لا يملك النطاق المطلوب لنقطة النهاية. أضف النطاق من Settings ← Developer ← API Keys (ستحتاج إلى إنشاء مفتاح جديد — لا يمكن تغيير النطاقات في مكانها)، والصق المفتاح الجديد في إعدادات الإضافة أو إعدادات Claude.
لا يستطيع Claude العثور على نقطة نهاية: اطلب منه استدعاء list_endpoints مع فلتر، مثلاً "استخدم list_endpoints مع الفلتر 'donations' للعثور على المسار الصحيح". يُولَّد جرد المسارات من واجهة API المباشرة، لذا كل ما يمكنك الوصول إليه باستخدام curl موجود فيه.
التطوير المحلي: استبدل https://api.churchapps.org/mcp بـ http://localhost:8084/mcp — المصادقة نفسها والأدوات نفسها.
ذات صلة
- API Keys — المرجع الكامل للنطاقات
- MCP Server (developer reference) — تفاصيل البروتوكول ومخططات الأدوات
- ChatGPT — الفكرة نفسها، لنماذج OpenAI