وثائق خادم Curriculo ATS MCP

قم بتوصيل Curriculo ATS الخاص بك بـ Claude و Cursor وأي عميل AI متوافق مع MCP. خادم Curriculo ATS MCP هو خادم مستضاف عن بُعد على https://mcp.curriculo.me/mcp دون الحاجة إلى التثبيت. قم بالتحقق مرة واحدة باستخدام OAuth 2.1 أو رمز وصول شخصي، وستحصل على 25 أداة تقرأ وتعمل على بيانات التوظيف الخاصة بك في الوقت الفعلي.

المصدر: https://curriculo.me/docs/mcp/ (Curriculo ATS)

الخاصية	القيمة
نقطة النهاية	https://mcp.curriculo.me/mcp
النقل	HTTP قابل للبث
المصادقة	OAuth 2.1 + رمز وصول شخصي (PAT)
النطاقات	ats:read, ats:write
الأدوات	25

خادم Curriculo ATS MCP هو خادم مستضاف عن بُعد، ولا حاجة لتثبيت أو تشغيل محلي. قم بتوجيه أي عميل MCP إلى نقطة النهاية، وقم بالتحقق مرة واحدة، وستحصل على مجموعة من الأدوات التي تقرأ وتعمل على بيانات التوظيف الخاصة بك في الوقت الفعلي.

بدء سريع

استخدم هذه النقطة في كل مكان: https://mcp.curriculo.me/mcp

أسرع طريقة هي تدفق الموصل بنقرة واحدة من Claude:

افتح Claude، ثم الإعدادات، ثم الموصلات.
انقر على إضافة موصل مخصص والصق عنوان الخادم أعلاه.
أكمل تسجيل الدخول OAuth عندما يُطلب منك. يتصل Claude بمؤسستك.
ابدأ محادثة واسأل، على سبيل المثال، "ما الذي موجود في كل مرحلة من أدوار العمل المفتوحة لدي؟"

جديد هنا؟ اتبع الدرس خطوة بخطوة: تشغيل ATS الخاص بك في Claude.

توصيل عميل

يتحدث الخادم HTTP قابل للبث ويدعم كلاً من OAuth التفاعلي ورمز وصول شخصي عبر رأس Authorization: Bearer.

Claude

في Claude (الويب أو سطح المكتب)، انتقل إلى الإعدادات، الموصلات، إضافة موصل مخصص، ثم أدخل:

https://mcp.curriculo.me/mcp

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

كود Claude

أضف الخادم بأمر واحد (سيفتح OAuth في متصفحك عبر /mcp):

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp

أو قم بتمرير رمز وصول شخصي مباشرة مع رأس:

claude mcp add --transport http curriculo https://mcp.curriculo.me/mcp \
  --header "Authorization: Bearer YOUR_CURRICULO_PAT"

Cursor

افتح إعدادات Cursor، الأدوات و MCP، خادم MCP الجديد، وأضف هذا إلى mcp.json:

{
  "mcpServers": {
    "curriculo": {
      "url": "https://mcp.curriculo.me/mcp"
    }
  }
}

VS Code / أخرى

يمكن لأي عميل بدون دعم MCP عن بعد استخدام جسر mcp-remote:

{
  "mcpServers": {
    "curriculo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp"]
    }
  }
}

المصادقة

هناك طريقتان للمصادقة. كلاهما يحل إلى مستخدم في منظمة واحدة مع أذونات محددة.

OAuth 2.1 (موصى به)

تستخدم العملاء التفاعلية (Claude، Cursor) OAuth مع تسجيل عميل ديناميكي. تسجل الدخول إلى Curriculo، وتوافق على الاتصال، ويقوم العميل بتخزين رمز مؤقت يتم تحديثه تلقائيًا.

رمز الوصول الشخصي (PAT)

لإعداد CLI أو بدون واجهة، قم بإنشاء رمز في ATS وأرسله كرأس Bearer:

سجل في ats.curriculo.me.
انتقل إلى الإعدادات، API والتكاملات، رموز الوصول الشخصية.
أنشئ رمزًا، اختر نطاقاته، وانسخه (يظهر مرة واحدة).
مرره كـ Authorization: Bearer <token>.

النطاقات

ats:read: قائمة وقراءة الوظائف، المتقدمين، صندوق الوارد، المقابلات، التحليلات.
ats:write: إنشاء وتغيير البيانات: نقل المراحل، إرسال بريد إلكتروني، جدولة المقابلات، تحديث الوظائف.

استدعِ أداة whoami لتأكيد المستخدم المعتمد، المنظمة، طريقة المصادقة، والنطاقات الممنوحة.

