> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> اربط Claude Desktop أو أي عميل MCP بخادم Flowglad عبر عنوان URL الخاص بمؤسستك وOAuth للعمل مع Pages وTasks وSkills وAutomations، مع نصائح لاستكشاف الأخطاء.

اربط وكيلًا متوافقًا مع MCP بـ Flowglad للعمل مع المعرفة التجارية والسياق التشغيلي لمؤسستك.

يستطيع الموصل العثور على الصفحات (Pages) وتعديلها، وقراءة الملفات والسجلات المتصلة، وإنشاء المهام (Tasks)، وإدارة المهارات (Skills) القابلة لإعادة الاستخدام، وإنشاء الأتمتات (Automations) أو تشغيلها. تعتمد الأدوات المتاحة على الهوية المتصلة والأذونات الممنوحة وميزات المنتج المفعّلة.

## تطبيق قالب

عندما تكون `templates.apply` متاحة في `tools/list`، قدّم `templateId` منشورًا و`spaceId` موجودًا لإنشاء جميع موارد القالب. تنتمي التطبيقات والأتمتات (Automations) ونسخ الملفات العادية إلى ذلك Space، بينما تنتمي المهارات (Skills) إلى المؤسسة. تستخدم الملفات أسماءها المضبوطة في جذر Space ولا تستبدل أبدًا الملفات الموجودة. ويؤدي تعارض الأسماء المتطابقة إلى فشل ذلك المكوّن، بينما يمكن للمكوّنات المستقلة المتابعة. ويعني اكتمال الملف أن البايتات والبيانات الوصفية حُفظت بشكل دائم؛ ولا ينتظر ذلك الفهرسة.

يمكنك اختياريًا تقديم `connections` بوصفها مصفوفة من كائنات `{ connector, connectionId }`، بحد أقصى اتصال واحد لكل مزوّد. يجب أن تكون الاتصالات المقدَّمة قابلة للوصول ومتوافقة ومعيّنة بالفعل لـ Space عند الاقتضاء. أما الاتصالات المحذوفة فتترك الموارد في انتظار الإعداد. وتوصي الاستجابة بالاتصالات المؤهلة، أو بإنشاء اتصال عندما لا يتوفر أي اتصال.

يجري الإنشاء في مهمة Trigger.dev واحدة وفق ترتيب التبعيات، مع تسجيل نتائج المكوّنات في البيانات الوصفية للمهمة ومخرجاتها. وإعادة المحاولة التلقائية للمهمة بأكملها معطّلة؛ وقد تترك المهمة الفاشلة أو المتوقفة موارد جزئية. تُقرّ الاستجابة بأن الإنشاء أُدرج في الطابور وتتضمن المكوّنات المخطط لها وتوصيات الاتصال؛ لكنها لا تؤكد أن إنشاء الموارد قد اكتمل. استخدم أدوات list/get الخاصة بالموارد للعثور عليها وفحصها. وتبقى الموارد التي أُنشئت بنجاح إذا فشل مكوّن آخر.

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

## قبل الاتصال

تحتاج إلى:

* حساب Flowglad بصلاحية وصول إلى المؤسسة التي تريد استخدامها.
* عنوان URL لخادم MCP الإنتاجي الخاص بمؤسستك.
* وكيل أو عميل يدعم خادم MCP بعيدًا عبر Streamable HTTP وOAuth.
* أذونات المؤسسة وSpace اللازمة للعمل الذي تنويه.
* أي Connection أو ملف مصدر متاح بالفعل لـ Space المعني.

