Cursor에 solvethree MCP 추가

1. 1.

   환경 변수 설정

   SOLVETHREE_API_KEY를 워크스페이스 API 키로, SOLVETHREE_PROXY를 해결 및 제출에 사용할 프록시로 설정하세요. Cursor를 실행하는 프로세스에서 두 변수에 모두 접근할 수 있어야 합니다. 프로젝트 설정에 인증 정보 값을 직접 넣지 마세요.

2. 2.

   설정 파일 선택

   프로젝트별 설정에는 .cursor/mcp.json을, 사용자 전체 설정에는 ~/.cursor/mcp.json을 사용하세요. 이름이 solvethree인 프로젝트 항목은 같은 이름의 전역 항목보다 우선합니다.

3. 3.

   서버 항목 추가

   아래 설정을 사용하세요. 파일에 이미 다른 서버가 있다면 파일을 교체하지 말고 기존 mcpServers 객체 안에 solvethree를 추가하세요.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

이 설정은 npx를 사용해 공식 SDK 다운로드의 solvethree-mcp를 실행합니다. 설정은 Cursor의 환경을 상속하며, JSON 내부의 환경 변수 보간에 의존하지 않습니다.

Cursor를 완전히 종료한 다음 두 변수가 모두 있는 환경에서 다시 실행하세요. 터미널에서 변수를 내보내도 이미 실행 중인 GUI에는 반영되지 않습니다.

Cursor의 MCP 도구와 MCP Logs 출력을 확인하세요. 서버는 solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt, solvethree_get_task를 제공합니다. 먼저 solvethree_capabilities를 호출해 사용 가능한 작업을 확인하세요.

서버가 시작되지 않습니다.

MCP Logs에서 시작 오류를 확인하세요.

다음을 시도해 보세요: Cursor가 npx를 찾지 못하면 Cursor의 PATH에서 사용할 수 있도록 설정한 뒤 Cursor를 재시작하세요.

서버가 환경 변수 누락을 보고합니다.

현재 터미널뿐 아니라 실제로 Cursor를 실행한 환경을 확인하세요.

다음을 시도해 보세요: 해당 환경에 두 변수를 모두 설정하고 Cursor를 완전히 종료한 뒤 다시 실행하세요.

Cursor가 예상과 다른 설정을 사용합니다.

두 설정 파일 모두에서 solvethree 항목을 찾아보세요.

다음을 시도해 보세요: 전역 항목을 사용하려던 경우 프로젝트 항목을 수정하거나 삭제하세요.

Cursor의 설정 인터페이스는 공식 MCP 문서를 참고하세요.

1. 1.

   사이트 프로필 활성 상태 확인

   사이트 프로필에서 사용할 호스트 이름, 캡처 액션, reCAPTCHA 유형을 설정하세요. 해결을 요청하기 전에 프로필이 활성 상태인지 확인하세요. 도구에 호스트 이름과 액션을 전달해도 프로필은 생성되지 않습니다. 캡처 과정은 사이트 프로필 설정을 참고하세요.

2. 2.

   reCAPTCHA 도구 호출

   Cursor가 site, action, 고유한 requestId로 solvethree_create_recaptcha를 호출하도록 하세요. site는 페이지 URL이 아닌 호스트 이름입니다. recaptchaType의 기본값은 enterprise-v3이며, waitMs는 선택 사항입니다. 도구는 SOLVETHREE_PROXY에서 단일 프록시를 읽으므로 프록시 인수, type, url을 추가하지 마세요.

3. 3.

   최종 상태까지 작업 확인

   작업이 pending 또는 solving 상태이면 solvethree_get_task로 다시 확인하세요. 사용할 수 있는 솔루션은 ready 상태에만 포함됩니다. failed 상태이면 폴링을 중단하고 errorCode와 error를 확인한 뒤 변경할 사항을 결정하세요.

생성 요청이 시간 초과되면 requestId를 유지하세요. 각 생성 호출은 최대 하나의 작업을 만들며, 동일한 요청 ID와 동일한 입력으로 반복하면 기존 작업을 복구합니다. 해당 ID를 재사용하면서 입력을 변경하면 충돌이 발생합니다. 첫 응답이 유실되었다는 이유만으로 새 ID를 생성하지 마세요.

작업이 준비되면 MCP 서버의 역할은 끝납니다. 반환된 reCAPTCHA 토큰은 애플리케이션에서 의도한 대상에 제출해야 합니다. 반환된 userAgent와 secChUa 식별 정보를 해결에 설정된 프록시와 함께 사용하세요. 프록시를 바꾸거나 관련 없는 브라우저 식별 정보를 섞으면 요청이 실패할 수 있습니다.

다른 도구를 사용할 때는 솔루션 유형을 구분하세요. Kasada는 함께 적용해야 하는 헤더 객체를 반환하고, TMPT는 원시 tmpt 쿠키 값을 반환합니다. 둘 다 reCAPTCHA 토큰이 아닙니다.

Cursor는 도구 응답을 통해 비공개 솔루션 데이터를 받습니다. ready 결과는 솔루션이 생성되었다는 뜻이지, 대상이 애플리케이션의 요청을 수락했다는 뜻은 아닙니다. 제출에 실패하면 다른 해결 요청에 비용을 지불하기 전에 전송한 토큰 또는 쿠키, 식별 정보, 프록시를 확인하세요.