تخطَّ إلى المحتوى
بيان فلوبيان فلو
ابدأ الآن

التوثيق · موصّل MCP

اربط تطبيقات الذكاء الاصطناعي بمعرفة بيان فلو

ابحث في معرفة شركتك، واكتب الوثائق وحدّثها، وراجع مساحة العمل من Claude أو ChatGPT أو أي تطبيق يدعم MCP. تسجّل الدخول بحساب بيان فلو، وتحدد ما يُسمح للتطبيق بفعله، وتبقى أنت المتحكم.

  • OAuth 2.0 مع PKCE
  • MCP عن بُعد · Streamable HTTP
  • موافقة المالك على التغييرات الحساسة

عنوان الخادم

https://bayanflow.tech/api/v1/mcp

الصق هذا العنوان في تطبيق الذكاء الاصطناعي كموصّل MCP مخصص. لا شيء آخر تنسخه.

ما الذي تستطيع تطبيقات الذكاء الاصطناعي فعله مع بيان فلو

يحوّل بيان فلو وثائق الشركة نفسها إلى إجابات دقيقة لفريق الدعم. يتيح موصّل MCP هذا لتطبيقات الذكاء الاصطناعي مثل Claude وChatGPT العمل مع قواعد المعرفة ومساحة العمل التي تختارها، بصلاحياتك أنت ولا شيء أكثر.

  • إجابات من وثائقك أنت

    يبحث التطبيق في قواعد المعرفة المسموح بها ويقرأ المقاطع، فتأتي إجاباته من سياساتك ومعلومات منتجك بدل التخمين.

  • معرفة محدّثة دائمًا

    أنشئ قواعد معرفة ووثائق، واحفظ التعديلات كإصدارات جديدة. لا يُحذف شيء بهذه الطريقة أبدًا.

  • فهم مساحة العمل

    اطّلع على الأعضاء (مع إخفاء جزئي للبريد) والفرق والاستخدام وسجل النشاط. لا تظهر أسرار ولا بيانات دفع أبدًا.

  • التطبيق يقترح وأنت تقرّر

    يستطيع التطبيق اقتراح إضافة أعضاء أو إزالتهم أو تغيير الأدوار أو تعديل الإعدادات أو حذف معرفة. ينتظر كل اقتراح مالك المساحة، فيوافق عليه في بيان فلو بكلمة مروره.

أمثلة لما تطلبه من تطبيقك

  • ابحث في معرفتي في بيان فلو عن سياسة الاسترجاع ولخّصها في ثلاث نقاط.
  • أي الوثائق تذكر مواعيد التوصيل؟ اعرضها مع قاعدة المعرفة التي توجد فيها كل واحدة.
  • أنشئ وثيقة باسم «قائمة مراجعة الإرجاع» في قاعدة مركز المساعدة بالخطوات التي اتفقنا عليها للتو.
  • اعرض استخدام هذا الشهر وآخر عشرة مدخلات في سجل النشاط.
  • اقترح إزالة الموظف الذي غادر الشركة. سأوافق عليه في بيان فلو.

ربط Claude في ثلاث خطوات

هذا لـ Claude.ai وClaude Desktop. لا مفتاح تنسخه: تسجّل الدخول إلى بيان فلو وتوافق على الاتصال.

تحتاج حسابًا في بيان فلو يكون مالك مساحة عمل، أو مشرفًا سمح له المالك بإدارة التكاملات. غير ذلك سيرى أنه لا يستطيع ربط تطبيق ويمكنه مراسلة المالك.

  1. أضف الموصّل في Claude

    افتح الإعدادات ← الموصّلات ← إضافة موصّل مخصص، والصق عنوان الخادم أدناه واحفظ.

    https://bayanflow.tech/api/v1/mcp

  2. اضغط «اتصال»

    تفتح صفحة من بيان فلو في متصفحك. سجّل الدخول إن طُلب منك.

  3. اختر مساحة العمل والصلاحيات

    اختر المساحة، وحدّد ما يُسمح لـ Claude بفعله، ثم اضغط «سماح». أي شيء يتجاوز القراءة يطلب كلمة مرورك، وتعود إلى Claude تلقائيًا.

