NEX CAPTCHA / MCP

讓 AI 助手接入驗證碼服務

透過託管 MCP 連接你的 AI 工具。使用現有 API Key，查閱產品、建立驗證碼任務並取得結果，無需部署本機服務。

連接 MCP 登入取得 API Key

選擇接入流程

優先使用與實際挑戰匹配的原生驗證碼產品，不預設使用通用 GRID。先確認產品及版本並讀取模型和指引；目標允許時選 HTTP_SUBMIT，否則在瀏覽器支援回填原生結果時選 BROWSER_RESULT。頁面出現圖片網格不代表產品就是 GRID。取得真實參數；缺少參數時回報阻塞，不能猜測。
按目標整合使用原生結果：回填規定的 Token 回應欄位或回呼；產品回傳挑戰標識與證明或答案欄位時，按契約成組替換或提交。保持目標會話及綁定條件，不混用新舊挑戰欄位，不僅替換圖片，也不假設識別服務能產生任意可移植的驗證碼與答案。
GRID 僅作為備選：沒有可用的匹配原生產品或接入方式，或經排查確認原生方案不適用於目前挑戰時，才考慮使用。先檢查參數、會話綁定及有效期；HTTP 403、逾時或參數錯誤本身不能作為切換依據。仍須取得真實的目前網格圖片、原始題目及瀏覽器互動能力；條件不足時停止並回報阻塞。
GRID 的取圖、識別排隊與處理、輪詢及瀏覽器點擊會增加端到端耗時；動態換圖和多輪挑戰還會增加操作。耗時可能超過目標挑戰的有效期，不宜作為時效敏感流程的預設方案，不保證固定識別時長或目標接受結果。接近識別時再取圖，套用前再次檢查新鮮度；挑戰過期或圖片變化後捨棄舊答案，不重用過期答案或自動建立新付費任務。
使用目標網站發出的挑戰及接入參數。識別服務不提供可任意轉移的驗證碼與答案；替換控件或圖片不會替換伺服器挑戰。
MCP 同一次建立重試須重用 requestId 和完全相同的參數。挑戰變化屬於新任務，需新 requestId 並再次計費。按 nextPollAfterSeconds 查詢，不要用建立任務代替輪詢。REST 建立請求本文沒有 requestId 欄位。
範例使用佔位值，不是可直接執行的挑戰。已說明結果欄位不代表目標驗證已通過，也不代表完成了即時可用性測試。不要提交未支援的欄位。
SUCCEEDED 僅表示已取得識別結果；還需分別確認目標網站接受驗證、目標業務操作成功。識別服務無法觀察這兩個結果。
hCaptcha 使用已啟用的原生 HCAPTCHA，再讀取參數模型；目前目錄中不存在時回報未開放。不要因看到核取方塊或圖片網格就替換成 RECAPTCHA_V2、IMPERVA、CUSTOM 或 GRID；付費前核對原生契約是否涵蓋目標所需上下文。

HTTP_SUBMIT

純 HTTP 提交

目標業務及驗證提交能透過 HTTP 完成，且能保持必要會話條件。有識別 API 不代表整個網站支援純 HTTP 操作。

取得目標挑戰與參數 → 建立並查詢對應識別任務 → 隨目標請求提交結果 → 檢查驗證及業務結果。

BROWSER_RESULT

瀏覽器套用識別結果

瀏覽器工具能讀取目前接入參數，並按目標整合方式使用該產品結果。瀏覽器執行能力與識別服務能力需要分別判斷。

讀取目前原生產品參數 → 識別 → 回填規定的 Token 欄位或回呼，或按契約成組替換或提交匹配的挑戰標識與證明或答案 → 正常提交 → 檢查目標驗證及業務結果。僅替換圖片不等於完成接入。

BROWSER_INTERACTION

瀏覽器圖片互動

目前挑戰符合所選圖片產品，瀏覽器工具可以取得正確圖片，並執行所需點擊、旋轉或拖曳。

取得目前挑戰及原始題目 → 識別 → 將答案映射到目前圖片 → 執行互動 → 檢查換圖或下一輪挑戰 → 確認目標結果。

識別成功 → 目標驗證通過 → 業務完成

失敗處理

