Claude Desktop에 solvethree MCP 추가

Claude Desktop을 실행하는 컴퓨터에 Node.js 22를 설치하세요. 워크스페이스 API 키와 HTTP 또는 HTTPS 프록시 URL을 준비하세요. 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는 임의의 웹사이트가 아니라 www.ticketmaster.com의 HTTPS 대상만 지원합니다.
• solvethree_create_tmpt는 TMPT 작업을 생성합니다. Event 작업은 이벤트 URL을 사용하고, Login 작업은 로그인 진입 URL을 사용합니다.

합의한 대상과 액션에 대해 작업 하나를 생성하도록 Claude에 명시적으로 허용하세요. 실패나 대상의 거부 후 대체 작업을 생성하는 경우를 포함해, 다른 유료 작업을 시작하기 전에는 새로 승인을 받도록 하세요. 작업을 조회하거나 폴링할 권한을 다른 작업을 생성할 권한으로 간주해서는 안 됩니다.

모든 생성 도구에는 requestId가 필요하며, 최대 하나의 작업만 생성합니다. 해당 ID를 원래 입력과 함께 보관하세요. 생성 중 시간 초과가 발생하면 동일한 ID로 동일한 요청을 반복하여 작업을 복구하거나, 작업 ID를 이미 알고 있다면 해당 작업을 조회하세요. 시간 초과가 발생했다고 해서 생성이 실패한 것은 아닙니다. ID를 재사용하면서 입력을 바꾸면 충돌이 발생하며, 새 ID를 사용하면 다른 작업이 생성될 수 있습니다.

pending 또는 solving 상태이면 기존 작업을 계속 조회하세요. 사용할 수 있는 솔루션은 ready 상태에만 포함됩니다. failed 상태이면 폴링을 중단하고 errorCode와 error를 확인하세요. 실패한 해결 요청은 환불됩니다. 동일한 잘못된 입력을 자동으로 다시 제출하지 마세요.

Claude는 MCP 호스트를 통해 비공개 솔루션 데이터를 받습니다. 애플리케이션에서 해결에 성공한 프록시와 반환된 userAgent, secChUa를 사용해 결과를 의도한 대상에 적용하세요. 설정된 프록시로 해결한 뒤 다른 IP나 관련 없는 브라우저 식별 정보로 제출하지 마세요.

ready 작업은 솔루션이 생성되었다는 뜻이지, 웹사이트가 후속 요청을 수락했다는 뜻은 아닙니다. 대상이 요청을 거부하면 다른 해결 요청을 승인하기 전에 전송한 토큰, 쿠키 또는 헤더, 프록시, 브라우저 식별 정보, 대상 URL을 확인하세요.