הוספת solvethree MCP ל-Claude Desktop

התקינו Node.js 22 במחשב שבו פועל Claude Desktop. הכינו את מפתח ה-API של סביבת העבודה וכתובת URL של פרוקסי HTTP או HTTPS. שרת ה-MCP משתמש בפרוקסי אחד שמסופק דרך SOLVETHREE_PROXY; כלי ה-reCAPTCHA אינו מקבל ארגומנט פרוקסי.

עבור reCAPTCHA, צרו תחילה פרופיל פעיל בפרופילי האתרים. הגדירו את שם המארח של היעד, פעולת הלכידה וסוג ה-reCAPTCHA הדרושים. מסירת שם מארח ופעולה ל-Claude אינה יוצרת את הפרופיל הזה. עיינו בהגדרת פרופיל אתר אם הוא עדיין אינו פעיל.

1. 1.

   פתיחת קובץ ההגדרות המקומי

   ב-macOS, השתמשו ב-~/Library/Application Support/Claude/claude_desktop_config.json. ב-Windows, השתמשו ב-%APPDATA%/Claude/claude_desktop_config.json.

2. 2.

   הוספת שרת solvethree

   השתמשו בהגדרות שלהלן. אם הקובץ כבר מכיל mcpServers, הוסיפו את הרשומה solvethree בתוכו במקום להחליף את השרתים האחרים שלכם. החליפו את שני מצייני המיקום של משתני הסביבה באופן פרטי.

3. 3.

   הפעלה מחדש של Claude Desktop

   הפעילו מחדש לאחר השמירה כדי שהיישום המארח יפעיל את השרת עם ההגדרות החדשות.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
      }
    }
  }
}

ה-args מורידים את ארכיון ה-SDK הרשמי ומפעילים את קובץ ההפעלה שלו, solvethree-mcp, כשרת stdio מקומי. אין נקודת קצה מתארחת של MCP שיש להזין.

התחילו ב-solvethree_capabilities. השתמשו ב-solvethree_get_task כדי לאחזר משימה קיימת. אף אחת מהפעולות אינה בקשה ליצירת פתרון חדש.

• solvethree_create_recaptcha מקבל site כשם מארח, action ו-requestId, עם recaptchaType ו-waitMs אופציונליים. סוג ברירת המחדל הוא enterprise-v3; גם v3 מתקבל.
• solvethree_create_kasada יוצר משימת Kasada. Kasada עצמאי תומך כרגע ביעדי HTTPS ב-www.ticketmaster.com, ולא באתרים שרירותיים.
• solvethree_create_tmpt יוצר משימת TMPT. משימות אירוע משתמשות בכתובת ה-URL של האירוע; משימות התחברות משתמשות בכתובת ה-URL של נקודת הכניסה להתחברות.

תנו ל-Claude הרשאה מפורשת ליצור משימה אחת עבור היעד והפעולה שסוכמו. דרשו אישור חדש לפני שיתחיל משימה נוספת בתשלום, כולל משימה חלופית לאחר כישלון או דחייה מצד היעד. אין לראות בהרשאה לבדוק משימה או לתשאל את מצבה הרשאה ליצור משימה נוספת.

כל כלי יצירה מחייב requestId ויוצר לכל היותר משימה אחת. שמרו את המזהה הזה יחד עם הקלט המקורי. אם היצירה חורגת מזמן ההמתנה, שחזרו את המשימה על ידי שליחת אותה בקשה שוב עם אותו מזהה, או אחזרו אותה אם מזהה המשימה כבר בידיכם. חריגה מזמן ההמתנה אינה מוכיחה שהיצירה נכשלה. שינוי הקלט תוך שימוש חוזר במזהה יוצר התנגשות; שימוש במזהה חדש עשוי ליצור משימה נוספת.

במצב pending או solving, המשיכו לאחזר את המשימה הקיימת. רק ready מכיל פתרון שמיש. במצב failed, הפסיקו את התשאול ובדקו את errorCode ואת error; על פתרונות שנכשלו ניתן החזר כספי. אל תשלחו שוב אוטומטית את אותם נתוני קלט לא תקינים.

Claude מקבל נתוני פתרון פרטיים דרך מארח ה-MCP. על היישום שלכם להשתמש בתוצאה עבור היעד המיועד לה, עם הפרוקסי שבו הפתרון הצליח ועם userAgent ו-secChUa שהוחזרו. אל תפתרו דרך הפרוקסי שהוגדר ואז תשלחו דרך כתובת IP אחרת או עם זהות דפדפן לא קשורה.

משימה במצב ready פירושה שנוצר פתרון, לא שהאתר קיבל את הבקשה ששלחתם לאחר מכן. אם היעד דוחה אותה, בדקו את הטוקן, העוגייה או הכותרות שנשלחו, את הפרוקסי, את זהות הדפדפן ואת כתובת ה-URL של היעד לפני שתאשרו ניסיון פתרון נוסף.