إضافة solvethree MCP إلى VS Code

أنشئ .vscode/mcp.json أو حدّثه بالإعدادات أدناه. إذا كان الملف يتضمن خوادم أو مدخلات أخرى بالفعل، فادمج هذه الإدخالات بدلًا من استبدالها. يجب أن يتمكن VS Code من تشغيل npx محليًا.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

يشغّل الأمر solvethree-mcp من حزمة SDK الرسمية المُنزّلة. تزوّد مطالبتا كلمة المرور تلك العملية بـ SOLVETHREE_API_KEY وSOLVETHREE_PROXY. أدخل مفتاح API لمساحة عملك وعنوان URL لوكيل HTTP(S) في هاتين المطالبتين، لا في المحادثة أو في ملف إعدادات مُثبّت في نظام التحكم بالإصدارات. يجب ألا يتضمن عنوان URL للوكيل مسارًا أو استعلامًا أو جزءًا.

بنية الإعدادات موثّقة في مرجع إعداد MCP في VS Code. هذه عملية محلية، وليست نقطة نهاية MCP مستضافة.

بعد أن يشغّل VS Code الخادم، اطلب من الوكيل استدعاء solvethree_capabilities قبل طلب الحل. يتيح الخادم الأدوات التالية:

• solvethree_capabilities — فحص إمكانات الخدمة.
• solvethree_create_recaptcha — إنشاء مهمة reCAPTCHA.
• solvethree_create_kasada — إنشاء مهمة Kasada مستقلة؛ يقتصر الدعم الحالي على أهداف HTTPS على www.ticketmaster.com.
• solvethree_create_tmpt — إنشاء مهمة Ticketmaster TMPT لـ Event أو Login.
• solvethree_get_task — استرجاع حالة المهمة ونتيجتها.

إذا لم تكن هذه الأدوات متاحة، فتحقق أولًا من بدء العملية المحلية وتلقيها كلا متغيرَي البيئة. لن يؤدي تغيير الموقع المستهدف أو إنشاء مهمة أخرى إلى إصلاح مشكلة بدء تشغيل الخادم.

1. 1.

   فعّل ملف تعريف الموقع

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

2. 2.

   أنشئ مهمة واحدة

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

3. 3.

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

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

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

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

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

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