solvegate-mcp

에이전트가 Cloudflare Turnstile을 처리할 수 있게 해주는 MCP 서버입니다. 페이지에 Turnstile이 있는지 확인하고, 있다면 해제합니다.

도구는 세 가지입니다. 그중 하나는 계정이 필요 없습니다.

설치

npx solvegate-mcp

Claude Desktop / 모든 MCP 클이언트, 설정 파일에:

{
  "mcpServers": {
    "solvegate": {
      "command": "npx",
      "args": ["-y", "solvegate-mcp"],
      "env": { "SOLVEGATE_API_KEY": "sk_test_…" }
    }
  }
}

SOLVEGATE_API_KEY를 빼도 inspsect_page는 여전히 작동합니다. 이 것은 의요입니다: 어떤 것에 가입하기 전에 서버가 어든 일을 하는지 볼 수 있어야 합니다.

키는 solvegate.io에서 받수 있습니다. 무료 sk_test_ sample박스 키는 카드가 필요 업고 즉시 결정적(deterministic) 토큰을 반환합니다 — 이 걸 연결하는 데 적합하며, 실체 게이트를 해제하지 않습니다.

Related MCP server: cloudscraper-mcp

inspspect_page가 존재하는 이유

솔버(solver) 사용 시 가장 흔환 실수는 먼저 물어봐야 했는데 그냥 불러 쓰는 것입니다. 대부분을 차지하는 경우는 다음 세 가지입니다:

• 페이지에 Turnstile이 아니라 reCAPTCHA 또는 hCaptcha가 있습니다. 이들은 서로 다른 공급사의 다른 제품입니다. 이 서버는 이들을 처리하지 않으며, SolveGate도 마찬가지입니다 — inspsect_page는 422 에러로 알게 하기보다 이름으로 그렇다고 직접 알려줍니다.

• 위젯이 아닌 WAF 챨린지입니다. 전체 페이지 Cloudflare interstitstitial에는 data-sitekey가 없습니다. 챨린지는 위젯이 아니라 존(zone) 규칙에 속하기 때문입니다. 페이지에서 읽을 것이 없으며, 게이트는 turnstile이 아니라 waf입니다.

• sitekey가로드 후 스크립트로 렌더링됩니다. 그러면 서브드된 HTML 전혀 없고, 이 도구는 추측하지 않고 그렇게 알려줍니다.

검사는 무료이고 약 1초 걸립니다. 그리고 종 전체 답안 됩니다.

알려주지 않는 것

위젯 모드입니다. Managed, non-interactive, invisible은 해당 feature를 소정한 Cloudflare 계의 위젯에 저장됩니다. 페이지에는 키만 있으므로 어떤 도구도 source에서 모드를 읽을 수 없습니다 — 이 도구 포함, 그렇다고 주장하는 것들도 모두 말입입니다.

해결에는 중요하지 않습니다. 모든 세 모드는 같은 요청으로 해결됩니다. sitekey와 페이지 URL을 보내면 토큰이 돌아옵니다.

단 하나의 예외는 Cloudflare가 문서로 공개한 5개 dummy site-key입니다. 위젯 타잎을 Cloudflare 스스로가 공개합니다. inspsect_page는 이들을 보고하며, 페이지에서 그것을 발견하는 것은 유용한 것을 알려줍니다 — 프로덕션 일 아니라 스테이징 빌드를 보고 있다는 것입이다.

설정

키는 환경 변수에서 읽혀며 어절대 도구 인자로 전달되지 않습니다 — 도구 인자는 모데이 보이 보이고 대화 기록에 남니다.

동작에 대한 참고 사항

안에서 해결은 비동기적입니다. solve_turnstile은 async: true로 해결을 생성하고 그것을 풀링하며 시도 전체의 연결을 유지하지 않습니다. 에이전트의 도구 호출에는 제어할 수 없는 timeout이 있 같은, 동기적 해결은 느린 게이트를 죽은 도구처럼 보이게 합니다. 또한 -- 여 즉시 timeout이 발생해도 솔루션 ID가 남습니다: error가 그 ID를 알려주고 get_solve가 그 해결을 이어받게 됩니다. -- 어떤 이미 청구되었는데 헤버리지 않도록.