مرجع الأدوات (25 أداة)

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

الوظائف (4)

list_jobs (قراءة): قائمة الوظائف في مؤسستك، الأحدث أولاً. المعلمات: الحالة، الصفحة، الحد.
get_job (قراءة): تفاصيل كاملة لوظيفة واحدة بواسطة UUID، بما في ذلك مراحل القمع وعدد المتقدمين. المعلمات: jobId (مطلوبة).
create_job (كتابة): إنشاء منشور وظيفة بمراحل قمع افتراضية. العنوان فقط مطلوب؛ يفتح كتجربة. المعلمات: العنوان (مطلوب)، الوصف، الموقع، النوع، عدد الموظفين، المهارات الأساسية، المهارات المفضلة، الحد الأدنى/الأقصى للراتب، عملة الراتب.
update_job_status (كتابة): تغيير حالة الوظيفة (مسودة / مفتوحة / متوقفة / مغلقة / مؤرشفة). المعلمات: jobId، الحالة (كلاهما مطلوب).

المتقدمون (8)

list_applicants (قراءة): قائمة المتقدمين، مع إمكانية توجيهها لوظيفة، مع مرشحات نجوم / مرفوضة / مؤرشفة. المعلمات: jobId، النجوم، المرفوضة، المؤرشفة، الصفحة، الحد.
get_applicant (قراءة): تفاصيل كاملة للمتقدم: مرحلة القمع، رابط الوظيفة، ملاحظات، تاريخ النشاط. المعلمات: applicantId (مطلوبة).
search_candidates (قراءة): بحث دلالي عبر جميع المرشحين. المعلمات: query (مطلوبة)، jobId، timestamp، الصفحة، الحد.
move_applicant_stage (كتابة): نقل متقدم إلى مرحلة قمع أخرى. يطلق أتمتة القمع. المعلمات: applicantId، funnelId (مطلوبة)، السبب.
add_applicant_note (كتابة): إضافة ملاحظة إلى متقدم. المعلمات: applicantId، المحتوى (مطلوب)، noteType، decisionFlag، roundName.
get_applicant_resume_text (قراءة): نص السيرة الذاتية المحللة والبيانات الهيكلية. المعلمات: applicantId (مطلوبة).
get_applicant_evaluation (قراءة): تقييم وكيل AI: درجة الملاءمة، تسميات AI، ملخص، حالة الفجوة. المعلمات: applicantId (مطلوبة).
reprocess_resume (كتابة): إعادة تشغيل نظام السيرة الذاتية (تحليل + تقييم + استخراج الرسم البياني). المعلمات: applicantId (مطلوبة).

صندوق الوارد والبريد الإلكتروني (5)

get_applicant_email_thread (قراءة): سلسلة البريد الإلكتروني الكاملة لمتقدم. المعلمات: applicantId (مطلوبة).
list_inbox_emails (قراءة): قائمة رسائل البريد الإلكتروني الواردة في صندوق الوارد الخاص بالمنظمة. المعلمات: jobId، الحالة، البحث، الصفحة، الحد.
get_inbox_stats (قراءة): إحصائيات ملخص صندوق الوارد: عدد غير المقروء والمجموع الكلي. المعلمات: لا شيء.
reply_to_applicant_email (كتابة): الرد على المتقدم، مع ربطه بأحدث بريد إلكتروني وارد. يتطلب Gmail متصل. المعلمات: applicantId، body (مطلوب)، subject.
send_bulk_email (كتابة): إرسال بريد إلكتروني إلى واحد أو أكثر من المتقدمين حسب معرفهم. يتطلب Gmail متصل. المعلمات: applicantIds، subject، messageBody (كلها مطلوبة).

المقابلات (2)

list_interviews (قراءة): قائمة المقابلات. المعلمات: jobId، applicantId، الحالة، النوع، dateFrom، dateTo، الصفحة، الحد.
schedule_interview (كتابة): جدولة مقابلة، منح روابط تغذية راجعة، و (مع Gmail) مزامنة حدث التقويم وإرسال بريد إلكتروني للجميع. المعلمات: applicantId، jobId، title، scheduledStart، scheduledEnd (مطلوبة)، بالإضافة إلى النوع، الموقع، مزود الاجتماع، participantIds، interviewers الخارجيين، المنطقة الزمنية، التعليمات.

التحليلات (2)

get_analytics (قراءة): نظرة عامة على تحليلات المنظمة: إجمالي المتقدمين، تغيير الفترة، القمع حسب المرحلة، الوظائف الأعلى، مزيج المصدر. الافتراضي هو آخر 30 يومًا. المعلمات: dateFrom، dateTo.
get_dashboard (قراءة): صندوق الوارد بالإضافة إلى الانهيار لكل وظيفة لمعلومات المتقدمين النشطين. المعلمات: لا شيء.

