
Anh Tuan
Data Science Expert

Giao thức Bối cảnh Mô hình (MCP) cho phép các khách hàng AI phát hiện và gọi các công cụ bên ngoài mà không cần mã tích hợp nào. Gói capsolver-mcp của CapSolver trình bày giải quyết CAPTCHA dưới dạng dịch vụ MCP tiêu chuẩn — khi kết nối, bất kỳ khách hàng MCP nào tương thích (Claude Desktop, Claude Code, Cursor, Cline, Windsurf) sẽ tự động nhận được năm công cụ giải quyết. Hướng dẫn này sẽ chỉ cho bạn cách thiết lập và sử dụng dịch vụ MCP của CapSolver để giải quyết CAPTCHA trong quy trình AI của bạn.
capsolver-mcp trình bày giải quyết CAPTCHA dưới dạng công cụ MCP tiêu chuẩn — không cần mã thích ứng cho từng khách hàngsolve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchasGiao thức Bối cảnh Mô hình là một tiêu chuẩn mở cho phép các ứng dụng AI phát hiện và sử dụng các công cụ bên ngoài qua giao diện thống nhất. Thay vì viết mã tích hợp riêng cho từng khách hàng AI, bạn chỉ cần đóng gói khả năng dưới dạng dịch vụ MCP một lần, và mọi khách hàng tương thích có thể sử dụng ngay lập tức.
Đối với giải quyết CAPTCHA, điều này có nghĩa là bạn cài đặt capsolver-mcp, cấu hình bằng khóa API của mình, và mọi khách hàng MCP trong quy trình làm việc của bạn — Claude Desktop cho nghiên cứu, Cursor cho phát triển, Cline cho tự động hóa — sẽ có khả năng giải CAPTCHA reCAPTCHA, Cloudflare Turnstile và các thách thức xác minh khác ngay lập tức. Không cần mã cho từng khách hàng, không cần bộ chuyển đổi đặc trưng cho khung.
Thông số kỹ thuật MCP định nghĩa cách khách hàng phát hiện công cụ, gọi chúng với tham số có cấu trúc và nhận kết quả. Thực hiện của CapSolver tuân theo đúng thông số này, khiến nó tương thích với hệ sinh thái ngày càng phát triển của các khách hàng MCP.
# Cài đặt động cơ chính trước (mcp phụ thuộc vào nó)
pip install git+https://github.com/capsolver-ai/capsolver-core.git
# Cài đặt dịch vụ MCP
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git
# Tùy chọn: công cụ trình duyệt (detect/solve_on_page)
pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium
export CAPSOLVER_API_KEY="khóa API của bạn"
# stdio (mặc định — cho các khách hàng MCP cục bộ như Claude Desktop)
capsolver-mcp
# SSE (cho truy cập từ xa/HTTP)
capsolver-mcp --transport sse --host 0.0.0.0 --port 8000
# Streamable HTTP (thông số MCP 2025-03-26)
capsolver-mcp --transport streamable-http --host 0.0.0.0 --port 8000
Tùy chọn dòng lệnh:
capsolver-mcp [TÙY CHỌN]
--transport {stdio,sse,streamable-http} Giao thức truyền (mặc định: stdio)
--host HOST Máy chủ kết nối cho SSE/HTTP (mặc định: 127.0.0.1)
--port PORT Cổng kết nối cho SSE/HTTP (mặc định: 8000)
--api-key KEY Khóa API (sẽ dựa vào biến môi trường CAPSOLVER_API_KEY nếu không có)
--name NAME Tên dịch vụ (mặc định: capsolver)
Thêm vào tệp cấu hình MCP của bạn:
{
"mcpServers": {
"capsolver": {
"command": "capsolver-mcp",
"env": {
"CAPSOLVER_API_KEY": "KHÓA API CỦA BẠN"
}
}
}
}
Nếu khách hàng không thể tìm thấy capsolver-mcp trên PATH (thường gặp với venv/conda):
{
"mcpServers": {
"capsolver": {
"command": "/đường_dẫn_tuyệt_đối/tới/venv/bin/python",
"args": ["-m", "capsolver_mcp"],
"env": {
"CAPSOLVER_API_KEY": "KHÓA API CỦA BẠN"
}
}
}
}
Cùng một khối cấu hình trong tệp mcp.json của dự án. Sau khi tải lại, năm công cụ của CapSolver sẽ xuất hiện trong danh sách công cụ tự động.
Sau khi kết nối, dịch vụ cung cấp năm công cụ:
| Công cụ | Trình duyệt? | Mô tả |
|---|---|---|
solve_captcha |
Không | Giải quyết bằng loại + tham số trang web (chế độ Token) |
detect_captchas |
Có | Quét URL trang và liệt kê loại CAPTCHA hiện có |
solve_on_page |
Có | Phát hiện + giải quyết + điền lại tất cả CAPTCHA trên trang |
get_balance |
Không | Tra cứu số dư tài khoản |
get_supported_captchas |
Không | Liệt kê loại CAPTCHA được hỗ trợ |
Với dịch vụ MCP đã kết nối, chỉ cần sử dụng ngôn ngữ tự nhiên trong khách hàng AI của bạn:
Kiểm tra số dư:
"Sử dụng capsolver để kiểm tra số dư tài khoản của tôi."
Khách hàng sẽ gọi get_balance và trả về số dư của bạn.
Giải quyết theo chế độ Token:
"Giải quyết reCAPTCHA v2 này cho tôi. URL là https://example.com/login và khóa trang là 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI."
Khách hàng sẽ gọi solve_captcha với các tham số và trả về một token.
Giải quyết toàn trang:
"Phát hiện và giải quyết tất cả CAPTCHA trên https://example.com/protected-page."
Khách hàng sẽ gọi solve_on_page, phát hiện, giải quyết và điền lại tất cả CAPTCHA trên trang.
Để tích hợp dịch vụ MCP vào ứng dụng của bạn:
from capsolver_mcp import create_server
# Tạo và chạy máy chủ MCP theo chương trình
server = create_server(
api_key="KHÓA API CAPSOLVER CỦA BẠN",
name="capsolver",
transport="stdio"
)
Điều này hữu ích khi bạn muốn tích hợp khả năng giải quyết CAPTCHA vào một dịch vụ MCP lớn hơn, nơi cung cấp nhiều bộ công cụ.
Nhận Mã Ưu đãi của Bạn: Sử dụng mã WEBS tại Bảng điều khiển CapSolver để nhận thêm 5% ưu đãi cho mỗi lần nạp tiền.
Tài liệu MCP của CapSolver https://www.capsolver.com/blog/ai cung cấp các ví dụ cấu hình bổ sung. Để hiểu động cơ giải quyết cơ bản, xem hướng dẫn SDK CapSolver core. Mở rộng CapSolver https://www.capsolver.com/blog/Extension/capsolver-captcha-solver-extension giúp xác định tham số CAPTCHA trong quá trình phát triển.
Dịch vụ MCP của CapSolver (capsolver-mcp) cung cấp con đường nhanh nhất để giải quyết CAPTCHA trong bất kỳ khách hàng AI nào tương thích MCP. Cài đặt, cấu hình khóa API của bạn, và mọi khách hàng trong quy trình làm việc của bạn sẽ có khả năng giải quyết mà không cần mã tích hợp nào. CapSolver xử lý giải quyết được hỗ trợ bởi AI trên đám mây trong khi dịch vụ MCP quản lý phát hiện công cụ, truyền tham số và giao kết quả qua giao thức tiêu chuẩn.
Mọi khách hàng tương thích MCP: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code với plugin Claude, và bất kỳ khách hàng tùy chỉnh nào thực hiện thông số kỹ thuật MCP. Giao thức stdio hoạt động với các khách hàng cục bộ; SSE và streamable-http hoạt động với các khách hàng từ xa/mạng.
Chỉ cần cho các công cụ detect_captchas và solve_on_page. Công cụ chính solve_captcha hoạt động ở chế độ Token — không cần trình duyệt. Cài đặt phần mở rộng [browser] chỉ nếu bạn cần phát hiện và điền trang tự động.
Với giao thức SSE hoặc streamable-http, có thể. Khởi động dịch vụ trên cổng mạng và nhiều khách hàng có thể kết nối đồng thời. Mỗi cuộc gọi công cụ của khách hàng được xử lý độc lập.
Khách hàng MCP xử lý kết nối lại tự động. Nếu dịch vụ khởi động lại, khách hàng sẽ phát hiện lại công cụ khi kết nối lại. Các yêu cầu giải quyết đang xử lý có thể thất bại và cần thử lại từ phía khách hàng.
Tích hợp giải CAPTCHA vào các tác nhân LlamaIndex bằng FunctionTool và CapSolver cho các pipeline tiếp nhận dữ liệu web.

Tạo token reCAPTCHA v3 có điểm cao trong OpenAI Agents SDK bằng cách sử dụng công cụ hàm CapSolver.
