הוספת 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 פירושה שנוצר פתרון, לא שהאתר קיבל את בקשת היישום שלכם. אם היעד דוחה אותה, בדקו את הבקשה שנשלחה לפני שתשלמו על ניסיון פתרון נוסף.