VS Code에 solvethree MCP 추가

아래 설정으로 .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}"
      }
    }
  }
}

이 명령은 공식 SDK 다운로드의 solvethree-mcp를 실행합니다. 두 비밀번호 입력 프롬프트는 해당 프로세스에 SOLVETHREE_API_KEY와 SOLVETHREE_PROXY를 제공합니다. 워크스페이스 API 키와 HTTP(S) 프록시 URL은 채팅이나 커밋되는 설정 파일이 아니라 해당 프롬프트에 입력하세요. 프록시 URL에는 경로, 쿼리 또는 프래그먼트가 포함되어서는 안 됩니다.

설정 구조는 VS Code MCP 설정 참조에 문서화되어 있습니다. 이는 호스팅 MCP 엔드포인트가 아닌 로컬 프로세스입니다.

VS Code가 서버를 시작하면 해결을 요청하기 전에 에이전트에 solvethree_capabilities를 호출하도록 요청하세요. 서버는 다음 도구를 제공합니다.

• solvethree_capabilities — 서비스의 기능을 확인합니다.
• solvethree_create_recaptcha — reCAPTCHA 작업을 생성합니다.
• solvethree_create_kasada — 독립형 Kasada 작업을 생성합니다. 현재는 www.ticketmaster.com의 HTTPS 대상만 지원합니다.
• solvethree_create_tmpt — Event 또는 Login용 Ticketmaster TMPT 작업을 생성합니다.
• solvethree_get_task — 작업의 상태와 결과를 조회합니다.

해당 도구를 사용할 수 없다면 먼저 로컬 프로세스가 시작되고 두 환경 변수를 모두 받는지 확인하세요. 대상 사이트를 바꾸거나 다른 작업을 생성해도 서버 시작 문제는 해결되지 않습니다.

1. 1.

   사이트 프로필 활성화

   사이트 프로필에서 올바른 호스트 이름, 캡처 액션, reCAPTCHA 유형으로 대상을 설정하세요. 해결하기 전에 워크스페이스에서 활성 프로필을 사용할 수 있어야 합니다. 도구에 호스트 이름과 액션을 제공해도 프로필은 생성되지 않습니다. 새 대상이라면 사이트 프로필 설정을 참고하세요.

2. 2.

   작업 하나 생성

   에이전트에 site를 호스트 이름으로 지정하고, 필요한 action과 이번 논리적 해결 요청에 대한 고유한 requestId를 사용해 solvethree_create_recaptcha를 호출하도록 요청하세요. 이 도구는 선택 항목인 recaptchaType과 waitMs도 받으며, 유형의 기본값은 enterprise-v3입니다. 도구는 SOLVETHREE_PROXY에서 단일 프록시를 읽으므로 이 도구 호출에 프록시 후보 목록, type, url을 추가하지 마세요.

3. 3.

   최종 상태까지 작업 확인

   각 생성 호출은 최대 하나의 작업을 만듭니다. 상태가 pending 또는 solving이면 solvethree_get_task로 다시 조회하세요. 사용할 수 있는 솔루션은 ready 상태에만 포함됩니다. failed 상태이면 폴링을 중단하고 errorCode와 error를 확인하세요. 실패한 해결 요청은 환불됩니다. 잘못된 입력을 변경하지 않은 채 재시도하지 마세요.

생성 요청이 시간 초과되면 requestId를 유지하세요. 이 값은 ASCII 문자, 숫자, 밑줄 또는 하이픈으로 구성된 1–64자여야 합니다. 동일한 ID로 동일한 작업 요청을 반복하면 기존 작업을 반환하며, 해당 ID를 재사용하면서 입력을 변경하면 충돌이 발생합니다. 새로운 논리적 해결 요청을 하기 전에 기존 작업을 복구하세요.

reCAPTCHA의 경우 작업 ID가 아닌 solution.token을 의도한 대상에 제출하세요. 반환된 userAgent와 secChUa를 해결에 사용한 것과 동일한 프록시와 함께 사용하세요. IP를 바꾸거나 관련 없는 브라우저 헤더를 섞으면 제출이 실패할 수 있습니다.

다른 도구는 서로 다른 데이터를 반환합니다. Kasada는 함께 적용해야 하는 헤더 객체를 반환하고, TMPT는 원시 tmpt 쿠키 값을 반환합니다. 각 결과는 해당 브라우저 식별 정보, 프록시, 대상과 함께 유지하세요.

MCP 호스트는 비공개 솔루션 데이터를 받지만 대신 제출하지는 않습니다. ready 작업은 솔루션이 생성되었다는 뜻이지, 웹사이트가 애플리케이션 요청을 수락했다는 뜻은 아닙니다. 대상이 요청을 거부하면 다른 해결 요청에 비용을 지불하기 전에 해당 발신 요청을 확인하세요.