ابدأ محادثة جديدة واكتب: «ابحث في معرفتي في بيان فلو عن سياسة الاسترجاع».

Claude Code

أضف الخادم، ثم شغّل الأمر /mcp داخل Claude Code واختر Authenticate. تفتح صفحة الموافقة نفسها.

claude mcp add --transport http bayan-flow https://bayanflow.tech/api/v1/mcp

العملاء الذين لا يفتحون صفحة تسجيل دخول

لـ Cursor أو VS Code أو أي سكربت، أنشئ مفتاح MCP من التكاملات ← MCP وأرسله كترويسة Bearer. احفظه في متغير بيئة ولا تضعه في ملف مشترك.

Authorization: Bearer $BAYAN_MCP_KEY

لفصل الاتصال افتح التكاملات ← MCP في بيان فلو وألغِ الاتصال. يفقد التطبيق الوصول فورًا.

ChatGPT وتطبيقات الذكاء الاصطناعي الأخرى

يصلح أي تطبيق يدعم خوادم MCP البعيدة عبر HTTPS. والتطبيقات التي تقدّم تسجيل دخول OAuth تستخدم الرابط الواحد نفسه كما في Claude. تختلف أسماء القوائم بين التطبيقات وتتغير مع الوقت: ابحث عن «موصّل مخصص» أو «وضع المطور» أو «إضافة خادم MCP».

ChatGPT

متاح في خطط ChatGPT المدفوعة التي تسمح بموصّلات MCP مخصصة. وفي مساحات الأعمال قد يلزم أن يسمح بذلك المشرف أولًا.

  1. في إعدادات ChatGPT فعّل وضع المطور (تجده تحت «الموصّلات» أو «الأمان»).
  2. أنشئ موصّلًا (أو تطبيقًا) جديدًا: الصق عنوان الخادم واختر OAuth للمصادقة. لا تحتاج معرّف عميل ولا سرًّا لأن ChatGPT يسجّل نفسه.
  3. اضغط «اتصال». تفتح صفحة من بيان فلو: اختر مساحة العمل والصلاحيات ثم اضغط «سماح».
https://bayanflow.tech/api/v1/mcp

تطبيقات أخرى تدعم OAuth

الصق عنوان الخادم واترك المصادقة على OAuth أو تلقائي. يسجّل التطبيق نفسه ويحوّلك إلى صفحة الموافقة في بيان فلو.

تطبيقات لا تشغّل إلا خوادم محلية

استخدم أداة mcp-remote (تحتاج Node.js) التي تحوّل الخادم البعيد إلى محلي. تجد مقاطع جاهزة في التكاملات ← MCP.

تطبيقات تستخدم مفتاحًا

تقبل Cursor وVS Code وWindsurf وGemini CLI وCodex CLI وأدوات مشابهة ترويسة مخصصة. أنشئ مفتاح MCP من التكاملات ← MCP واحفظه في متغير بيئة. تختلف أسماء الإعدادات قليلًا بين التطبيقات، والمهم هو العنوان والترويسة.

{
  "mcpServers": {
    "bayan-flow": {
      "url": "https://bayanflow.tech/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${BAYAN_MCP_KEY}" }
    }
  }
}

تعرض صفحة الموافقة اسم التطبيق والعنوان الذي سيعود إليه. تُعلَّم تطبيقات Anthropic وOpenAI بأنها موثّقة، أما أي تطبيق آخر فتحقق من العنوان قبل أن تسمح.

الأدوات

25 أداة، كلها مذكورة أدناه. لكل أداة عنوان وعلامة تبيّن هل هي للقراءة فقط، ليعرف التطبيق ومستخدموه ما تفعله الأداة قبل تشغيلها.

قراءةأدوات تنظر فقط

