التكاملات

ربط مساعدي الذكاء الاصطناعي (MCP)

ربط أي مساعد ذكاء اصطناعي متوافق مع MCP — Claude، Claude Code، ChatGPT، Cursor، VS Code، والمزيد — ببيانات التوظيف الخاصة بك في Flowmingo، والعمل على خط أنابيب التوظيف الخاص بك بلغة واضحة.

Our team is online
هل تحتاج مساعدة في التكامل؟

هل تعثّرت في إحدى الخطوات أو تحتاج إلى دعم تقني؟ يسعد فريقنا بمساعدتك — تواصل معنا في أي وقت وسنوصلك بالشخص المناسب.

نظرة عامة

قم بربط أي مساعد ذكي متوافق مع 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

عنوان URL لخادم MCPhttps://mcp.flowmingo.ai/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 بمفتاحك الكامل (انظر ما شكل المفتاح الكامل في قسم المصادقة أعلاه).

تحقق من أنه يعمل — اسأل: "اعرض لي وظائفي المفتوحة."