Codex에 solvethree MCP 추가

1. 1.

   Node.js 22 및 npx 사용 준비

   Codex를 실행하는 프로세스에서 이들을 사용할 수 있어야 합니다. Codex가 접근할 수 없는 별도 환경에 설치하면 서버를 시작할 수 없습니다.

2. 2.

   호스트 환경 변수 설정

   SOLVETHREE_API_KEY를 워크스페이스 API 키로, SOLVETHREE_PROXY를 프록시 URL로 설정하세요. 해당 변수를 사용할 수 있는 상태에서 Codex를 시작하세요. IDE 통합을 사용하는 경우 IDE 프로세스도 해당 변수를 상속하는지 확인하세요. API 키를 프롬프트나 소스 관리에 포함하지 마세요.

3. 3.

   reCAPTCHA 사이트 프로필 활성화

   사이트 프로필에서 HTTPS 페이지 URL을 추가하고, reCAPTCHA 유형을 선택한 뒤, 캡처 액션을 입력하세요. 프로필이 활성화될 때까지 기다리세요. 필요한 호스트 이름, 캡처 액션, 유형을 설정하세요. 작업의 사이트와 액션은 프로필을 생성하지 않습니다. 첫 대상이라면 사이트 프로필 설정을 참고하세요.

Codex CLI와 IDE는 ~/.codex/config.toml을 공유합니다. 신뢰할 수 있는 프로젝트의 .codex/config.toml을 사용할 수도 있습니다. 다음 서버 항목을 추가하세요.

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

이 항목은 npx를 통해 공식 SDK의 solvethree-mcp 실행 파일을 실행합니다. env_vars는 기존 호스트 변수를 전달하며, 값을 할당하지는 않습니다. 이 로컬 서버에는 입력할 호스팅 MCP 엔드포인트도, OAuth 로그인도 없습니다.

startup_timeout_sec는 서버 시작에 60초를 허용합니다. tool_timeout_sec는 도구 호출에 100초를 허용합니다. 어느 설정도 대상 웹사이트가 솔루션을 수락했다는 뜻은 아닙니다.

codex mcp list를 실행하거나 Codex TUI에서 /mcp를 열어 구성된 서버를 확인하세요. 서버가 시작되지 않으면 Codex가 npx를 찾을 수 있고 두 환경 변수를 모두 상속받았는지 확인하세요.

1. 1.

   지원 기능 확인

   해결 도구를 선택하기 전에 Codex가 solvethree_capabilities를 호출하도록 하세요. reCAPTCHA에는 solvethree_create_recaptcha를 사용하세요.

2. 2.

   reCAPTCHA 입력값 제공

   site에는 호스트명을 지정하고, action과 requestId를 제공하세요. 이 도구는 선택 항목인 recaptchaType과 waitMs도 받으며, 기본 유형은 enterprise-v3입니다. 단일 프록시를 SOLVETHREE_PROXY에서 읽으므로 이를 호출별 프록시 설정으로 취급하지 마세요. reCAPTCHA 요청에 type이나 url 필드를 추가하지 마세요.

3. 3.

   작업 ID 보관 및 상태 확인

   각 생성 호출은 작업을 최대 하나만 만듭니다. 반환된 ID로 solvethree_get_task를 호출해 해당 작업을 조회하세요. 상태가 pending 또는 solving인 동안 계속 확인하세요. 사용 가능한 솔루션은 ready에만 포함됩니다. failed가 되면 폴링을 중단하고 errorCode와 error를 확인한 후 무엇을 변경할지 결정하세요.

MCP 서버는 브라우저를 제어하거나 현재 세션을 확인하거나 양식을 채우지 않습니다. 애플리케이션이 준비된 reCAPTCHA 결과를 받아 의도한 대상에 solution.token을 제출해야 합니다.

반환된 userAgent와 secChUa 브라우저 식별 정보를 해결에 사용한 것과 동일한 프록시와 함께 사용하세요. 브라우저나 HTTP 클라이언트가 다른 프록시 또는 관련 없는 브라우저 식별 정보를 사용한다면 제출 전에 수정하세요. MCP 서버를 추가해도 이러한 설정이 자동으로 구성되지는 않습니다.

Codex는 도구 응답을 통해 비공개 솔루션 데이터를 받으므로 공유 보고서와 로그에 포함하지 마세요. 작업이 ready라는 것은 솔루션이 생성되었다는 뜻입니다. 대상이 애플리케이션 요청을 수락했는지는 대상의 응답을 별도로 확인하세요.