لا يتغير شيء ولا يُستهلك رصيد.

  • knowledge_list_basesknowledge:read

    يعرض قواعد المعرفة التي يسمح بها المفتاح، مع مستوى الوصول وعدد المستندات.

  • knowledge_searchknowledge:read

    يبحث في معرفتك ويعيد أفضل المقاطع مع مصادرها. استرجاع فقط: بلا نص من الذكاء الاصطناعي وبلا رصيد.

  • knowledge_list_documentsknowledge:read

    يعرض مستندات قاعدة معرفة واحدة.

  • knowledge_get_documentknowledge:read

    يقرأ نص مستند واحد، صفحةً صفحة.

  • workspace_getworkspace:read

    اسم مساحة العمل ولغاتها وباقتها واستخدام المقاعد.

  • workspace_list_membersworkspace:read

    الأعضاء مع دور كل منهم وحالته. تُخفى عناوين البريد جزئيًا.

  • workspace_list_teamsworkspace:read

    الفرق وعدد أعضاء كل فريق.

  • workspace_usageworkspace:read

    مجاميع الطلبات والرصيد والنشاط في الأيام الأخيرة.

  • workspace_audit_logworkspace:read

    آخر مدخلات سجل النشاط: من فعل ماذا، دون المحتوى أبدًا.

  • workspace_list_pending_actionsworkspace:read

    التغييرات التي اقترحتها المفاتيح وما آلت إليه.

  • store_order_statusworkspace:read

    حالة طلب واحد من المتجر المربوط: الشحن والتتبع والمنتجات والإجمالي. دون أي بيانات للعميل.

كتابةأدوات تكتب المعرفة

تنشئ المعرفة أو تعدّلها. تُحفظ التعديلات كإصدارات جديدة ولا يُحذف شيء.

  • knowledge_create_baseknowledge:write

    ينشئ قاعدة معرفة عامة للشركة. لا يتاح للمفاتيح المحصورة بقواعد مختارة.

  • knowledge_create_documentknowledge:write

    يضيف مستندًا جديدًا إلى قاعدة معرفة. يُفهرَس في الخلفية.

  • knowledge_update_documentknowledge:write

    يحفظ النص الجديد كإصدار جديد. تبقى الإصدارات القديمة ولا يُحذف شيء.

تحتاج موافقةأدوات تقترح تغييرات

لا تغيّر شيئًا بنفسها أبدًا. تنشئ اقتراحًا يوافق عليه مالك المساحة أو يرفضه في بيان فلو.

  • knowledge_delete_documentworkspace:admin

    يقترح حذف مستند. لا يُحذف شيء حتى يوافق المالك.

  • knowledge_archive_baseworkspace:admin

    يقترح أرشفة قاعدة معرفة فتتوقف عن تقديم الإجابات.

  • member_inviteworkspace:admin

    يقترح دعوة شخص بالبريد الإلكتروني. لا تُرسل الدعوة إلا بعد الموافقة.

  • member_change_roleworkspace:admin

    يقترح تغيير دور عضو إلى مشرف أو عضو. لا يشمل المالك أبدًا.

  • member_disableworkspace:admin

    يقترح تعطيل عضو: يفقد الوصول ويتحرر مقعده.

  • member_removeworkspace:admin

    يقترح إزالة عضو من مساحة العمل.

  • team_createworkspace:admin

    يقترح إنشاء فريق.

  • team_updateworkspace:admin

    يقترح إعادة تسمية فريق أو تغيير وصفه.

  • team_deleteworkspace:admin

    يقترح حذف فريق.

  • team_set_membersworkspace:admin

    يقترح استبدال قائمة أعضاء فريق.

  • workspace_update_settingsworkspace:admin

    يقترح تغيير الاسم أو اللغات أو ما يُسمح للمشرفين به. لا يشمل التكاملات ولا الفوترة أبدًا.

يرى التطبيق الأدوات التي تسمح بها صلاحياتك فقط. إن غابت أداة تتوقعها فأعد الربط وحدّد صلاحيات أكثر.

