Cách sử dụng Máy chủ MCP của CapSolver: Hướng dẫn cài đặt AI Agent

TL;DR

• Máy chủ CapSolver MCP cung cấp năm công cụ được tài liệu hóa: solve_captcha, detect_captchas, solve_on_page, get_balance, và get_supported_captchas.
• Cài đặt capsolver-core trước capsolver-mcp, sau đó cấu hình client MCP để khởi chạy lệnh capsolver-mcp với khóa API trong môi trường của nó.
• Các công cụ trình duyệt yêu cầu phần mở rộng trình duyệt và Chromium; chế độ token có thể chạy mà không cần trình duyệt khi loại CAPTCHA, URL trang và khóa trang đã biết.
• Các đại lý sản xuất cần quy tắc máy chủ được phê duyệt, một lần khôi phục có giới hạn, nhật ký đã được che đi và kiểm tra thành công ở cấp độ ứng dụng.

Giới thiệu

Cách an toàn nhất để sử dụng máy chủ CapSolver MCP là xem xử lý CAPTCHA như một công cụ cơ sở hạ tầng hẹp, không phải là nguồn quyền lực mới cho đại lý. CapSolver cung cấp dịch vụ capsolver-mcp chính thức, bao bọc capsolver-core và cho phép các khách hàng AI tương thích khám phá các công cụ CAPTCHA được tài liệu hóa. Đại lý sau đó có thể phục hồi từ gián đoạn reCAPTCHA v2, reCAPTCHA v3 bao gồm Enterprise, hoặc Cloudflare Turnstile bên trong quy trình trình duyệt được cấp quyền. Ứng dụng của bạn vẫn sở hữu phạm vi, thông tin đăng nhập, giới hạn thử lại và khẳng định kinh doanh cuối cùng. Hướng dẫn này hiển thị cài đặt thực tế và cấu hình JSON, giải thích từng công cụ và giới hạn đầu ra, và định nghĩa các điều kiện dừng cho việc sử dụng hợp pháp, hợp lý và có trách nhiệm. Nó không cấp quyền truy cập vào dữ liệu riêng tư, bị hạn chế, nhạy cảm hoặc không được phép.

Hiểu ba lớp CapSolver

Trước khi quyết định cách sử dụng máy chủ CapSolver MCP, hãy phân tách các lớp sản phẩm. Tổng quan CapSolver cho các đại lý AI mô tả kiến trúc lớp khôi phục. capsolver-core thực hiện phát hiện và giải quyết, capsolver-agent chuyển đổi các phương pháp đó thành các lược đồ gọi bởi đại lý, và capsolver-mcp công bố cùng khả năng này qua MCP.

API SDK core tài liệu hóa create_capsolver, detect, get_captcha_info, solve và solve_on_page. Công cụ thích ứng đại lý tài liệu hóa get_all_tools và create_executor. Hướng dẫn dịch vụ MCP là nguồn tin cậy cho cài đặt, phương tiện truyền tải, cấu hình và năm công cụ MCP.

Chọn MCP khi khách hàng đã nói MCP

Sử dụng máy chủ CapSolver MCP cho Claude Desktop, Cursor, Cline, khách hàng VS Code hoặc một host tương thích khác. Sử dụng capsolver-agent khi bạn đang viết vòng lặp gọi hàm riêng. Sử dụng capsolver-core khi Playwright hoặc một dịch vụ sở hữu toàn bộ luồng kiểm soát và không có mô hình nào cần lược đồ công cụ. Sự phân biệt này ngăn chặn các bộ thích ứng trùng lặp và làm cho cách sử dụng máy chủ CapSolver MCP dễ bảo trì hơn.

Cài đặt các gói chính thức

Thứ tự cài đặt chính thức cài đặt động cơ cốt lõi trước và bao bọc MCP sau:

pip install git+https://github.com/capsolver-ai/capsolver-core.git
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

Đối với phát hiện trình duyệt và solve_on_page, cài đặt phần mở rộng trình duyệt và Chromium:

pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

Các lệnh này là đầu vào đã được xác minh cho cách sử dụng máy chủ CapSolver MCP. Đầu ra thành công là lệnh thực thi capsolver-mcp. Dừng lại nếu cài đặt giải quyết thành tên gói không chính thức, nếu lệnh thiếu hoặc nếu Chromium không có sẵn cho triển khai chế độ trình duyệt.

Cấu hình client MCP

Cấu hình stdio chính thức gọn nhẹ và hoạt động trên nhiều client MCP cục bộ:

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Giữ khóa thực tế trong quản lý bí mật hoặc môi trường client thay vì kiểm soát nguồn. Đầu vào là lệnh và môi trường. Đầu ra là máy chủ đã kết nối mà danh sách công cụ của nó có thể được kiểm tra. Điều kiện dừng là khởi chạy thất bại, đường dẫn thực thi không mong đợi hoặc danh sách đăng ký không đầy đủ. Thông số công cụ MCP giải thích tại sao các client nên khám phá và xác minh lược đồ công cụ trước khi gọi.