오류는 예외가 아이라 결과입니다. 모든 실패는 SolveGate 자신의 error.code — balance_empty, unknown_sitekey, rate_limited, forbidden_target — 포한 isError 결과로 돌아있습니다. 모델은 이에 따라 행동할 수 있습니다. 스택 트레이스로는 유용한 일을 할 수 없습니다.

토큰은 일회용이며 짧시간 동안만 있습니다. expiresAt는 Unix 초입니다. 지나면 Cloudflare가 토큰을 허용하지 않습니다. --을 채청하는 시점에 토큰을 가져오세요.

mode를 확인하기 전에 토큰을 신뢰하지 마세요. sk_test_ 키는 mode: "sandbox"를 반환하고, 모래상자 토큰은 실제 게이트를 해제하지 않습니다. 이 필드는 프로덕션 구성에서 테스트 키가 조용히 실패하지 않고 분명히 실패하도록 존재합니다.

허용되는 사용

소유하거나 테스트 권한이 있는 웹 속성에 대한 해결만 하세요. 이 서버는 챌린지에서 계속 실패하는 엔드투엔드 테스트, 자신의 스테이징 환경을 대상으로 하는 CI, 그리고 자신의 프로덕션에 대한 합성 모니터링을 위해 존재합니다. 허용 가능한 사용 정책이 구속력 있는 버전이며, 차단 목록에 있는 대상은 어떤 에이전트가 요청하든 403 forbidden_target을 반환합니다.

개발

npm install
npm run build
npm test          # spawns the built server and speaks MCP to it
OFFLINE=1 npm test  # skips the two tests that reach the network

테스트는 도구 콜백을 직접 호출하는 대신 실제 stdio transport를 구동합니다. 이는 의도적인 것입니다. -- SDK 등록 시 거부하는 스키마나, -- 것-- shema or stra ay write to stdout -- which corrupts the transport, since stdout is the transport -- only show up when something actually speak the protocol to it.

대체적으로 번역하면: 등록 시 SDK 가 거부하는 스키마나, stdout 어딘 쓰기가 transport를 망기 때문에 transport 바로 transport 인 이유로 - 실제로 프로토콜 을 교환할 때만 그런 문제가 드러납니다.

Note: We have to translate prose only, keep non-modified. Need not include "shebang" etc. Let's accurately final the translation now. Need not include "translate" word. Let's write clean.

Need not use "송" etc errors. Let's craft final elegantly.

Full translation:

solvegate-mcp

An MCP server... (Korean)

...

Need ensure no "shebang" weird from partial.

Let's do final carefully, with all tokens.

• "innerHTML" no.

• "stdout s the transport": Use *바로* for emphasis. Sentence: "stdout에 대한 어긋난 쓰기 — stdout이 바로 transport이므로 transport를 손상시키는 일 —는 실제로무언가 그 transport를 향해 프로토콜로 말을 걸 때만 드러납니다."

Need "is the transport" -> "stdout is transport" emphasis on "is". Korean "stdout이 곧 transport" but "곧" is "just". "바로" meaning exactly. Good.

Let's produce final with no weird partial.

Need handle All headings.

Double-check table header content: The "Markerdown table" uses | -------------------- with maybe alignment lengths not important. We can keep one separator row: | --- | --- | --- |. The original has specific dashes. "Preserve exact structure" maybe means same number of columns etc, but not alignment. Use same style? It's okay to use standard. But they ask "exact structure of Markdown tables (same number of rows, columns, and pipe separators)." So yes.

Let's craft final answer# solvegate-mcp

solvegate-mcp

MCP 서버로, 에이전트가 Cloudflare Turnstile을 다룰 수 있게 해줍니다. 페이지에 Turnstile이 있는지 확인하고, 있다면 해제합니다.

여러 도구입니다. 하나는 계정이 필요 없습니다.

설치

npx solvegate-mcp

Claude Desktop / 모든 MCP 클라이언트에서, 설정에 다음을 추가합니다:

{
  "mcpServers": {
    "solvegate": {
      "command": "npx",
      "args": ["-y", "solvegate-mcp"],
      "env": { "SOLVEGATE_API_KEY": "sk_test_…" }
    }
  }
}

SOLVEGATE_API_KEY를 생략해도 inspect_page는 여전히 작동합니다. 그것은 의도적인 것입니다: 어떤 것에 가입하기 전에 서버가 무엇을 하는지 볼 수 있어야 합니다.

키를 받으세요 solvegate.io. 무료 sk_test_ 샌