الصلاحيات

تختارها في صفحة الموافقة. لا يستطيع الاتصال فعل أكثر مما حددته، ويمكنك إلغاؤه في أي وقت.

  • قراءة المعرفة

    knowledge:read

    البحث في قواعد المعرفة التي يسمح بها المفتاح وقراءتها. لا يتغير شيء ولا يُستهلك رصيد.

    تكفي ضغطة واحدة للسماح.

  • كتابة المعرفة

    knowledge:write

    إنشاء قواعد المعرفة والمستندات، وحفظ التعديلات كإصدارات جديدة. لا يحذف شيئًا أبدًا.

    تطلب كلمة مرورك.

  • قراءة مساحة العمل

    workspace:read

    الاطلاع على الأعضاء (الأسماء والأدوار والبريد مخفيًا جزئيًا) والفرق والاستخدام وسجل النشاط. لا أسرار ولا بيانات دفع.

    تكفي ضغطة واحدة للسماح.

  • اقتراح تغييرات في مساحة العمل

    workspace:admin

    اقتراح تغييرات على الأعضاء والفرق والإعدادات وحذف المعرفة. كل اقتراح ينتظر موافقة المالك.

    لمالكي المساحات فقط، وتطلب كلمة مرورك، وكل تغيير يبقى بحاجة إلى موافقة المالك.

الأمان والخصوصية

بُني الموصّل بحيث يبقى أثر أي خطأ أو توكن مسرّب أو مساعد يسيء التصرف صغيرًا.

  • تسجيل دخول تتحكم به

    OAuth 2.0 برمز تفويض مع PKCE. لا يرى التطبيق كلمة مرورك ولا يرى بيان فلو بيانات دخول التطبيق. تعرض صفحة الموافقة اسم التطبيق والعنوان الذي سيعود إليه.

  • ما تسمح به فقط

    يقتصر الاتصال على مساحة عمل واحدة وعلى الصلاحيات التي حددتها. ويجب أن يبقى من وافق عليه مديرًا للتكاملات فيها، وإلا توقف الاتصال.

  • موافقة المالك

    التغييرات الحساسة اقتراحات فقط. يوافق عليها المالك بكلمة مروره؛ وبعد 5 محاولات خاطئة يُمنع الاعتماد 15 دقيقة، وينتهي الاقتراح الذي لا يبتّ فيه أحد بعد 24 ساعة.

  • وصول قصير الأمد

    يصلح رمز الوصول ساعة واحدة ويتجدد تلقائيًا. وإذا استُعملت نسخة من رمز التجديد مرة ثانية أُلغي الاتصال كله.

  • ألغِ في أي وقت

    ألغِ الاتصال من التكاملات ← MCP أو من التطبيق. تُرفض الاقتراحات المنتظرة ويتوقف الوصول فورًا.

  • سجل تدقيق

    يسجّل بيان فلو أي أداة استُدعيت وكيف انتهت، ولا يسجّل المحتوى أبدًا. ويصل مالكي المساحة بريد إلكتروني عند إنشاء أي اتصال.

بياناتك

المقاطع التي يطلبها التطبيق تُرسل إلى مزوّده وتخضع لشروط خطتك لديه، فاربط فقط مساعدين تثق بهم شركتك. ويُوسم نص وثائقك بأنه بيانات لا تعليمات، لمقاومة حقن الأوامر. يرى بيان فلو استدعاءات الأدوات التي يجريها التطبيق ولا يرى محادثتك معه.

لا يمكن أبدًا عبر MCP مهما سمحت

  • حذف مساحة العمل
  • نقل الملكية أو تغيير المالك
  • كلمات المرور والجلسات والتحقق بخطوتين وتسجيل الدخول
  • إنشاء مفاتيح API أو عرضها أو إلغاؤها
  • تشغيل التكاملات أو إيقافها، أو تحديد من يديرها
  • الباقات والمقاعد وطرق الدفع والفواتير واسترداد المبالغ
  • تصدير البيانات الشخصية
  • أي شيء على مستوى منصة بيان
  • أي شيء في مساحة عمل أخرى