失敗編碼	下一步
`INVALID_INPUT`	`READ_PRODUCT_SCHEMA` 補齊或修正參數；不要原樣重試錯誤參數或切換 GRID。
`TRANSPORT_OR_WAF`	`INSPECT_REQUEST_CHAIN` 檢查 HTTP、網路及 WAF 回應。403 不是識別結果；不確定是否送達時，用相同 requestId 和參數重試。
`TASK_EXPIRED`	`RECAPTURE_CHALLENGE` 檢查目前挑戰及有效期，確認仍有需要後再建立新付費任務。
`PROVIDER_INPUT_INVALID`	`READ_PRODUCT_SCHEMA` 上游拒絕參數，檢查產品選擇、目前參數及題目。
`PROVIDER_UNSOLVABLE`	`INSPECT_CHALLENGE` 先檢查圖片品質、題目及挑戰是否仍有效，再決定是否付費重試。
`PROVIDER_UNAVAILABLE`	`RETRY_LATER` 服務可用性問題，不要僅因此更換驗證碼產品。
`TASK_FAILED`	`INSPECT_CHALLENGE` 暫無明確公開原因。回報任務 ID 並檢查上下文；不能宣稱目標拒絕或推斷產品不支援。
`TARGET_REJECTED`	`CHECK_BINDING_AND_EXPIRY` 由呼叫方觀察，不能從識別狀態推斷。檢查目標回應、挑戰關聯及有效期。
`BROWSER_APPLICATION_UNSUPPORTED`	`CHANGE_EXECUTION_ENVIRONMENT` 瀏覽器無法使用結果，應回報執行能力限制，不能判定識別產品不可用。

01 / CONNECT

連接 MCP

託管服務

選擇用戶端，複製設定並替換為你的 API Key。請妥善保存設定，避免公開分享金鑰。

服務位址https://app.nexcaptcha.net/mcp

API Key

在個人設定中取得 API Key，或登入後自動填入。

已有設定時，只合併 nex-captcha 節點，保留其他伺服器與設定。~ 表示使用者主目錄，Windows 可使用 %USERPROFILE%。

Claude Code

官方設定說明

在已安裝 Claude Code 的終端執行以下命令，將伺服器加入目前使用者設定。

claude mcp add --transport http --scope user nex-captcha 'https://app.nexcaptcha.net/mcp' --header 'Authorization: Bearer YOUR_API_KEY'

連線檢查
執行 claude mcp list 確認設定，再於 Claude Code 輸入 /mcp 檢查 nex-captcha 的連線及五個工具。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

Claude Desktop

官方設定說明

開啟 Claude Desktop 的 Customize → Connectors，點選 + Add → Add custom connector，名稱填入 Nex Captcha，遠端位址填入下方 URL。

URLhttps://app.nexcaptcha.net/mcp
在驗證選項選擇 No sign in，於 Request headers 加入以下名稱與值，再點選 Add。驗證透過 API Key 請求標頭完成。
請求標頭名稱Authorization
請求標頭值Bearer YOUR_API_KEY
連線檢查
於新對話透過 + → Connectors 啟用 Nex Captcha，再傳送下方查詢範例。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

需要支援自訂遠端連接器的 Claude 版本與帳戶方案；團隊帳戶可能需由組織管理員新增。

Cursor

官方設定說明

將以下 JSON 合併至使用者設定 ~/.cursor/mcp.json，或專案設定 .cursor/mcp.json。

{
  "mcpServers" : {
    "nex-captcha" : {
      "url" : "https://app.nexcaptcha.net/mcp",
      "headers" : {
        "Authorization" : "Bearer YOUR_API_KEY"
      }
    }
  }
}

連線檢查
於 Cursor 設定的 MCP 伺服器清單啟用 nex-captcha，確認五個工具可用，再於 Agent 對話傳送下方查詢範例。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

Codex

官方設定說明

將以下 TOML 加入 ~/.codex/config.toml。若已有 [mcp_servers.nex-captcha]，請取代該節點，不要重複新增。
```
[mcp_servers.nex-captcha]
url = "https://app.nexcaptcha.net/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }
```
連線檢查
儲存後重新開啟 Codex 工作階段。可執行 codex mcp list 查看設定，在 CLI 以 /mcp 檢查工具，再傳送下方查詢範例。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

VS Code

官方設定說明

將以下 JSON 儲存至專案的 .vscode/mcp.json；亦可透過命令面板 MCP: Open User Configuration 加入使用者設定。
```
{"servers":{"nex-captcha":{"type":"http","headers":{"Authorization":"Bearer YOUR_API_KEY"},"url":"https://app.nexcaptcha.net/mcp"}}}
```
連線檢查
透過 MCP: List Servers 啟動 nex-captcha。於 Copilot Chat 的 Agent 模式啟用其工具，再傳送下方查詢範例。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

Gemini CLI

官方設定說明

將以下 JSON 合併至 ~/.gemini/settings.json，或專案的 .gemini/settings.json。httpUrl 用於 Streamable HTTP。

{
  "mcpServers" : {
    "nex-captcha" : {
      "httpUrl" : "https://app.nexcaptcha.net/mcp",
      "headers" : {
        "Authorization" : "Bearer YOUR_API_KEY"
      },
      "timeout" : 30000
    }
  }
}

連線檢查
重新啟動 Gemini CLI，於 /mcp 檢查 nex-captcha 的連線與工具，再傳送下方查詢範例。
```
查詢我的 Nex Captcha 餘額及支援的產品清單。不要建立任務。
```

其他用戶端

