بروتوكول سياق النموذج

خادم Curriculo ATS MCP

قم بتوصيل Curriculo ATS الخاص بك بـ Claude وCursor وأي عميل متوافق مع MCP. اطلب بلغة بسيطة مراجعة المرشحين، نقل العمليات، الرد على المتقدمين، جدولة المقابلات، وسحب التحليلات, يعمل الذكاء الاصطناعي لديك مباشرة في ATS الخاص بك.

نقطة النهاية mcp.curriculo.me/mcpالنقل HTTP قابل للبثالمصادقة OAuth 2.1 + PATالنطاقات ats:read · ats:writeالأدوات 25

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

بدء سريع #

قم بالتوصيل في أقل من دقيقة. استخدم هذه نقطة النهاية في كل مكان:

عنوان URL للخادمhttps://mcp.curriculo.me/mcp

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

افتح Claude → الإعدادات → الموصلات.
انقر على إضافة موصل مخصص والصق عنوان URL للخادم أعلاه.
أكمل تسجيل الدخول عبر OAuth عند الطلب, يتصل Claude بمنظمتك.
ابدأ محادثة واطلب، على سبيل المثال “ما الذي يوجد في كل مرحلة من أدواري المفتوحة؟”

هل أنت جديد هنا؟

اتبع الخطوات خطوة بخطوة الدرس: تشغيل ATS الخاص بك في Claude، مع لقطات شاشة ترشدك خلال عملية التوصيل، وتصنيف المرشحين حسب ملاءمتهم للذكاء الاصطناعي، وجدولة المقابلات من محادثة.

نصيحة

تفضل سطر الأوامر أو عميل مختلف؟ انظر توصيل عميل لـ Claude Code وCursor وVS Code، بما في ذلك الإعداد القائم على الرموز.

توصيل عميل #

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

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

# عنوان URL للموصل المخصص
https://mcp.curriculo.me/mcp

انقر على إضافة، أكمل تسجيل الدخول عبر OAuth، ثم افتح الموصل لتمكين الأدوات المحددة التي ترغب في استخدام 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"

قم بتشغيل /mcp داخل Claude Code للتحقق من الحالة أو بدء تسجيل الدخول عبر OAuth.

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

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

يظهر Cursor يحتاج إلى تسجيل الدخول, انقر عليه لتشغيل تدفق موافقة OAuth، ثم تتحول الأدوات إلى اللون الأخضر.

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

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

للتوثيق بدون واجهة مستخدم، أضف الوسيط الخاص بالرأس:

"args": ["-y", "mcp-remote", "https://mcp.curriculo.me/mcp",
        "--header", "Authorization: Bearer YOUR_CURRICULO_PAT"]

التوثيق #

طريقتان للتوثيق. كلاهما يحللاً مستخدم في منظمة واحدة بصلاحيات محددة.

OAuth 2.1 (موصى به)

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

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

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

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

النطاقات

تحمل الرموز نطاق واحد أو كليهما. امنح فقط ما تحتاجه:

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

whoami

لست متأكدًا من الدور الذي تعمل به رمز ما؟ استخدم أداة whoami, ستعيد المستخدم الذي تم التوثيق به، المنظمة، طريقة التوثيق، والنطاقات الممنوحة.

مرجع الأدوات #

25 أداة عبر ست مجموعات. read الأدوات لا تغير البيانات أبدًا؛ write الأدوات تقوم بإنشاء أو تعديل السجلات وقد تؤدي إلى إرسال رسائل البريد الإلكتروني، أحداث التقويم، أو الأتمتة.

الوظائف

4 أدوات

list_jobsread

عرض الوظائف في منظمتك، الأحدث تحديثًا أولاً. فلتر الحالة اختياري.

الوسائط:status, page, limit

get_jobread

تفاصيل كاملة لوظيفة واحدة حسب UUID، بما في ذلك مراحل القمع وعدد المتقدمين.

الوسائط:jobId (مطلوب)

create_jobwrite

إنشاء إعلان وظيفة بمراحل قمع افتراضية. العنوان فقط هو المطلوب؛ يفتح في حالة المسودة.

الوسائط:title (مطلوب)، description, location, type, headcount, must_have_skills, preferred_skills, salary_min/max, salary_currency

update_job_statuswrite

تغيير حالة وظيفة (DRAFT / OPEN / PAUSED / CLOSED / ARCHIVED). الإغلاق أو الإيقاف يعيد فهرسة تغذية الوظائف ويقوم بإرسال بريد إلكتروني للمتقدمين الذين لم يتم اختيارهم, استخدمه بعناية.

الوسائط:jobId, status (كلاهما مطلوب)

المتقدمين

8 أدوات

list_applicantsread

عرض المتقدمين، مع إمكانية التصفية حسب وظيفة، مع فلاتر نجمة / مرفوض / مؤرشف.

الوسائط:jobId, starred, rejected, archived, page, limit

get_applicantread

تفاصيل كاملة عن المتقدم: مرحلة القمع، رابط الوظيفة، الملاحظات، وتاريخ الأنشطة.

الوسائط:applicantId (مطلوب)

search_candidatesread

