تطبيق قالب
عندما تكون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 المعني.
العثور على عنوان URL لمؤسستك
يستخدم الموصل الإنتاجي عنوان URL خاصًا بالمؤسسة:{orgId} بمعرّف مؤسستك الفعلي في Flowglad. احتفظ بالمعرّف كاملًا، بما في ذلك البادئة org_. لا تُدخل الأقواس المعقوفة أو معرّف مؤسسة مختلَقًا.
في Flowglad، افتح Settings ← MCP ← Add MCP Connection ← Claude ← Website. انسخ عنوان URL لخادم MCP الخاص بالمؤسسة المعروض هناك. استخدم تعليمات Website لعنوان URL بعيد؛ إذ تحتوي علامة التبويب المنفصلة Desktop app على تعليمات إعداد عبر سطر الأوامر.
إذا لم تتمكن من الوصول إلى هذه الإعدادات، فاطلب ذلك من مسؤول Flowglad لديك أو من الدعم.
استخدم عنوان URL الخاص بالمؤسسة لهذا الموصل. فعنوان URL الخاص باتصال معيّن قد يكشف مجموعة أدوات أضيق، ولا يمكن استخدامه بالتبادل مع عنوان URL الخاص بالمؤسسة الموضح هنا.
الاتصال من Claude Desktop
شاهد فيديو إعداد Claude Desktop، أو اتبع الخطوات أدناه.
استخدم مسار الموصل المخصص في Claude Desktop لإضافة Flowglad وتفويض الوصول إلى حسابك.
1. افتح نموذج الموصل المخصص.
في Claude Desktop، انتقل إلى Customize ← Connectors ← + Add ← Add Custom Connector.
2. أضف موصل Flowglad.
أدخل Flowglad اسمًا للموصل، أو اختر اسمًا آخر.
الصق عنوان URL الكامل لخادم MCP الخاص بمؤسستك في حقل URL. يمكنك نسخه من 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 واجهتان مختلفتان. راجع المهارات لمعرفة سلوك الاكتشاف وإدارة الحزم المدعوم.
التعامل مع البيانات
يخضع استخدام Flowglad MCP لـ سياسة خصوصية Flowglad. ويمكن لمسؤولي المؤسسة الاطلاع على جميع استدعاءات أدوات MCP التي أُجريت على مؤسستهم في Settings > Audit.استكشاف الأخطاء وإصلاحها
للاطلاع على معلومات الأمان العامة، راجع الأمان ومركز الثقة الخاص بنا. وإذا واجهت أي مشكلة في الاتصال، تواصل معنا.
عند التواصل مع الدعم، أرفق الوقت والعميل والأداة المتأثرة ورمز الخطأ الآمن ومعرّف الطلب إن توفّر. ولا تُرفق أبدًا كلمات المرور أو رموز bearer أو ملفات تعريف الارتباط أو عناوين URL الموقّعة للرفع/التنزيل أو بيانات العملاء.