Mã Claude: Công cụ giải CAPTCHA CapSolver - Hướng dẫn cài đặt MCP

TL;DR

• Kết nối Claude Code với gói chính thức capsolver-mcp để mở rộng các công cụ giải CAPTCHA được hỗ trợ.
• Bắt đầu bằng cách liệt kê các loại CAPTCHA được hỗ trợ; việc kết nối công cụ thành công không chứng minh rằng yêu cầu giải CAPTCHA trả phí sẽ thành công.
• Sử dụng solve_captcha khi bạn đã có loại thách thức được hỗ trợ, URL trang web và sitekey.
• Các công cụ trang web mở phiên trình duyệt riêng của chúng; chúng không tiếp tục tự động một tab Claude hiện có.
• Một token được trả về hoặc widget đã điền vẫn cần kiểm tra cuối cùng từ ứng dụng mục tiêu.

Claude Code có thể giúp viết hoặc gỡ lỗi một nhiệm vụ trình duyệt, nhưng nó cần một công cụ giải CAPTCHA thực tế khi một CAPTCHA được hỗ trợ làm gián đoạn thao tác được phê duyệt. Yêu cầu mô hình "cố gắng nhiều hơn" không cung cấp các tham số trang web, kết nối API hoặc xử lý kết quả mà thách thức yêu cầu.

CapSolver mở rộng các khả năng này thông qua dịch vụ MCP của họ. Hướng dẫn này bao gồm việc cài đặt gói, kết nối nó với Claude Code, kiểm tra các công cụ có sẵn và chọn cuộc gọi giải CAPTCHA. Các ví dụ liên quan đến trang web của bạn hoặc các nhiệm vụ tự động hóa được phép. Chúng không tự động hóa việc tạo tài khoản, mua sắm hoặc truy cập dữ liệu bị hạn chế.

Claude Code Có Thể Làm Gì Với CapSolver MCP?

Claude Code có thể phát hiện và gọi các công cụ MCP của CapSolver sau khi bạn cấu hình và phê duyệt máy chủ.

Dịch vụ MCP chính thức mở rộng năm công cụ:

Tên công cụ mô tả các thao tác riêng biệt. Một truy vấn số dư không nhận diện trang, và việc phát hiện widget không giải nó. Bắt đầu với thao tác bạn thực sự cần.

Phiên bản được cài đặt kiểm tra cho hướng dẫn này, capsolver-mcp 0.1.3, liệt kê reCaptchaV2, reCaptchaV3 và cloudflare thông qua công cụ loại được hỗ trợ. Trong giao diện này, trình xử lý Cloudflare liên quan đến Turnstile. Không nên hiểu tên là hỗ trợ toàn diện cho mọi phản hồi Cloudflare hoặc thách thức toàn trang.

API REST có các giai đoạn nhiệm vụ khác, nhưng chúng không được thêm tự động vào bộ công cụ MCP này. Đặc biệt, không nên truyền nhiệm vụ ImageToText vào solve_captcha chỉ vì API riêng của CapSolver hỗ trợ nhận dạng hình ảnh.

Cài Đặt Các Gói Chính Thức

Cài đặt gói lõi CapSolver, máy chủ MCP và phụ thuộc trình duyệt trong môi trường Python mà Claude Code sẽ khởi chạy.

Các lệnh sau ghi chú phiên bản lõi và MCP được sử dụng ở đây:

python -m pip install capsolver-core==0.1.1 "capsolver-mcp[browser]==0.1.3"
python -m playwright install chromium

Quy trình cài đặt tuân theo hướng dẫn gói chính thức của CapSolver. Phụ thuộc trình duyệt và Chromium cần thiết cho các công cụ trang. Hướng dẫn cài đặt trình duyệt Playwright giải thích rằng các tệp nhị phân trình duyệt là phụ thuộc riêng biệt từ gói Python.

Sử dụng trình thông dịch Python từ môi trường này trong bước tiếp theo. Nếu bạn cài đặt vào môi trường ảo và cấu hình Python khác, client có thể báo rằng nó không thể nhập capsolver_mcp ngay cả khi cài đặt thành công ở nơi khác.

