نظرة عامة
قم بربط أي مساعد ذكي متوافق مع MCP ببيانات التوظيف في Flowmingo — لقراءة وظائفك ومرشحيك واتخاذ إجراءات محمية (دعوة، نقل، رفض، إزالة من مشروع)، بشكل آمن وبتفويض منك. مع صلاحيتين إضافيتين يمكنك تفعيلهما بنفسك، يمكن للمساعد أيضاً إنشاء مشاريع توظيف وتقييمات ونشر أو تعزيز أو إغلاق إعلان وظيفة (انظر ما الذي يمكنك فعله). جديد على MCP؟ إنه المعيار المفتوح الذي يسمح للمساعدات الذكية بالتفاعل مع أدوات مثل Flowmingo. تعرّف على ما هو MCP.
النقل: Streamable HTTP (النقل الحديث عن بُعد). لا يوجد SSE قديم — وجه عميلك دائمًا إلى /mcp، وليس /sse.
تعامل مع مفتاح API الخاص بك كما تتعامل مع كلمة المرور. فضّل OAuth أو إدخالاً موجهًا أو متغير بيئة على لصق مفتاح
fl_...خام في ملف قد تلتزم به في git (مثل.vscode/mcp.json،~/.cursor/mcp.json، إعداد Continue الخاص بك).
المصادقة — خياران
أ — تسجيل الدخول باستخدام Flowmingo (OAuth، موصى به). يفتح متصفحك صفحة موافقة Flowmingo؛ تقوم بلصق مفتاح API الخاص بك هناك. لا يتلقى المساعد مفتاحك الخام أبدًا. يتلقى رمز وصول ورمز تحديث، يمكنه استخدامهما للحصول على رمز وصول جديد. لا يستمر تسجيل الدخول إلى الأبد. يعيش رمز التحديث حوالي 30 يومًا افتراضيًا، محسوبًا من وقت إصداره، عند تسجيل الدخول أو عند أحدث تحديث، لذا فإن تسجيل الدخول الذي لا يُستخدم لمدة طويلة ينتهي، وقد يتطلب إصدار Flowmingo الذي يغيّر كيفية تخزين عمليات تسجيل الدخول منك تسجيل الدخول مرة أخرى. ثم يطلب منك المساعد تسجيل الدخول مرة أخرى، وتلصق مفتاحك مرة أخرى. لقطع الوصول مبكرًا، احذف مفتاح API هذا. لا يوجد معرف عميل أو سر لإنشائه (يستخدم Flowmingo تسجيل العميل الديناميكي). على العملاء الذين يعرضون إعدادات OAuth "متقدمة" (مثل Claude.ai)، اترك معرف العميل والسر فارغين.
ب — مفتاح API ثابت (ترويسة). أرسل مفتاحك كأي من الترويستين:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
احصل على مفتاحك في Flowmingo → الإعدادات → التكاملات → مفاتيح API. حدد Read hiring data و Read candidates — الأول يغطي الوظائف وخط الأنابيب والنتائج، والثاني يسمح للمساعد بالبحث عن شخص. أضف Manage pipeline / Invite candidates لإجراءات الكتابة المحمية. للسماح للمساعد بإنشاء مشاريع وتقييمات ونشر أو تعزيز إعلان وظيفة، حدد أيضًا Create hiring projects وCreate assessments. اقرأ إنشاء ونشر تحت "ما الذي يمكنك فعله" أولاً: هاتان الصلاحيتان اختياريتان، ويجب أن يكون منشئ المفتاح مالكًا أو مسؤولًا.
شكل المفتاح الكامل. قيمة واحدة طويلة: fl_live_، الاسم العام للمفتاح، نقطة، ثم سر طويل. يُعرض النصف السري مرة واحدة، مباشرة بعد إنشاء المفتاح؛ لاحقًا، تعرض قائمة مفاتيح API بدايتها فقط. القيمة التي لا تحتوي على نقطة هي اسم المفتاح فقط، وسيتم رفضها. أينما يكتب هذا الدليل fl_YOUR_KEY، استبدل كل ذلك بمفتاحك الكامل، بدون اقتباسات وبدون مسافات.
إذا لم يتصل. يعود المفتاح السيئ أو الفارغ كـ Missing credential أو The Flowmingo API key was rejected؛ كلاهما قد يعني أن القيمة لم تصلنا بالكامل، لذا تحقق من القيمة أولاً. إعداد مثل ${env:FLOWMINGO_API_KEY} يعمل فقط إذا كان البرنامج قادرًا على رؤية هذا المتغير، والمحرر الذي يُفتح من قفص الاتهام أو قائمة ابدأ غالبًا لا يقرأ ملف تعريف الطرفية الخاص بك. إما أن تبدأه من طرفية حيث تم تعيين المتغير، أو ضع مفتاحك الكامل في الملف (وأبقِ هذا الملف خارج git).
أيهما تختار؟ تدعم معظم العملاء كليهما؛ بعضها (مثل ChatGPT) OAuth فقط — تلاحظ كل علامة تبويب ما يدعمه ذلك العميل. بشكل عام، يناسب OAuth المساعدات التفاعلية (Claude.ai، ChatGPT، VS Code); ترويسة مفتاح API تناسب CLIs والأنظمة غير المباشرة/CI والمحررات التي تفضل فيها إدخال مفتاح.
ما يمكنك فعله
القراءات لا تتطلب موافقة. معظم الكتابات محمية. دعوة، أو رفض باستخدام إجراء الرفض، أو إزالة مرشحين من مشروع، أو حذف مشروع، أو، عادة، نقل إلى مرحلة مضبوطة على إرسال بريد إلكتروني للمرشح، تنتظر موافقة شخص على رابط، مع تسجيل الدخول إلى Flowmingo. لا يمكن للمساعد الموافقة عليه، والرد بـ"نعم" في الدردشة لا يُحتسب. يتم التحقق من إعداد البريد الإلكتروني للمرحلة عند طلب النقل. بالنسبة لملاحظة، أو تقييم، أو قائمة مختصرة، أو علامة، أو نقل إلى مرحلة غير مضبوطة على إرسال بريد إلكتروني للمرشح، يُطلب من المساعد إظهار معاينة لك أولاً والمضي قدمًا فقط عندما توافق، وهذا تعليم له، وليس قفلًا. موجه يظهره عميل الذكاء الاصطناعي الخاص بك قبل تشغيل أداة هو موجه خاص بالعميل وليس موافقة Flowmingo: دعوة، أو رفض باستخدام إجراء الرفض، أو نقل إلى مرحلة ترسل بريدًا إلكترونيًا لا تزال تنتظر رابط الموافقة، مهما طلب العميل. تنتهي صلاحية رابط الموافقة بعد 15 دقيقة، وطلب واحد لعدة مرشحين أو طلبات (على الأكثر 50) هو موافقة واحدة تسرد الجميع. بمجرد أن يتم تجهيز تغيير، يمكن للمساعد التحقق من حالته، وسحبه بينما لا يزال ينتظر، وتراجع عن تغيير قابل للعكس (ملاحظة، تقييم، علامة قائمة مختصرة، علامة، أو نقل لم يُرسل بريدًا إلكترونيًا لأحد) خلال 24 ساعة. التراجع غير متاح دائمًا: يجب أن يعود التغيير بمرجع تراجع، وتسجيل واحد هو أفضل جهد، والنقل لمرشح ليس لديه مرحلة سابقة لا يحتوي على واحد، لذا يجب على المساعد التحقق والقول بذلك عندما لا يكون هناك طريق للعودة. لا يمكن التراجع عن بريد إلكتروني تم إرساله. الأدوات المدرجة تحت إنشاء ونشر هي الاستثناء من كل هذا، باستثناء delete_project: فهي تعمل فورًا ولا يتم تجهيزها للموافقة. الإزالة وحذف المشروع لا يمكن التراجع عنهما. كل شيء محدد بمنظمتك.
قراءة
| القدرة | ما تفعله |
|---|---|
| قائمة إعلانات الوظائف | تصفح الأدوار المفتوحة والمغلقة في مؤسستك. |
| قائمة مجموعات المقابلات والمشاريع | شاهد تقييماتك (مجموعات المقابلات) من كل نوع (مقابلات AI، لعب الأدوار، اختبارات المهارات، الاختبارات الفنية، تقييمات السيرة الذاتية، العروض والتسجيلات؛ استبيانات عندما تطلبها) ومشاريع التوظيف الخاصة بك. |
| قائمة خط أنابيب المرشحين | عرض الطلبات حسب المرحلة عبر مشروع. |
| قراءة نتائج التقييم والدرجات | سحب نتائج من كل نوع: مقابلات AI، لعب الأدوار، اختبارات المهارات، الاختبارات الفنية، تقييمات السيرة الذاتية، العروض والتسجيلات والاستبيانات. كل نتيجة مُصنفة بنوعها. فقط بعض الأنواع تحمل درجة AI: العرض والاستبيان لا يتم تسجيلهما أبدًا، واختبار المهارات هو نسبة مئوية. |
| البحث عن مرشح | جلب اسم مرشح واحد وبريده الإلكتروني وسيرته الذاتية. |
| البحث عن مرشحين | البحث عن مرشحين بالاسم أو البريد الإلكتروني. |
| مقارنة المرشحين | ترتيب 2 إلى 10 مرشحين جنبًا إلى جنب. يتطلب صلاحية Read candidates بالإضافة إلى Read hiring data. |
| نظرة عامة على التوظيف | مسار التحويل لكل ما يمكن لاتصالك الوصول إليه (الشركة بأكملها، ما لم يكن المفتاح منشأ من قبل شخص مقيد ببعض المشاريع)، أو مضيق عند الطلب: الطلبات لكل مرحلة، النشط مقابل المرفوض، ولكل نوع تقييم له نتائج، النتائج المكتملة مقابل قيد التقدم ومتوسط الدرجة. مشروع يضيق كل عدد، لكن عدد نتائجه يغطي النتائج على التقييمات المرتبطة بذلك المشروع، لذا يمكن حساب مرشح من مشروع آخر يشارك في أحد تلك التقييمات أيضًا. تقييم يضيق فقط عدد النتائج: تبقى أعداد المراحل والطلبات عند كل ما يمكن لاتصالك الوصول إليه. لا يتم جمع الأنواع معًا أبدًا. |
| أفضل المرشحين | النتائج الأعلى ترتيبًا، مرتبة حسب الدرجة الإجمالية. يتم ترتيب كل نوع تقييم معًا ما لم تطلب نوعًا واحدًا أو تقييمًا واحدًا (مجموعة مقابلات). |
| تفاصيل نتيجة التقييم | درجات نتيجة واحدة لكل كفاءة بالإضافة إلى ملخص AI، للأنواع التي تحتوي عليها. اختبار مهارات، اختبار فني، عرض واستبيان لديهم القليل أو لا شيء. |
| تفاصيل إعلان الوظيفة | التفاصيل الكاملة لإعلان وظيفة واحد. |
هل إعلان الوظيفة مفتوح للجمهور؟ (get_job_post_publication) |
ما إذا كان يمكن لأي شخص فتح الصفحة العامة لإعلان الوظيفة: مباشر، أو لا يزال ينتظر فحص محتوى AI، أو مرفوض منه، أو مُعلَم، أو معطل، أو مشروعه غير مفتوح. أيضًا عنوانه العام وتعزيزه (معطل، flowmingo أو ممتد). يتطلب Read hiring data. |
| المقابلات القادمة | دعوات لأي نوع تقييم تم إرسالها أو مجدولة ولم تكتمل بعد. إنه ليس عدد كل من لا يزال معلقًا: دعوة تم تذكير مرشحها، أو فتح الرابط أو النقر عليه، تُستبعد حتى يبدأ المرشح، وكذلك تلك التي فشلت في التسليم. |
كتابة (محمية)
| القدرة | ما تفعله |
|---|---|
| دعوة مرشحين إلى تقييم | يجهز الدعوات لمقابلة AI، أو لعب دور، أو اختبار مهارات أو اختبار فني، وينتظر موافقة شخص على رابط. لا يُرسل شيء قبل ذلك. تقييم واحد وعلى الأكثر 50 مرشحًا لكل طلب؛ اختبار مهارات أو اختبار فني يتطلب مشروعًا وبريدًا إلكترونيًا لكل مرشح، وقد يخصم الراعي من محفظة مؤسستك عندما يبدأ المرشح فيه. |
| نقل مرشح إلى مرحلة أخرى | نقل إلى مرحلة مضبوطة على إرسال بريد إلكتروني للمرشح ينتظر عادة موافقة شخص على رابط (يُقرأ إعداد البريد الإلكتروني للمرحلة مرة واحدة، قبل النقل مباشرة، لذا يمكن لإعداد يتم تشغيله في تلك اللحظة أن يسمح بنقل بريد إلكتروني بدون موافقة). أي نقل آخر: يُطلب من المساعد معاينته وانتظار موافقتك، وعادة يمكن التراجع عنه لمدة 24 ساعة، عندما يعود بمرجع تراجع. على الأكثر 50 طلبًا لكل طلب. |
| رفض طلب | يطلب الموافقة على رابط. إذا وافق شخص، يحاول Flowmingo نقل الطلب إلى مرحلة المرفوض في المشروع؛ تحقق من النتيجة بعد ذلك. على الأكثر 50 طلبًا لكل طلب. |
إزالة مرشحين من مشروع (remove_application) |
يتطلب Manage pipeline. يطلب الموافقة على رابط. إذا وافق شخص، يحذف Flowmingo الطلبات من المشروع؛ يبقى ملف المرشح في مجموعة المواهب الخاصة بك وفي مشاريع أخرى. إنه ليس رفضًا، ولا يوجد تراجع. على الأكثر 50 طلبًا لكل طلب. |
| إضافة ملاحظة إلى نتيجة | يُطلب من المساعد معاينة الملاحظة المقترحة وانتظار موافقتك قبل حفظها. ملاحظة تنتمي إلى نتيجة تقييم واحدة (من أي نوع)، وليس إلى المرشح ككل. |
| تقييم نتيجة | يُطلب من المساعد معاينة التقييم وانتظار موافقتك. ينطبق التقييم على نتيجة تقييم واحدة. |
| إدراج نتيجة في قائمة مختصرة | يُطلب من المساعد معاينة تغيير القائمة المختصرة وانتظار موافقتك. ينطبق على نتيجة تقييم واحدة. |
| علامة / إضافة إلى مجموعة مواهب | يُطلب من المساعد معاينة تغيير العلامة أو مجموعة المواهب وانتظار موافقتك. |
| تحقق أو سحب أو تراجع عن تغيير | تحقق من حالة تغيير مُجهز (قيد الانتظار، منفذ، فاشل، منتهي الصلاحية أو استُبدل بطلب أحدث)، وسحب واحد لا يزال ينتظر الموافقة، أو التراجع عن تغيير قابل للعكس خلال 24 ساعة، عندما يعود بمرجع تراجع. |
إنشاء ونشر (يعمل فورًا، باستثناء حذف مشروع)
تخلق هذه الأدوات أشياء وتفتحها للجمهور. تتصرف بشكل مختلف عن الكتابات المحمية أعلاه:
- تعمل فورًا، باستثناء
delete_project. لا شيء مُجهز لموافقة شخص على رابط، ولا أي منها يرسل بريدًا إلكترونيًا لمرشح. ينتظرdelete_projectموافقة مالك أو مسؤول على رابط. - يجب أن يكون منشئ المفتاح مالكًا أو مسؤولًا، لكل أداة هنا باستثناء الإلغاء، الذي يتطلب فقط Invite candidates. تعمل الأدوات بصلاحيات الشخص الذي أنشأ مفتاح API. إذا كان ذلك الشخص عضوًا، يتم رفض الطلب.
- الإذنان اختياريان. Create hiring projects و Create assessments لا يُمنحان افتراضيًا. مع تسجيل الدخول (الخيار أ)، يحصل المساعد عليهما فقط إذا تحقق الشرطان: أن يدرجهما العميل بالاسم عند الاتصال، وأن يحملهما مفتاح API الذي تلصقه في صفحة الموافقة. العميل الذي لا يرسل قائمة بالأذونات يحصل على الأذونات الأربعة القياسية (Read hiring data، Read candidates، Manage pipeline، Invite candidates) التي يحملها المفتاح، ولا يحصل على هذين الإذنين، لذا لا يرى المساعد الأدوات التي تتطلبهما. مع مفتاح ثابت (الخيار ب)، تُعرض هذه الأدوات للمساعد بغض النظر عن الأذونات التي يحملها المفتاح، وترفض Flowmingo أي استدعاء لا يسمح به المفتاح.
- بعض الاستدعاءات تستغرق وقتًا. النشر ينتظر فحص محتوى AI، حتى حوالي 90 ثانية. إنشاء مشروع أو تقييم يستخدم توليد AI ويمكن أن يستغرق وقتًا أطول (اختبار فني يستغرق 3 إلى 9 دقائق). عندما يقول الرد إن العمل لا يزال معلقًا، يستدعي المساعد مرة أخرى بنفس مفتاح idempotency لقراءة أين وصل. إعادة المحاولة لا تنشئ مشروعًا أو تقييمًا ثانيًا أبدًا.
| القدرة | ما تفعله |
|---|---|
إنشاء مشروع توظيف (create_project) |
يتطلب Create hiring projects (اختياري). ينشئ مشروعًا بمراحله الافتراضية الأربع وإعلان وظيفة كتبه نفس AI مثل لوحة التحكم، من عنوان، والمنصب، ووصف اختياري. افتراضيًا، ينشئ أيضًا تقييم سيرة ذاتية ومقابلة AI؛ يمكن للمساعد تسمية تقييمات أخرى، أو لا شيء. يتم تشغيل إعلان الوظيفة ويصبح عامًا بمجرد أن يوافق فحص محتوى AI عليه، عادة خلال دقيقة. محدود بـ 10 مشاريع في الدقيقة و300 في اليوم لشركتك. مفتاح idempotency اختياري: عند تركه، يتم إنشاء واحد من الوسائط، لذا إعادة المحاولة لا تنشئ مشروعًا ثانيًا أبدًا. |
إنشاء تقييم (create_assessment) |
يتطلب Create assessments (اختياري). ينشئ تقييمًا واحدًا مع AI: مقابلة AI، تقييم سيرة ذاتية، اختبار مهارات، عرض، اختبار فني أو لعب دور، من عنوان وظيفة ووصف وظيفي اختياري، واسم، ومشروع، ولغة (علامة مثل en أو vi-VN; اختبار مهارات واختبار فني يتجاهلان اللغة). اربطه بمشروع حتى يمكن دعوة المرشحين إلى اختبار مهارات أو اختبار فني أو عرض. مفتاح idempotency اختياري، كما هو مذكور أعلاه. |
نشر إعلان وظيفة (publish_job_post) |
يتطلب Create hiring projects. يشغل إعلان الوظيفة ويتأكد من تشغيل فحص محتوى AI. يقول الرد ما إذا كانت الصفحة مباشرة الآن، أو لا تزال تنتظر الفحص، أو مرفوضة منه. يجب أن يكون مشروع التوظيف نشطًا. |
إلغاء نشر إعلان وظيفة (unpublish_job_post) |
يتطلب Create hiring projects. يوقف إعلان الوظيفة، بحيث يتوقف رابطه العام عن الفتح. افتراضيًا، يتم إيقاف التعزيز أيضًا (withdraw_boost هو true). |
تعزيز إعلان وظيفة (boost_job_post) |
يتطلب Create hiring projects. يضبط التعزيز على off أو flowmingo أو extended. التعزيز مجاني. رفعه يتطلب تشغيل إعلان الوظيفة، ومشروعه نشطًا، وشعار الشركة ووصفها، وفحص محتوى AI؛ قد ترفع الشركة 50 تعزيزًا في اليوم. |
فتح أو مسودة أو أرشفة مشروع (set_project_state) |
يتطلب Create hiring projects. ينقل مشروع التوظيف بين active وdraft وarchived. المسودة والأرشيف يغلقان رابط الوظيفة. يتم الاحتفاظ ببيانات المرشح. |
إلغاء دعوة مجدولة (cancel_scheduled_invite) |
يتطلب Invite candidates. يلغي دعوة مجدولة لاحقًا ولم يتم إرسالها بعد، باستخدام معرف الدعوة من نتيجة الدعوة. لا يتم إرسال بريد إلكتروني لأحد. يبقى الشخص في حسابك وعلى لوحة المشروع. |
حذف مشروع توظيف (delete_project) |
يتطلب Create hiring projects (اختياري). يطلب فقط: لا يحذف فورًا، يطلب موافقة على رابط، ولا يتم حذف أي شيء حتى يوافق مالك أو مسؤول. يمكن حذف مشروع نشط فقط. إذا وافق شخص، يحذف Flowmingo المشروع وإعلانات وظائفه؛ لا يتم حذف طلبات مرشحيه واحدًا تلو الآخر، ويتم الاحتفاظ بملفات المرشحين وجهات الاتصال وتقييماتك ورؤوس دعواتك. لا يوجد تراجع. |
الأمان والثقة
- بياناتك محددة بالمؤسسة — لا يمكن للمساعد أبدًا رؤية بيانات شركة أخرى.
- مع OAuth، لا يتلقى المساعد مفتاح API الخاص بك أبدًا. يحصل على رمز وصول تنتهي صلاحيته بعد ساعة، ويتم تحديثه بهدوء أثناء بقائه متصلاً. يستمر تسجيل الدخول نفسه طالما أن رمز التحديث الخاص به، حوالي 30 يومًا افتراضيًا من وقت إصداره أو آخر تحديث، لذا ينتهي بعد حوالي 30 يومًا بدون استخدام، ثم تسجل الدخول مرة أخرى. مع ترويسة ثابتة (الخيار ب)، يحتفظ عميل مساعدك بمفتاحك ويرسله مع كل طلب، لذا أبقِه خارج الملفات التي قد تشاركها أو تلتزم بها.
- قطع اتصال مساعد: احذف مفتاح API الذي أذنت له به، في الإعدادات → التكاملات → مفاتيح API. يتوقف الوصول فورًا. لا يوجد فصل لكل مساعد بعد، لذا إذا كنت تريد إلغاء صلاحياتهم واحدًا تلو الآخر، امنح كل مساعد مفتاحه الخاص.
- يتم فحص طلبات إلى نقطة النهاية
/mcpلأصلها: أصلnullمعتم يُرفض دائمًا، ويمكن قفل الفحص بقائمة مسموح بها، لكن افتراضيًا يتم قبول كل أصل حقيقي، لذا الحماية هي بيانات اعتمادك، وليس الأصل. كل جلسة مرتبطة ببيانات الاعتماد التي فتحتها.
لمعرفة كيفية المصادقة، انظر المصادقة — خياران; للقراءات الدقيقة والكتابات المحمية والإجراءات التي تحدث فورًا، انظر ما يمكنك فعله. عندما تكون مستعدًا، انتقل إلى ربط مساعدك واختر عميلك.
عنوان URL لخادم MCP
ربط مساعدك
Claude Code (CLI)
أمر واحد يضيف Flowmingo عبر Streamable HTTP الأصلي. ابدأ بـ OAuth؛ خيار --header الثابت هو البديل.
الخطوات: 1) أضف الخادم، 2) سجل الدخول (المتصفح → الصق المفتاح)، 3) تحقق باستخدام claude mcp list.
# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo # browser opens; paste your fl_ key on the consent page
# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
--header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"
# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp
claude mcp list && claude mcp get flowmingo
ملاحظة: يجب وضع العلامات قبل الاسم، واستخدم دائمًا --transport http (وليس sse أبدًا). استبدل fl_YOUR_KEY بمفتاحك الكامل (انظر ما شكل المفتاح الكامل في قسم المصادقة أعلاه).
تحقق من أنه يعمل — اسأل: "اعرض لي وظائفي المفتوحة."
Cursor
الرأس الثابت هو المسار الأبسط. يمكن لـ Cursor أيضًا استخدام OAuth (وهو يدعم تسجيل العملاء الديناميكي) — لهذا، قم بإزالة كتلة headers.
الخطوات: 1) أضف الخادم إلى ~/.cursor/mcp.json (أدناه)، 2) عيّن FLOWMINGO_API_KEY إلى مفتاحك الكامل في ملف تعريف shell الخاص بك، 3) أغلق Cursor وأعد تشغيله من الطرفية حيث تم تعيين المتغير، 4) في الإعدادات → MCP، بدّل الخادم إلى إيقاف ثم تشغيل لإعادة التحميل.
يجب أن يتمكن Cursor من رؤية المتغير. يقرأ Cursor ${env:FLOWMINGO_API_KEY} من بيئته الخاصة. عند تشغيله من قفص الاتهام أو قائمة ابدأ، غالبًا لا يرى متغيرًا تم تعيينه في ملف تعريف الطرفية، ومن ثم يصل الرأس فارغًا أو غير موسّع ويستجيب الخادم Missing credential. إذا لم يكن تشغيل Cursor من الطرفية عمليًا، فاستبدل ${env:FLOWMINGO_API_KEY} في الملف بمفتاحك الكامل (وأبقِ ~/.cursor/mcp.json خارج git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth بدلاً من ذلك — أزل كتلة headers؛ يقوم Cursor بتشغيل تسجيل العملاء الديناميكي ويفتح صفحة موافقة المتصفح عند أول اتصال:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
تحقق من أنه يعمل — اسأل: "قائمة الوظائف المفتوحة لدي."
VS Code (Copilot، وضع الوكيل)
الأدوات تظهر فقط في Copilot Chat → وضع الوكيل. المفتاح الجذر هو servers (وليس mcpServers) والنوع هو http. المسار المفتاح المطلوب أدناه هو الإعداد الموثوق.
الخطوات: 1) قم بإنشاء .vscode/mcp.json (أو قم بتشغيل MCP: Add Server → HTTP)، 2) عند بدء تشغيل الخادم، يطلب VS Code مفتاحك (لا يتم كتابته في الملف)، 3) استخدمه في وضع الوكيل.
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
يمكن لـ VS Code أيضًا محاولة OAuth، لكن إعداد OAuth الموثق يتطلب معرف عميل؛ استخدم المسار المطلوب أعلاه لإعداد موثوق.
تحقق من أنه يعمل — اسأل: "list my open jobs."
Claude — claude.ai و Claude Desktop
كلاهما يستخدم نفس واجهة مستخدم الموصلات ونفس تدفق لصق عنوان URL. OAuth فقط (لا يوجد حقل رأس في واجهة المستخدم).
الخطوات (الويب أو سطح المكتب):
- افتح الإعدادات → الموصلات وانقر فوق إضافة موصل مخصص.
- سمِّه
Flowmingoوالصق عنوان URL للخادم MCP أعلاه. اترك متقدم → معرف عميل OAuth / سر فارغًا. - انقر فوق إضافة → ربط. في صفحة موافقة Flowmingo، الصق مفتاح API
fl_الخاص بك وقم بالمصادقة. - تحقق — اسأل Claude: "list my open jobs."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
الفريق / المؤسسة: يضيف المالكها مرة واحدة ضمن إعدادات المؤسسة → الموصلات → مخصص؛ ثم ينقر الأعضاء على ربط.
هل تحتاج إلى مفتاح ثابت على Claude Desktop بدلاً من ذلك؟ استخدم علامة التبويب أي عميل (mcp-remote).
يفتح متصفحك صفحة موافقة Flowmingo عند الاتصال الأول — الصق مفتاح API الخاص بك وقم بالموافقة. لقطع الاتصال لاحقًا، احذف مفتاح API هذا في الإعدادات → التكاملات → مفاتيح API.
ChatGPT وOpenAI Codex CLI
كلاهما OpenAI. ChatGPT يستخدم وضع المطور للموصلات المخصصة (OAuth فقط)؛ Codex يتصل مباشرة من CLI.
ChatGPT (ويب)
- على chatgpt.com (Plus / Pro / Business / Enterprise / Edu — وليس الجوال)، افتح الإعدادات → التطبيقات → المتقدمة وفعّل وضع المطور.
- التطبيقات → إنشاء → الاسم
Flowmingo، الصق الرابط أدناه، النقل Streamable HTTP، المصادقة OAuth. - افتح المسودة، فعّل الأدوات، واضغط تحديث.
- أرفقه عبر قائمة + في المحادثة.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
وضع المطور لـ ChatGPT يتصل بـ OAuth فقط — لا يقبل ترويسة x-api-key ثابتة / ترويسة مفتاح API مخصصة. الموصلات العادية والبحث العميق تستخدم فقط search + fetch (لديك كلاهما). أدوات الكتابة (دعوة / نقل / رفض) تتطلب وضع المطور. رسالة يظهرها ChatGPT قبل تنفيذ أداة هي رسالة خاصة بـ ChatGPT وليست موافقة من Flowmingo: دعوة أو رفض أو نقل إلى مرحلة ترسل بريدًا إلكترونيًا للمرشح تنتظر دائمًا موافقة شخص عبر رابط Flowmingo.
OpenAI Codex CLI
لا حاجة لوسيط — Codex يتحدث Streamable HTTP بشكل أصلي.
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
تحقق من أنه يعمل — اسأل: "اعرض وظائفي المفتوحة."
Gemini CLI و Code Assist
Gemini CLI (ووضع وكيل Gemini Code Assist) يصل إلى خادم MCP عن بعد عبر ~/.gemini/settings.json. تطبيق Gemini للمستهلك لا يمكنه إضافة موصلات MCP مخصصة — هذا المسار مخصص لـ CLI / Code Assist فقط.
الخطوات: 1) أضف الخادم تحت mcpServers في ~/.gemini/settings.json، 2) قم بتصدير FLOWMINGO_API_KEY=fl_...، 3) قم بتشغيل gemini و /mcp لتأكيد إدراج الأدوات.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl يختار HTTP أصلي قابل للبث. يتم توسيع العنصر النائب ${FLOWMINGO_API_KEY} من بيئتك، لذلك لا يتم كتابة مفتاح خام في الملف. تفضل OAuth؟ يمكن لـ Gemini CLI القيام بذلك أصليًا — احذف كتلة headers وأضف "authProviderType": "dynamic_discovery" إلى إدخال الخادم. يكتشف CLI تحدي 401، ويكتشف بيانات تعريف OAuth الخاصة بنا، ويقوم بتسجيل العميل ديناميكيًا بنفسه (لا يوجد معرف عميل لتعيينه).
تحقق من أنه يعمل — في
gemini، اسأل: "list my open jobs."
عملاء آخرون — Windsurf · Zed · Cline · Continue · Antigravity
يعمل كل عميل أدناه مع الخادم نفسه، ويدعم معظمها كلًّا من OAuth وترويسة ثابتة. تستخدم المقاطع مفتاحًا ثابتًا عبر متغير بيئي؛ احذف headers للسماح للعميل باستخدام OAuth عندما يكون مدعومًا. انتبه إلى اختلافات أسماء المفاتيح الخاصة بكل عميل والمذكورة أدناه.
Google Antigravity
أضف https://mcp.flowmingo.ai/mcp كخادم MCP بعيد، ثم اختر مصادقته: ستفتح صفحة Flowmingo وتطلب منك إدخال مفتاح API الكامل (راجع كيف يبدو المفتاح الكامل في قسم المصادقة أعلاه). تسجّل كل واجهة في Antigravity (بيئة التطوير المتكاملة وواجهة CLI) الدخول بشكل منفصل. في ملف mcp_config.json الخاص بـ Antigravity، يُوضَع العنوان ضمن serverUrl، بينما يُوضَع المفتاح الثابت في كتلة headers تحت Authorization مسبوقًا بـ Bearer ، مع إدخال مفتاحك الكامل، كما في أمثلة Antigravity الخاصة بـ MCP من Google. لم نتمكن من اختبار كل إصدارات Antigravity، لذا إذا اختلفت القوائم لديك، فراجع دليل Google للاطلاع على الخطوات الحالية.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — يقبل Windsurf serverUrl أو url، ويدعم OAuth (احذف headers لتفعيله).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — المفتاح هو context_servers؛ احذف headers لاستخدام OAuth الأصلي. عيّن FLOWMINGO_API_KEY=fl_... في بيئتك بدلًا من لصق مفتاح خام.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — عيّن type: "streamableHttp" (بحالة camelCase)، وإلا فسيُضبط افتراضيًا على SSE غير الفعّال.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — اتصل عبر جسر mcp-remote. عيّن FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY.
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
تحقّق من نجاح الإعداد — اسأل: "اعرض وظائفِي المفتوحة."
أي عميل (mcp-remote)
لأي عميل stdio فقط (أو عميل مستقبلي لا يدعم النقل عن بُعد بشكل أصلي)، يمكنك الربط مع Flowmingo باستخدام أمر mcp-remote من خلال stdio. --transport http-only مطلوب — الخادم لا يدعم SSE.
الخطوات: 1) تأكد من تثبيت Node إصدار 18 أو أحدث، 2) شغّل الجسر كأمر stdio في عميلك، 3) في أول تشغيل OAuth، يفتح المتصفح — الصق مفتاحك.
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
الحل: إذا علق المصادقة، نفّذ الأمر rm -rf ~/.mcp-auth ثم أعد المحاولة. استبدل fl_YOUR_KEY بمفتاحك الكامل (انظر ما هو شكل المفتاح الكامل في قسم المصادقة أعلاه). في مصفوفة JSON args[]، تجنب المسافة بعد النقطتين في الترويسة (خاصية غريبة في npx).
تحقق من أنه يعمل — اسأل: "قائمة الوظائف المفتوحة لدي."