بحث دلالي عبر جميع المرشحين. استعلامات اللغة الطبيعية تعيد نتائج مرتبة انطلاقًا من مقاطع السيرة الذاتية المطابقة والتعليقات.

الوسائط:query (مطلوب)، jobId, timestamp, page, limit

move_applicant_stagewrite

نقل متقدم إلى مرحلة قمع أخرى. يطلق الأتمتة؛ التحرك إلى عرض قد يغلق وظيفة مليئة تلقائيًا.

الوسائط:applicantId, funnelId (مطلوب)، reason

add_applicant_notewrite

إضافة ملاحظة لمتقدم. خاصة بشكل افتراضي؛ اختياريًا وسوم اتخاذ القرار PASS/FAIL وجولة المقابلة.

الوسائط:applicantId, content (مطلوب)، noteType, decisionFlag, roundName

get_applicant_resume_textread

نص السيرة الذاتية المحلل والبيانات المهيكلة لمتقدم (بدون ملف PDF).

المدخلات:applicantId (مطلوب)

get_applicant_evaluationread

تقييم وكيل AI-graph: درجة الملاءمة، علامات AI، ملخص، وحالة الفجوة.

المدخلات:applicantId (مطلوب)

reprocess_resumewrite

إعادة تشغيل عملية المعالجة للسيرة الذاتية (تحليل + تقييم + إدخال الرسم البياني) لمتقدم. غير متزامن.

المدخلات:applicantId (مطلوب)

البريد الوارد والبريد الإلكتروني

5 أدوات

get_applicant_email_threadread

سلسلة البريد الإلكتروني الكاملة (الوارد + الصادر) لمتقدم.

المدخلات:applicantId (مطلوب)

list_inbox_emailsread

قائمة رسائل البريد الوارد في صندوق البريد الخاص بالمنظمة. تصفية حسب الوظيفة، الحالة، أو البحث النصي الحر.

المدخلات:jobId, status, search, page, limit

get_inbox_statsread

إحصائيات ملخص البريد الوارد: عدد غير المقروء والمجموعات.

المدخلات: لا شيء

reply_to_applicant_emailwrite

الرد على متقدم، مما يربطه بأحدث بريد وارد من عنوان الوظيفة. يتطلب Gmail متصل.

المدخلات:applicantId, body (مطلوب), subject

send_bulk_emailwrite

إرسال بريد إلكتروني إلى متقدم واحد أو أكثر حسب الهوية (تواصل أو تحديثات). يتطلب Gmail متصل.

المدخلات:applicantIds, subject, messageBody (جميعها مطلوبة)

المقابلات

2 أدوات

list_interviewsread

قائمة المقابلات. تصفية حسب الوظيفة، المتقدم، الحالة، النوع، أو مدى التاريخ.

المدخلات:jobId, applicantId, status, type, dateFrom, dateTo, page, limit

schedule_interviewwrite

جدولة مقابلة: تضيف المقابلين، تنشئ روابط التعليقات، و(مع Gmail) تقوم بمزامنة حدث تقويمي وتراسل الجميع. رابط Zoom/Meet يتم إنشاؤه تلقائيًا اختياريًا.

المدخلات:applicantId, jobId, title, scheduledStart, scheduledEnd (مطلوب), type, location, meetingProvider, participantIds, externalInterviewers, timezone, instructions

التحليلات

2 أدوات

get_analyticsread

نظرة عامة على تحليلات المنظمة: إجمالي المتقدمين، تغيير الفترة، خط الأنابيب حسب المرحلة، أفضل الوظائف، ومزيج المصدر. الإعداد الافتراضي هو آخر 30 يومًا.

المدخلات:dateFrom, dateTo

get_dashboardread

ملخص صندوق الوارد بالإضافة إلى تفصيل فرز الوظائف للمتقدمين النشطين, نظرة سريعة على كل خط أنابيب مفتوح.

المدخلات: لا شيء

الأتمتة والاستيرادات

3 أدوات

list_job_automationsread

قائمة أتمتة الخط المهيأة لوظيفة (بريد إلكتروني، جدولة مقابلة، علامات، إشعار، إلخ).

المدخلات:jobId (مطلوب)

get_automation_executionsread

تاريخ تنفيذ أتمتة واحدة، مع صفحات.

المدخلات:automationId (مطلوب), page, limit

get_import_batchread

حالة دفعة استيراد مرشح: التقدم، حالة كل ملف، والأخطاء.

المدخلات:batchId (مطلوب)

الحساب

1 أداة

whoamiread

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

المدخلات: لا شيء

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

بمجرد الاتصال، اسأل بلغة بسيطة. يختار العميل الأدوات الصحيحة.

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

تحذير

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

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

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

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

ما هي العملاء المدعومة؟

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

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

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

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

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

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

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

على أي منظمة يعمل؟

هذه المرتبطة برمزك. استدعِ whoami لتأكيد المستخدم، المنظمة، والنطاقات في أي وقت.

الأمان #

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

جزء من مركز Curriculo ATS MCP، الذي يربط دلائل الإعداد، ومرجع الأدوات ومستنَد موصلات.