Docker에서 solvethree MCP 서버 실행

다음을 Dockerfile로 저장하세요. Node 22에 공식 패키지를 설치하고 루트 권한이 없는 node 사용자로 전환한 뒤, solvethree-mcp를 컨테이너의 진입점으로 실행합니다. 빌드 및 실행 명령은 아래에 있습니다.

FROM node:22.23.4-alpine
RUN npm install --global https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
USER node
ENTRYPOINT ["solvethree-mcp"]

# Build: docker build -t solvethree-mcp-local .
# Forward variables already set in the host; do not add their values to this file.
# Run: docker run --rm -i -e SOLVETHREE_API_KEY -e SOLVETHREE_PROXY solvethree-mcp-local

실행하기 전에 Docker를 시작하는 환경에서 SOLVETHREE_API_KEY를 워크스페이스 API 키로, SOLVETHREE_PROXY를 사용할 프록시로 설정하세요. 각 -e NAME은 기존 변수를 전달할 뿐, 값을 제공하지는 않습니다. 자격 증명을 Dockerfile과 이미지에 포함하지 마세요.

이미지는 로컬에서 solvethree-mcp-local이라는 이름으로 빌드되며 Docker Hub 계정은 필요하지 않습니다. 이를 실행해도 호스팅된 MCP 엔드포인트가 생성되거나 브라우저 자동화가 추가되지는 않습니다.

MCP 호스트에 stdio 서버를 구성하세요. 명령에는 solvethree-mcp가 아닌 Docker를 사용하세요. 이미지의 진입점이 컨테이너 내부에서 실행 파일을 시작합니다.

-t를 추가하지 마세요. 호스트는 JSON-RPC 통신에 컨테이너의 stdin과 stdout을 사용해야 합니다. --rm은 컨테이너가 종료되면 해당 컨테이너를 제거합니다.

MCP 호스트 프로세스에서 두 환경 변수를 모두 사용할 수 있어야 합니다. 터미널에서 설정해도 다른 곳에서 실행된 호스트가 해당 변수를 상속받지 않으면 소용이 없습니다. 호스트가 환경 변수 전달을 제한한다면 두 변수 이름을 모두 허용하세요.

Codex 스타일의 TOML 구성에서는 mcp_servers.solvethree 테이블에 위 명령과 인수를 사용하세요. env_vars에 두 변수 이름을 모두 포함하고, startup_timeout_sec를 60으로, tool_timeout_sec를 100으로 설정하세요. 기반 서버 규약은 MCP 통합 문서를 참고하세요.

1. 1.

   사용 가능한 도구 확인

   연결 후 solvethree_capabilities를 호출하세요. 서버는 해결 도구와 작업 조회 기능을 제공하며, 브라우저를 제어하거나 양식을 채우지는 않습니다.

2. 2.

   reCAPTCHA 프로필 준비

   reCAPTCHA 해결을 요청하기 전에 사이트 프로필에서 활성 프로필을 설정하세요. 호스트명, 캡처 액션, reCAPTCHA 유형을 일치시키고, 도메인 프로필 하나가 모든 액션을 포괄한다고 가정하지 마세요. 작업을 전송해도 프로필이 생성되지는 않습니다. 이 사전 요구 사항은 프로필 설정 가이드에서 설명합니다.

3. 3.

   하나의 논리적 작업 생성

   site, action, requestId로 solvethree_create_recaptcha를 호출하세요. recaptchaType과 waitMs는 선택 사항입니다. 이 도구는 단일 프록시를 SOLVETHREE_PROXY에서 읽습니다. 각 생성 호출은 작업을 최대 하나만 만듭니다. 생성 중 시간 초과가 발생하면 다른 작업을 만들지 말고 동일한 요청 ID와 변경하지 않은 입력값을 재사용해 기존 작업을 복구하세요.

4. 4.

   사용 가능한 결과 대기

   작업이 pending 또는 solving이면 solvethree_get_task로 조회하세요. 사용 가능한 솔루션은 ready에만 포함됩니다. failed이면 폴링을 중단하고 errorCode와 error를 확인한 후 무엇을 변경할지 결정하세요.

5. 5.

   애플리케이션에서 제출

   reCAPTCHA의 경우 작업 ID가 아닌 solution.token을 제출하세요. 반환된 userAgent와 secChUa 식별 정보를 해결에 성공한 프록시와 함께 사용하세요. 작업이 준비되었다는 것은 솔루션이 생성되었다는 뜻이지, 대상이 애플리케이션 요청을 수락했다는 뜻은 아닙니다.

MCP 호스트는 비공개 솔루션 데이터를 받습니다. 해당 결과를 공유 로그에 포함하지 마세요. 의도한 대상에 결과를 제출하는 책임은 여전히 애플리케이션에 있습니다.