在支援 Streamable HTTP 的用戶端填入下方位址與請求標頭，初始化連線後呼叫 tools/list。
```
URL: https://app.nexcaptcha.net/mcp
Transport: Streamable HTTP
Authorization: Bearer YOUR_API_KEY
```
連線檢查
先呼叫 get_balance 或 list_products 檢查連線；需要任務結果時，向 get_task 傳入 create_task 回傳的 id。

驗證連接

僅讀取餘額，不建立任務，不產生費用。

02 / TOOLS

可用工具

5 TOOLS

list_products免費

查看已啟用的產品、單次美元價格及逾時時間。一次回傳完整列表。

get_product_schema免費

傳入 productCode 取得產品的參數模型和範例，建立任務前先查閱。

create_task按產品計費

傳入 productCode、adapter 和唯一 requestId 建立任務。重試時保持相同 requestId 和參數。

get_task免費

依 create_task 回傳的平台 id 備援查詢結果；可使用 WebSocket 時，優先接收 task.updated。

get_balance免費

查看帳戶目前美元餘額。1 USD = 1 balance。

僅建立任務按產品單次價格扣費，其他工具免費。任務失敗或逾期會退款，資產記錄中可查閱計費和退款。

03 / REALTIME

WebSocket 結果推送

客戶端或 MCP 宿主支援 WebSocket 時優先使用：先建立連線並等待 socket.ready，再建立任務。收到 task.updated 立即處理；僅在無法連線、斷線或遺漏訊息時使用 REST query.cgi 或 MCP get_task 備援。

任務 WebSocket 獨立於 MCP 的 HTTP 傳輸。宿主或配套程序能設定 WebSocket 握手請求標頭時，以同一個 API Key 放入 apiKey 請求標頭連線。支援 MCP 不代表具備 WebSocket 能力；無法建立連線時，以回傳的 id 呼叫 get_task，並遵守 nextPollAfterSeconds。工具結果中的 resultDelivery 提供優先接入位址及心跳設定。

wss://app.nexcaptcha.net/socket/task.cgi

apiKey: YOUR_API_KEY
socket.ready → create_task → task.updated
task.taskId = create_task id
{"type":"heartbeat"} → {"type":"heartbeat.ack"}

WebSocket 的 API Key 只能放在握手請求標頭中，不能放入 URL 參數。獨立客戶端使用 apiKey 請求標頭；瀏覽器使用登入 Cookie，只有 API Key 時透過帶請求標頭的 REST 查詢取得結果，因為原生 WebSocket 無法設定自訂標頭。推送只屬於目前驗證使用者。

HTTPS 環境使用 WSS。斷線後退避重連；連線會重播最近 20 條終態任務，不提供完整事件歷史。遺漏的 taskId 以 query.cgi 或 get_task 復原。憑證缺失、無效、撤銷或過期時以 4003 關閉；閒置或不可靠連線以 4500 關閉。

API、MCP 等入口建立的任務，每次狀態變更提交成功後都會推送給該驗證帳戶。成功時讀取 result，失敗時讀取 failure.code 和 nextAction。每 20 秒傳送心跳並確認 heartbeat.ack；超過 35 秒無心跳後，由每 10 秒執行的檢查中斷連線。斷線後退避重連，不要因斷線重建收費任務。依 taskId 冪等處理，已收到終態後忽略更舊或重播的訊息。

容器依使用者 ID 綁定每個執行個體上的目前單一連線；新連線以 4009 替換舊連線。同帳戶的多個接入者應由宿主共用訂閱，被替換端應停止自動重連。執行個體最多 256 條連線；收到 1013 時請退避重試。慢客戶端積壓超過 64 條訊息或 256 KiB UTF-8 資料時，以 4500 中斷，遺漏的 taskId 請透過查詢復原。單條訊息上限為 256 KiB。

API文件 · Python · Java 21

04 / WORKFLOW

從建立到結果

選擇產品並確認參數list_products → get_product_schema
建立一次任務socket.ready → create_task(productCode, adapter, requestId)
優先接收推送結果，主動查詢僅作備援task.updated → get_task({"id": "TASK_ID"})

重試建立時沿用相同 requestId 和參數。優先透過 WebSocket 取得結果；無法接入或斷線時，以 id 呼叫 get_task 復原結果，不要再次建立收費任務。主動查詢時遵守 nextPollAfterSeconds。

支援 Streamable HTTP，協定版本 2025-03-26、2025-06-18 和 2025-11-25。使用 Authorization: Bearer API_KEY 驗證。

讓 AI 助手接入驗證碼服務

選擇接入流程

純 HTTP 提交

瀏覽器套用識別結果

瀏覽器圖片互動

連接 MCP

Claude Code

連線檢查

Claude Desktop

連線檢查

Cursor

連線檢查

Codex

連線檢查

VS Code

連線檢查

Gemini CLI

連線檢查

其他用戶端

連線檢查

驗證連接

可用工具

WebSocket 結果推送

從建立到結果