solvethree MCP'yi Claude Desktop'a ekleyin

Claude Desktop'ın çalıştığı makineye Node.js 22 yükleyin. Çalışma alanınızın API anahtarını ve bir HTTP veya HTTPS proxy URL'sini hazır bulundurun. MCP sunucusu, SOLVETHREE_PROXY üzerinden sağlanan tek bir proxy kullanır; reCAPTCHA aracı proxy bağımsız değişkeni kabul etmez.

reCAPTCHA için önce Site profilleri sayfasında etkin bir profil oluşturun. İhtiyacınız olan hedef ana makine adını, yakalama eylemini ve reCAPTCHA türünü yapılandırın. Claude'a ana makine adı ve eylem vermek bu profili oluşturmaz. Henüz etkin değilse site profili kurulumu bölümüne bakın.

1. 1.

   Yerel yapılandırma dosyasını açın

   macOS'te ~/Library/Application Support/Claude/claude_desktop_config.json yolunu kullanın. Windows'ta %APPDATA%/Claude/claude_desktop_config.json yolunu kullanın.

2. 2.

   solvethree sunucusunu ekleyin

   Aşağıdaki yapılandırmayı kullanın. Dosya zaten mcpServers içeriyorsa diğer sunucularınızı değiştirmek yerine solvethree girdisini bunun içine ekleyin. Her iki ortam değişkeni yer tutucusunu da gizliliği koruyarak değiştirin.

3. 3.

   Claude Desktop'ı yeniden başlatın

   Ana uygulamanın sunucuyu yeni yapılandırmayla başlatması için kaydettikten sonra yeniden başlatın.

{
  "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, resmi SDK arşivini indirir ve içindeki solvethree-mcp yürütülebilir dosyasını yerel bir stdio sunucusu olarak başlatır. Girilecek barındırılan bir MCP uç noktası yoktur.

solvethree_capabilities ile başlayın. Mevcut bir görevi almak için solvethree_get_task kullanın. Bu işlemlerin hiçbiri yeni bir çözüm oluşturma isteği değildir.

• solvethree_create_recaptcha, ana makine adı olarak site, action ve requestId ile isteğe bağlı recaptchaType ve waitMs değerlerini kabul eder. Varsayılan tür enterprise-v3 değeridir; v3 de kabul edilir.
• solvethree_create_kasada bir Kasada görevi oluşturur. Bağımsız Kasada şu anda rastgele web sitelerini değil, www.ticketmaster.com üzerindeki HTTPS hedeflerini destekler.
• solvethree_create_tmpt bir TMPT görevi oluşturur. Etkinlik görevleri etkinlik URL'sini; oturum açma görevleri ise oturum açma giriş URL'sini kullanır.

Claude'a üzerinde anlaşılan hedef ve eylem için tek bir görev oluşturma iznini açıkça verin. Başarısızlık veya hedefin reddi sonrasında oluşturulacak ikame görevler dahil, başka bir ücretli göreve başlamadan önce yeniden onay alınmasını zorunlu tutun. Bir görevi inceleme veya durumunu sorgulama izni, başka bir görev oluşturma izni olarak değerlendirilmemelidir.

Her oluşturma aracı requestId gerektirir ve en fazla bir görev oluşturur. Bu kimliği orijinal girdilerle birlikte saklayın. Oluşturma zaman aşımına uğrarsa aynı isteği aynı kimlikle tekrarlayarak görevi kurtarın veya görev kimliğiniz zaten varsa görevi alın. Zaman aşımı, oluşturmanın başarısız olduğunu kanıtlamaz. Aynı kimliği yeniden kullanırken girdileri değiştirmek çakışmaya neden olur; yeni bir kimlik kullanmak başka bir görev oluşturabilir.

pending veya solving durumunda mevcut görevi sorgulamaya devam edin. Yalnızca ready kullanılabilir bir çözüm içerir. failed durumunda sorgulamayı durdurup errorCode ve error alanlarını inceleyin; başarısız çözümlerin ücreti iade edilir. Aynı geçersiz girdileri otomatik olarak yeniden göndermeyin.

Claude, özel çözüm verilerini MCP ana uygulaması üzerinden alır. Uygulamanızın sonucu, başarılı proxy ve döndürülen userAgent ile secChUa değerlerini kullanarak amaçlanan hedefte kullanmasını sağlayın. Yapılandırılmış proxy üzerinden çözüm alıp ardından farklı bir IP veya ilgisiz bir tarayıcı kimliği üzerinden gönderim yapmayın.

ready durumundaki bir görev, çözümün üretildiği anlamına gelir; web sitesinin sonraki isteğinizi kabul ettiği anlamına gelmez. Hedef çözümü reddederse yeni bir çözüme onay vermeden önce gönderilen token'ı, çerezi veya üstbilgileri, proxy'yi, tarayıcı kimliğini ve hedef URL'yi inceleyin.