إضافة solvethree MCP إلى Cursor

1. 1.

   تعيين متغيرات البيئة

   اضبط SOLVETHREE_API_KEY على مفتاح API لمساحة عملك، وSOLVETHREE_PROXY على الوكيل الذي ستستخدمه للحل والإرسال. أتح كليهما للعملية التي تشغّل Cursor. لا تضع بيانات الاعتماد بقيمها الصريحة في إعدادات المشروع.

2. 2.

   اختر ملف الإعدادات

   استخدم .cursor/mcp.json لإعداد خاص بالمشروع أو ~/.cursor/mcp.json لإعداد يسري على مستوى المستخدم. يتجاوز إدخال المشروع المسمّى solvethree أي إدخال عام بالاسم نفسه.

3. 3.

   أضف إدخال الخادم

   استخدم الإعدادات أدناه. إذا كان الملف يتضمن خوادم أخرى بالفعل، فأضف solvethree داخل كائن mcpServers الحالي بدلًا من استبدال الملف.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

يشغّل هذا solvethree-mcp من حزمة SDK الرسمية المُنزّلة باستخدام npx. ترث هذه الإعدادات بيئة Cursor؛ ولا تعتمد على استيفاء متغيرات البيئة داخل JSON.

أغلق Cursor تمامًا، ثم أعد تشغيله من بيئة تتضمن كلا المتغيرين. تصدير المتغيرات في الطرفية لا يحدّث واجهة رسومية قيد التشغيل بالفعل.

افحص أدوات MCP في Cursor ومخرجات سجلات MCP. يتيح الخادم solvethree_capabilities وsolvethree_create_recaptcha وsolvethree_create_kasada وsolvethree_create_tmpt وsolvethree_get_task. استدعِ solvethree_capabilities أولًا لفحص العمليات المتاحة.

الخادم لا يبدأ التشغيل.

راجع سجلات MCP لمعرفة خطأ بدء التشغيل.

جرّب هذا: إذا تعذّر على Cursor العثور على npx، فأتحه ضمن PATH الخاص بـ Cursor وأعد تشغيل Cursor.

يبلغ الخادم عن متغيرات بيئة مفقودة.

تحقق من البيئة التي شغّلت Cursor فعليًا، لا من الطرفية الحالية فحسب.

جرّب هذا: اضبط كلا المتغيرين في تلك البيئة، ثم أغلق Cursor تمامًا وأعد تشغيله.

يستخدم Cursor إعدادات غير متوقعة.

ابحث عن إدخال solvethree في كلا ملفَي الإعدادات.

جرّب هذا: حدّث إدخال المشروع أو احذفه إذا كنت تقصد استخدام الإدخال العام.

للتعرف على واجهة إعداد Cursor، راجع وثائق MCP الرسمية.

1. 1.

   تأكد من أن ملف تعريف الموقع نشط

   في ملفات تعريف المواقع، أعدّ اسم المضيف المقصود وإجراء الالتقاط ونوع reCAPTCHA. تأكد من أن ملف التعريف نشط قبل طلب الحل. تمرير اسم مضيف وإجراء إلى الأداة لا ينشئ ملف تعريف. راجع إعداد ملف تعريف الموقع للتعرف على عملية الالتقاط.

2. 2.

   استدعِ أداة reCAPTCHA

   اجعل Cursor يستدعي solvethree_create_recaptcha مع site وaction وقيمة requestId فريدة. يشير site إلى اسم المضيف، وليس عنوان URL لصفحة. القيمة الافتراضية لـ recaptchaType هي enterprise-v3؛ أما waitMs فهو اختياري. تقرأ الأداة وكيلها الوحيد من SOLVETHREE_PROXY، لذا لا تُضف وسيطة للوكيل أو type أو url.

3. 3.

   تابع المهمة حتى تصل إلى حالة نهائية

   إذا كانت المهمة بحالة pending أو solving، فاستخدم solvethree_get_task للتحقق منها مجددًا. وحدها حالة ready تتضمن حلًا قابلًا للاستخدام. إذا كانت بحالة failed، فأوقف الاستعلام الدوري وافحص errorCode وerror قبل تحديد ما يجب تغييره.

احتفظ بـ requestId إذا انتهت مهلة الإنشاء. ينشئ كل استدعاء إنشاء مهمة واحدة على الأكثر، ويؤدي تكرار معرّف الطلب نفسه مع المدخلات نفسها إلى استرجاع المهمة الحالية. يؤدي تغيير المدخلات مع إعادة استخدام ذلك المعرّف إلى تعارض. لا تنشئ معرّفًا جديدًا لمجرد فقدان الاستجابة الأولى.

ينتهي عمل خادم MCP عندما تصبح المهمة جاهزة. يجب أن يرسل تطبيقك رمز reCAPTCHA المُعاد إلى الهدف المقصود. استخدم هوية userAgent وsecChUa المُعادة مع الوكيل نفسه المُعدّ للحل. قد يؤدي تبديل الوكلاء أو مزج هوية متصفح غير مرتبطة بالحل إلى فشل الطلب.

ميّز بين أنواع الحلول عند استخدام الأدوات الأخرى: يعيد Kasada كائن ترويسات يجب تطبيقها معًا، بينما يعيد TMPT القيمة الخام لملف تعريف الارتباط tmpt. ولا يُعد أيٌّ منهما رمز reCAPTCHA.

يتلقى Cursor بيانات الحل الخاصة عبر استجابة الأداة. تعني نتيجة ready أنه تم إنشاء حل، لا أن الهدف قبل طلب تطبيقك. إذا فشل الإرسال، فافحص الرمز أو ملف تعريف الارتباط الصادر، والهوية، والوكيل قبل الدفع مقابل عملية حل أخرى.