اقرأ سياسة الخصوصية · شروط الخدمة

حل المشكلات

زر «سماح» رمادي ولا يعمل

اختر مساحة العمل أولًا. إن كانت لديك أكثر من مساحة فلا تُختار واحدة تلقائيًا. يذكر سطر فوق الزر ما ينقص.

لا تظهر أي مساحة في صفحة الموافقة

لا يربط التطبيقات إلا مالكو المساحات والمشرفون الذين سمح لهم المالك بإدارة التكاملات. اطلب من المالك أن يربطه أو يمنحك هذه الصلاحية.

تقول الصفحة إن التكامل متوقف

أوقف بيان فلو MCP لهذه المساحة. تواصل مع الدعم من صفحة التواصل.

يقول التطبيق إن الاتصال انتهى أو يحتاج تسجيل دخول من جديد

تتجدد الاتصالات تلقائيًا ما دامت مستخدمة. بعد سنة، أو إن أُلغي الاتصال، اضغط «اتصال» في التطبيق مرة أخرى.

لماذا طلب كلمة مروري؟

أي شيء يتجاوز القراءة يطلب كلمة مرورك، كما في إنشاء مفتاح API. وإن كنت تدخل بحساب Google فقط فعيّن كلمة مرور أولًا من الإعدادات ← الأمان.

أداة أتوقعها غير موجودة

يرى التطبيق الأدوات التي تسمح بها صلاحياتك فقط. أعد الربط وحدّد صلاحيات أكثر.

يبلّغ التطبيق عن طلبات كثيرة

يسمح كل اتصال بـ 120 استدعاء أداة و30 كتابة في الدقيقة. انتظر قليلًا ثم حاول.

بلغت المساحة الحد الأقصى من الاتصالات

يمكن أن يكون في المساحة خمسة اتصالات MCP في وقت واحد. ألغِ اتصالًا لا تستخدمه من التكاملات ← MCP.

ما زالت المشكلة قائمة؟ راسلنا من صفحة التواصل

المرجع التقني

للمطورين وللمراجعين الذين يفحصون الاتصال.

عنوان الخادم
https://bayanflow.tech/api/v1/mcp
وسيلة النقل
Streamable HTTP بلا حالة: طلبات POST فقط، بلا جلسات ولا بث أحداث.
إصدارات بروتوكول MCP
2025-11-25, 2025-06-18, 2025-03-26
التفويض
OAuth 2.0 برمز تفويض مع PKCE (S256)، عملاء عامون، وتسجيل عملاء ديناميكي (RFC 7591)، واكتشاف وفق RFC 9728 وRFC 8414.
بيانات المورد المحمي
https://bayanflow.tech/.well-known/oauth-protected-resource/api/v1/mcp
بيانات خادم التفويض
https://bayanflow.tech/.well-known/oauth-authorization-server
نقطة التفويض
https://bayanflow.tech/oauth/authorize
نقطة الرموز
https://bayanflow.tech/api/oauth/token
تسجيل العملاء
https://bayanflow.tech/api/oauth/register
نقطة الإلغاء
https://bayanflow.tech/api/oauth/revoke
الرموز
رمز الوصول ساعة واحدة. يتبدل رمز التجديد عند كل استعمال: 60 يومًا من آخر استعمال وسنة كحد أقصى، ويبطل الرمز السابق.
الصلاحيات
knowledge:read, knowledge:write, workspace:read, workspace:admin
الحدود
لكل اتصال: 120 استدعاء أداة و30 كتابة في الدقيقة. وتُقطع الإجابة الواحدة عند 100 كيلوبايت.

جاهز للربط؟

أنشئ مساحة عمل أو سجّل الدخول، ثم اتبع الخطوات الثلاث أعلاه.

إنشاء حسابتسجيل الدخول