Xác minh tên công cụ chính xác

Sau khi tải lại client, xác nhận năm tên: solve_captcha, detect_captchas, solve_on_page, get_balance và get_supported_captchas. Bài viết về sửa lỗi CAPTCHA trên máy chủ MCP cung cấp con đường chẩn đoán hữu ích, trong khi khôi phục điểm kiểm tra đại lý MCP giải thích tại sao khôi phục phải duy trì giới hạn.

Nhận mã thưởng CapSolver của bạn

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

Xác định đầu vào, đầu ra và điều kiện dừng

Đối với chế độ token, đại lý cung cấp loại CAPTCHA được hỗ trợ, URL trang được cấp phép và khóa trang công khai; solve_captcha trả về giải pháp thông qua kết quả công cụ MCP. Đối với chế độ trình duyệt, detect_captchas liệt kê các loại đã phát hiện và solve_on_page thực hiện phát hiện, giải quyết và điền lại được tài liệu hóa. get_balance báo cáo thông tin số dư, và get_supported_captchas báo cáo danh sách đăng ký hiện tại.

Không suy ra thành công từ phản hồi công cụ không lỗi. Ứng dụng phải xác minh rằng tuyến đường, trạng thái biểu mẫu hoặc khẳng định kiểm tra đã thay đổi trong cùng phiên trình duyệt. Dừng cách sử dụng máy chủ CapSolver MCP sau một nỗ lực tự động, thay đổi tên miền, điểm kiểm tra thứ hai, cấp phép hết hạn, loại CAPTCHA không được hỗ trợ hoặc trạng thái trang mơ hồ.

Hướng dẫn cài đặt CAPTCHA MCP giúp kết nối cấu hình với khám phá công cụ thực tế. Đối với hành vi MCP cụ thể cho reCAPTCHA, ví dụ reCAPTCHA v2 của Cursor cho thấy cách tích hợp khách hàng hẹp khác với triển khai máy chủ tổng quát.

Thêm các rào cản sản xuất

Một triển khai sản xuất cho cách sử dụng máy chủ CapSolver MCP nên chỉ cho phép các máy chủ được phê duyệt và hành động được công bố. Giữ cookie và thông tin đăng nhập ngoài các tin nhắn mô hình. Ghi lại các định danh yêu cầu, tên công cụ, trạng thái cuối cùng và mã lỗi đã che đi thay vì token thô. Hướng dẫn ghi nhật ký OWASP hỗ trợ thiết kế sự kiện có ý thức về quyền riêng tư, và Khung quản lý rủi ro AI của NIST hỗ trợ kiểm soát có trách nhiệm.

Kiểm tra các trường hợp thiếu khóa, thiếu phụ thuộc trình duyệt, khám phá công cụ không đầy đủ, loại không hỗ trợ, trạng thái trang không thay đổi và thử thách lặp lại. Mỗi trường hợp tiêu cực nên trả về trạng thái xem xét cuối cùng thay vì cuộc gọi tự động khác.

Kết luận

Phương pháp thực tế cho cách sử dụng máy chủ CapSolver MCP là đơn giản: cài đặt capsolver-core và capsolver-mcp, cấu hình lệnh chính thức, xác minh năm công cụ, và đặt rào cản cấp phép nghiêm ngặt trước mỗi cuộc gọi. Xem xét kết quả thành công của ứng dụng là kết quả và hoàn thành công cụ là bằng chứng. Các nhóm vận hành quy trình đại lý được phép có thể đánh giá CapSolver như lớp cơ sở hạ tầng CAPTCHA.

Câu hỏi thường gặp

Máy chủ CapSolver MCP có hỗ trợ mọi loại nhiệm vụ CapSolver cho đại lý không?

Không. Tài liệu đại lý AI hiện tại giới hạn lớp này chỉ cho reCAPTCHA v2, reCAPTCHA v3 bao gồm Enterprise và Cloudflare Turnstile. Kiểm tra get_supported_captchas tại thời điểm chạy.

Lệnh nào mà client MCP nên khởi chạy?

Sử dụng lệnh thực thi capsolver-mcp chính thức, hoặc khởi chạy module đã cài đặt với Python của môi trường khi lệnh thực thi không có trong PATH của client.

Khi nào cách sử dụng máy chủ CapSolver MCP yêu cầu Playwright?

Phát hiện trình duyệt và solve_on_page yêu cầu phần mở rộng trình duyệt và Chromium. Chế độ token không yêu cầu trình duyệt khi tham số trang đã biết.

Điều gì nên dừng đại lý AI sau khi gọi CAPTCHA?

Dừng khi thay đổi phạm vi, loại không hỗ trợ, thiếu ngữ cảnh trình duyệt, thử thách lặp lại, cấp phép hết hạn hoặc trạng thái ứng dụng không thay đổi sau một nỗ lực.