Bạn cũng cần Claude Code và khóa tài khoản CapSolver để giải CAPTCHA thực tế. Lưu khóa này dưới dạng CAPSOLVER_API_KEY trong môi trường khởi động Claude Code. Không nên dán nó vào hộp trò chuyện hoặc nộp vào tệp dự án chung.

Kết nối gói và đường dẫn phát hiện cục bộ có thể được kiểm tra riêng biệt khỏi việc nhận dạng trả phí. Hướng dẫn này không minh họa giải CAPTCHA trực tiếp; bước này yêu cầu tài khoản của bạn và tham số hiện tại của mục tiêu được phê duyệt.

Thêm CapSolver Vào Cấu Hình Dự Án MCP

Thêm mục capsolver vào tệp .mcp.json của dự án, chỉ định đến môi trường Python nơi bạn cài đặt các gói.

Cấu hình dưới đây sử dụng mẫu khởi động Python được tài liệu hóa của CapSolver và mở rộng biến môi trường của Claude Code. Thay thế đường dẫn Python bằng đường dẫn tuyệt đối thực tế cho môi trường của bạn:

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      }
    }
  }
}

Nếu tệp .mcp.json đã chứa các máy chủ khác, thêm mục này bên trong đối tượng mcpServers hiện có thay vì thay thế tệp. Tài liệu giữ giá trị khóa bên ngoài tệp JSON, nhưng biến vẫn cần có sẵn khi Claude Code khởi động.

Tài liệu cấu hình MCP của Claude Code bao gồm phạm vi dự án, mở rộng biến môi trường và phê duyệt máy chủ. Khởi động Claude Code từ dự án đã định, xem xét thông báo phê duyệt máy chủ dự án và chỉ phê duyệt máy chủ này sau khi xác nhận lệnh và gói là những gì bạn đã cài đặt.

Kiểm tra cấu hình từ thư mục dự án:

claude mcp list

Trong phiên làm việc Claude Code tương tác, sử dụng /mcp để kiểm tra trạng thái máy chủ và các điều khiển có sẵn. Trạng thái chưa được phê duyệt có nghĩa là máy chủ dự án vẫn cần đánh giá của bạn. Nó khác với việc không tìm thấy tệp thực thi hoặc kết nối thất bại.

Kiểm Tra Các Công Cụ Trước Khi Yêu Cầu Giải CAPTCHA

Yêu cầu Claude Code liệt kê các loại CAPTCHA được hỗ trợ trước khi yêu cầu nó sử dụng tín dụng tài khoản.

Yêu cầu đầu tiên phù hợp là:

Sử dụng công cụ CapSolver get_supported_captchas và cho tôi biết loại CAPTCHA nào máy chủ này hiện đang hỗ trợ. Không gửi nhiệm vụ giải CAPTCHA.

Điều này xác nhận rằng client có thể truy cập công cụ thực tế và cung cấp phạm vi thực tế của máy chủ được cài đặt. Chu trình cuộc sống kết nối của MCP tách biệt việc khởi tạo khỏi các thao tác sau; việc thiết lập kết nối chỉ là bước đầu tiên của tích hợp có thể sử dụng.

Đối với kiểm tra tài khoản, bạn có thể yêu cầu get_balance. Giữ phản hồi riêng nếu nó chứa thông tin tài khoản. Lỗi ở đây chỉ ra quyền truy cập tài khoản hoặc giao tiếp dịch vụ và nên được giải quyết trước khi thử giải CAPTCHA trả phí.

Không nên đánh giá sự sẵn sàng từ tuyên bố của mô hình rằng nó "biết CapSolver." Kiểm tra kết quả công cụ thực tế. Một công cụ phát hiện, truy vấn tài khoản thành công và giải CAPTCHA hoàn tất xác lập các sự thật khác nhau.

Nhận Mã Thưởng CapSolver