يتضمن قسم الأسعار المنشور في [الصفحة الرئيسية لـ Flowglad](https://www.flowglad.com/) خدمة MCP في خطط Free وPlus وMax. ولا تزال أذونات المؤسسة وSpace، ومنحة OAuth، وصلاحية الوصول إلى المصادر المتصلة سارية.

يجب إعداد الاتصالات بأنظمة الأعمال الخارجية في Flowglad وإتاحتها لـ Space المقصود قبل أن يتمكن الوكيل من استخدامها. راجع [الموصلات](/docs/ar/connectors.md) و[Spaces](/docs/ar/spaces.md).

## العثور على عنوان URL لمؤسستك

يستخدم الموصل الإنتاجي عنوان URL خاصًا بالمؤسسة:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

استبدل `{orgId}` بمعرّف مؤسستك الفعلي في Flowglad. احتفظ بالمعرّف كاملًا، بما في ذلك البادئة `org_`. لا تُدخل الأقواس المعقوفة أو معرّف مؤسسة مختلَقًا.

في Flowglad، افتح **Settings** ← **MCP** ← **Add MCP Connection** ← **Claude** ← **Website**. انسخ عنوان URL لخادم MCP الخاص بالمؤسسة المعروض هناك. استخدم تعليمات **Website** لعنوان URL بعيد؛ إذ تحتوي علامة التبويب المنفصلة **Desktop app** على تعليمات إعداد عبر سطر الأوامر.

إذا لم تتمكن من الوصول إلى هذه الإعدادات، فاطلب ذلك من مسؤول Flowglad لديك أو من [الدعم](mailto:support@flowglad.com).

استخدم عنوان URL الخاص بالمؤسسة لهذا الموصل. فعنوان URL الخاص باتصال معيّن قد يكشف مجموعة أدوات أضيق، ولا يمكن استخدامه بالتبادل مع عنوان URL الخاص بالمؤسسة الموضح هنا.

## الاتصال من Claude Desktop

شاهد [فيديو إعداد Claude Desktop](https://youtu.be/6qqSnrqDJ2o)، أو اتبع الخطوات أدناه.

[كيفية ربط Flowglad بـ Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

استخدم مسار الموصل المخصص في Claude Desktop لإضافة Flowglad وتفويض الوصول إلى حسابك.

**1. افتح نموذج الموصل المخصص.**

في Claude Desktop، انتقل إلى **Customize** ← **Connectors** ← **+ Add** ← **Add Custom Connector**.

**2. أضف موصل Flowglad.**

أدخل **Flowglad** اسمًا للموصل، أو اختر اسمًا آخر.

الصق عنوان URL الكامل لخادم MCP الخاص بمؤسستك في حقل URL. يمكنك نسخه من [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). ينبغي أن يبدو هكذا: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

لا تغيّر أي إعدادات أخرى للموصل. اختر **Add** للمتابعة. قد يسمّي Claude Desktop هذا الزر **Continue** في بعض الإصدارات.

**3. امنح Claude صلاحية الوصول إلى Flowglad.**

تابع مسار الاتصال لتفويض Claude بالوصول إلى حساب Flowglad الخاص بك. عند المطالبة، سجّل الدخول، وأكّد مؤسسة Flowglad المقصودة، وراجع صلاحيات الوصول المطلوبة قبل تفويضها.

عند اكتمال المسار، ارجع إلى Claude Desktop وتأكد من أن اتصال Flowglad متاح. اطلب من Claude التحقق من اتصال Flowglad وسرد Spaces التي يمكنك الوصول إليها.

التسجيل الديناميكي للعملاء في OAuth (Dynamic Client Registration) هو طريقة الاتصال المقصودة. لا تُضف كلمة مرور أو رمز وصول أو مفتاح API أو سر عميل إلى عنوان URL للخادم.

تصف هذه التعليمات ربط Flowglad مباشرةً بوصفه موصلًا مخصصًا؛ أما التوافر في الدليل فمسألة منفصلة.

## الاتصال من عميل MCP آخر

أضف عنوان URL نفسه الخاص بالمؤسسة بوصفه خادم MCP بعيدًا عبر Streamable HTTP. أكمل مسار OAuth في العميل باستخدام حساب Flowglad الخاص بك، ثم تحقق من المؤسسة والأدوات المتاحة.

يتفاوت دعم العملاء. ولا يعني نجاح الاتصال بالخادم أن العميل يستورد مهارات Flowglad تلقائيًا. إن امتداد اكتشاف المهارات وأداة `skills.list` واجهتان مختلفتان. راجع [المهارات](/docs/ar/skills.md) لمعرفة سلوك الاكتشاف وإدارة الحزم المدعوم.

## التعامل مع البيانات

يخضع استخدام Flowglad MCP لـ [سياسة خصوصية Flowglad](https://www.flowglad.com/privacy-policy). ويمكن لمسؤولي المؤسسة الاطلاع على جميع استدعاءات أدوات MCP التي أُجريت على مؤسستهم في [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## استكشاف الأخطاء وإصلاحها

| العَرَض | الخطوة التالية |
| - | - |
| يفشل الاتصال قبل تسجيل الدخول | تحقق من عنوان HTTPS الكامل ومعرّف المؤسسة. وتأكد من أن العميل يدعم MCP البعيد مع OAuth. |
| ينجح تسجيل الدخول لكن العمل غير متاح | تحقق من المؤسسة المختارة، وعضوية Space، ومنحة MCP، والاتصالات المتاحة في Space. |
| أداة كتابة غير متاحة أو مرفوضة | تأكد من أذونات المؤسسة وSpace المطلوبة. وأعد الاتصال إذا لزم نطاق OAuth ممنوح حديثًا. |
| تتعذر القراءة من مزوّد متصل | تأكد من أن تفويضه نشط وأن Connection متاح لـ Space المقصود. |
| يتعذر العثور على صفحة أو ملف | تأكد من Space الصحيح، وصلاحيات الوصول المباشرة والمرتبطة الخاصة به، وأن المصدر لا يزال متاحًا. |
| تُعيد عملية معرّف مهمة أو تشغيل | تحقق من حالة دورة الحياة أو التشغيل النهائية قبل الإبلاغ عن النجاح أو إعادة المحاولة. |
| تنتهي مهلة عملية كتابة | افحص ما إذا كانت قد اكتملت قبل إعادة المحاولة. فبعض العمليات تُنشئ سجلًا جديدًا أو تُدرج عملًا في الطابور مع كل استدعاء. |
| تنتهي صلاحية الوصول أو تُلغى | أعد الاتصال عبر OAuth وتحقق من المؤسسة والمنحة المقصودتين. وإذا استمر فشل إعادة الاتصال، فتواصل مع الدعم. |

للاطلاع على معلومات الأمان العامة، راجع [الأمان](/docs/ar/security.md) و[مركز الثقة](https://trust.flowglad.com) الخاص بنا. وإذا واجهت أي مشكلة في الاتصال، [تواصل معنا](mailto:support@flowglad.com).

عند التواصل مع الدعم، أرفق الوقت والعميل والأداة المتأثرة ورمز الخطأ الآمن ومعرّف الطلب إن توفّر. ولا تُرفق أبدًا كلمات المرور أو رموز bearer أو ملفات تعريف الارتباط أو عناوين URL الموقّعة للرفع/التنزيل أو بيانات العملاء.


## Related topics

- [Skills](/docs/ar/skills.md)
- [مرحبًا بك](/docs/ar/agents/introduction.md)
- [الأتمتات](/docs/ar/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.