الأتمتة والاستيرادات (3)

list_job_automations (قراءة): قائمة الأتمتة القمعية المكونة للوظيفة. المعلمات: jobId (مطلوبة).
get_automation_executions (قراءة): تاريخ تنفيذ أتمتة واحدة، مع تمكين التصفح. المعلمات: automationId (مطلوبة)، الصفحة، الحد.
get_import_batch (قراءة): حالة دفعة استيراد المرشحين: التقدم، حالة كل ملف، الأخطاء. المعلمات: batchId (مطلوبة).

الحساب (1)

whoami (قراءة): إرجاع المستخدم المخول، المنظمة، طريقة المصادقة، والنطاقات المعطاة. المعلمات: لا شيء.

أمثلة على المطالبات

"أرني ما هو موجود في كل مرحلة من أدوار العمل المفتوحة لدي، وميز أي شيء متوقف."
"ابحث عن مهندسي React ذوي الخبرة كقادة فرق وأوجز أفضل خمسة."
"انقل Priya إلى المقابلة الثانية وصاغ ردًا يطلب توافرها الأسبوع المقبل."
"جدول مقابلة فيديو مدتها 45 دقيقة مع هذا المرشح يوم الخميس الساعة 2 مساءً بتوقيت شرق الولايات المتحدة وأضف رابط Google Meet."
"كيف تغير حجم المتقدمين مقابل الشهر الماضي، وأي وظيفة تحقق أفضل تحويل؟"

أدوات الكتابة لها تأثيرات حقيقية (إرسال بريد إلكتروني، تغيير خطوط الأنابيب، إغلاق وظائف). احتفظ بموافقات الأداة قيد التشغيل للإجراءات الكتابية حتى تثق في سير العمل، وامنح فقط ats:read إذا كنت تريد فقط التحليل.

الأسئلة الشائعة وحل المشكلات

هل أحتاج إلى تثبيت أو استضافة أي شيء؟

لا. الخادم مستضاف بالكامل على https://mcp.curriculo.me/mcp. قم بتوجيه عميلك إلى عنوان URL والتحقق.

أي العملاء مدعومون؟

أي عميل MCP يدعم الخوادم البعيدة عبر HTTP القابل للبث: Claude (الويب/سطح المكتب)، كود Claude، Cursor، VS Code، وآخرون. العملاء الذين ليس لديهم دعم بعيد أصلي يمكنهم استخدام جسر mcp-remote.

أدواتي تظهر "تحتاج إلى تسجيل دخول" أو لن تتصل.

أعد تشغيل تدفق OAuth (في كود Claude، اكتب /mcp؛ في Cursor، انقر على بحاجة إلى تسجيل دخول). إذا كنت تستخدم PAT، تأكد من أن الرأس هو بالضبط Authorization: Bearer <token> وأن الرمز لم يتم إلغاؤه أو انتهت صلاحيته.

أداة البريد الإلكتروني أو المقابلة تعيد خطأ.

تتطلب أدوات البريد الإلكتروني والتقويم (reply_to_applicant_email، send_bulk_email، الجانب البريدي من schedule_interview) اتصال Gmail نشط على المنظمة. قم بتوصيل Gmail في ATS، ثم جرب مرة أخرى.

كيف يمكنني تحديد ما يمكن للذكاء الاصطناعي القيام به؟

أصدر رمزًا يحتوي فقط على ats:read للوصول المحدود للتحليل، واستخدم إعدادات أذونات عميلك لكل أداة لتعطيل الأدوات الكتابية المحددة.

أي منظمة تعمل عليها؟

تلك المرتبطة برمزك. اتصل بـ whoami لتأكيد المستخدم، المنظمة، والنطاقات في أي وقت.

الأمان

الوصول المحدد. كل رمز مرتبط بمستخدم واحد ومنظمة و يحمل نطاقات ats:read / ats:write صريحة.
أقل امتياز. امنح أضيق نطاق يقوم بالمهمة؛ يفضل رموز القراءة فقط للتحليل.
إلغاء في أي وقت. يمكن إلغاء رموز الوصول الشخصية في الإعدادات، API والتكاملات؛ يمكن إزالة اتصالات OAuth من إعدادات موصل عميلك.
أمان النقل. جميع الحركة هي HTTPS عبر HTTP القابل للبث. لا تقم أبدًا بلصق رمز في عملاء غير موثوق بهم أو مشاركته كنص عادي.

إصدار HTML القياسي: https://curriculo.me/docs/mcp/