Tăng ngân sách tự động hóa của bạn ngay lập tức!
Sử dụng mã khuyến mãi CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% thưởng cho mỗi lần nạp tiền — không giới hạn.
Nhận mã ngay bây giờ trong Bảng điều khiển CapSolver

Sử Dụng Chế Độ Token Với Tham Số Thách Thức Đã Biết

Sử dụng solve_captcha khi luồng trình duyệt hoặc ứng dụng được phê duyệt của bạn đã cung cấp các loại, URL trang web và sitekey cần thiết.

Ví dụ, cung cấp cho Claude Code một chỉ định có giới hạn như:

Sử dụng công cụ CapSolver solve_captcha một lần cho reCAPTCHA v2 trên trang web thử nghiệm được phê duyệt của tôi. Sử dụng URL trang web và sitekey chính xác mà tôi đã cung cấp. Nếu bất kỳ tham số nào bị thiếu, báo cáo đầu vào bị thiếu thay vì đoán. Trả về trạng thái công cụ mà không in token đầy đủ trong bản tóm tắt của bạn.

Cấu trúc của công cụ sử dụng captcha_type, website_url và website_key. Kiểm tra cấu trúc được phát hiện để xác định các tham số bổ sung cần thiết cho thách thức bạn đang xử lý. Không sao chép tên nhiệm vụ REST vào trường loại MCP: reCaptchaV2 là giá trị MCP, trong khi API REST có tên nhiệm vụ được tài liệu riêng.

Ứng dụng của bạn sau đó cần tiêu thụ token được trả về thông qua luồng được định nghĩa của mục tiêu. Cuộc gọi MCP itself không gửi mọi biểu mẫu hoặc xác minh kết quả kinh doanh. Đối với đầu vào reCAPTCHA cụ thể của trang, tham khảo tài liệu nhiệm vụ reCAPTCHA v2.

Nếu một tham số không biết, kiểm tra trang được phê duyệt hiện tại với công cụ trình duyệt phù hợp. Một sitekey được nhớ từ trang khác không phải là bằng chứng cho widget hiện tại. Giữ giải CAPTCHA liên quan đến thao tác đang được gỡ lỗi.

Sử Dụng Công Cụ Trang Với Giới Hạn Trình Duyệt Của Chúng

Các công cụ trang chấp nhận URL và hoạt động trong phiên trình duyệt được tạo bởi dịch vụ MCP.

Đối với phát hiện, một yêu cầu hữu ích là:

Gọi công cụ CapSolver detect_captchas trên URL trang web được phê duyệt này và báo cáo loại được phát hiện. Chưa giải nó ngay.

Khi giải trang này là thao tác được định hướng, solve_on_page có thể thực hiện chuỗi phát hiện, giải và điền được tài liệu hóa. Xem xét thách thức được quan sát và phạm vi được hỗ trợ trước khi yêu cầu cuộc gọi này.

Giới hạn quan trọng là rõ ràng trong thực hiện MCP chính thức: các công cụ này mở trình duyệt cho cuộc gọi và đóng nó sau đó. Chúng không gắn vào tab do một công cụ MCP trình duyệt khác sở hữu hoặc tự động kế thừa trạng thái đăng nhập của nó.

Điều này khiến trang web kiểm tra trực tiếp là điểm bắt đầu rõ ràng hơn so với trang web chỉ có sẵn sau nhiều bước phiên riêng tư. Nếu nhiệm vụ của bạn cần duy trì trên trang web bạn đã kiểm soát, sử dụng tích hợp được hỗ trợ hoạt động trên trang hiện có. SDK Core của CapSolver tài liệu khả năng trình duyệt-adapter cho yêu cầu tích hợp khác.

Hướng dẫn Sử dụng Máy tính Claude thảo luận về bề mặt liên quan của trình duyệt. Sử dụng Máy tính Claude và thiết lập MCP Claude Code này nên không được coi là cấu hình thay thế cho nhau.

Sửa Lỗi Cài Đặt Trước Khi Lặp Lại Yêu Cầu CAPTCHA

Hầu hết các lỗi cài đặt có thể được thu hẹp đến đường dẫn thực thi, môi trường, cài đặt trình duyệt hoặc đầu vào nhiệm vụ.

Nếu lệnh máy chủ không thể tìm thấy, sử dụng đường dẫn Python tuyệt đối được hiển thị ở trên. Nếu gói không thể nhập, xác minh rằng cùng môi trường Python chứa capsolver-mcp và capsolver-core.

Nếu phát hiện trang báo thiếu tệp thực thi trình duyệt, chạy lệnh cài đặt Chromium trong môi trường khởi động máy chủ MCP. Chế độ token không yêu cầu trình duyệt chỉ để gọi dịch vụ giải CAPTCHA, vì vậy phân biệt giữa lỗi khởi động trình duyệt và lỗi API giải CAPTCHA.

Nếu máy chủ kết nối nhưng lời gọi API thất bại, giữ mã lỗi được trả về và bản tóm tắt đã che khuất. Kiểm tra khóa tài khoản, loại được hỗ trợ, đầu vào cần thiết và trạng thái trang hiện tại trước khi thử lại.

Nếu giải CAPTCHA trả về token nhưng ứng dụng ban đầu không thay đổi, kiểm tra việc tiêu thụ kết quả. Xác nhận rằng kết quả được sử dụng bởi luồng được định nghĩa và bạn không giả định hai phiên trình duyệt riêng biệt chia sẻ trạng thái.

Giữ giới hạn nhỏ cho các lần thử lặp lại. Khi cùng lỗi không được giải quyết, cung cấp bằng chứng để xem xét thay vì chỉ định đại diện thử lại vô hạn.

Xây Dựng Luồng Tự Động Hóa Tin Cậy Với CapSolver

Bắt đầu với kết nối MCP thực tế, kiểm tra bộ công cụ được cài đặt và yêu cầu thao tác phù hợp với thách thức trong nhiệm vụ được phê duyệt của bạn.

CapSolver cung cấp khả năng giải CAPTCHA được tài liệu hóa cho Claude Code. Đầu vào chính xác và ranh giới trình duyệt rõ ràng khiến khả năng này hữu ích; phản hồi ứng dụng cuối cùng cho bạn biết liệu nhiệm vụ được định hướng có thực sự hoàn thành hay không.

Câu Hỏi Thường Gặp

Câu hỏi: Tôi có cần phụ thuộc trình duyệt cho mọi công cụ MCP không?

Không. Các công cụ trang cần phụ thuộc trình duyệt và Chromium. Giải CAPTCHA theo token và truy vấn tài khoản hoặc phạm vi không cần mở trình duyệt chỉ để gọi dịch vụ tương ứng hoặc khả năng cục bộ.

Câu hỏi: CapSolver MCP có thể tiếp tục tab trình duyệt hiện tại của tôi không?

Các công cụ trang trong phiên bản được kiểm tra mở và đóng phiên trình duyệt riêng của chúng. Không nên giả định rằng chúng kiểm soát tab do công cụ trình duyệt khác sở hữu.

Câu hỏi: Máy chủ MCP có hỗ trợ mọi nhiệm vụ REST của CapSolver không?

Không. Kiểm tra get_supported_captchas và cấu trúc công cụ được phát hiện. Các khả năng REST riêng biệt không được mở rộng tự động qua gói MCP này.

Câu hỏi: Tại sao Claude Code hiển thị trạng thái chờ phê duyệt?

Một máy chủ MCP dự án có thể yêu cầu phê duyệt trước khi sử dụng. Xem xét nó trong Claude Code và xác nhận lệnh được cấu hình thay vì coi trạng thái phê duyệt là lỗi khóa API.

Câu hỏi: Một giải CAPTCHA thành công có nghĩa là đại diện đã hoàn thành nhiệm vụ của nó không?

Không. Xác minh rằng kết quả được tiêu thụ bởi ứng dụng được định hướng và thao tác trang được yêu cầu đã hoàn tất. Một token hoặc widget đã điền là kết quả trung gian.