Cách cài đặt CapSolver MCP từ MCP Registry chính thức

TL;DR

• CapSolver MCP được liệt kê trong Registry MCP Chính thức với tên io.github.capsolver-ai/capsolver-mcp. Phiên bản ổn định mới nhất là 0.1.3, được phân phối qua PyPI và chạy cục bộ qua stdio.
• Đường dẫn cài đặt ngắn nhất là uvx capsolver-mcp. uvx tạo môi trường cô lập và chạy lệnh đã đăng ký mà không cần cài đặt gói toàn cục.
• Mỗi cấu hình khách hàng cần CAPSOLVER_API_KEY. Giữ khóa thực tế trong môi trường khách hàng hoặc kho khóa được phê duyệt, không bao giờ lưu trong kho mã nguồn công khai.
• Kết nối hoạt động nên hiển thị năm công cụ. Chúng bao gồm giải quyết dựa trên token, phát hiện trang, giải quyết cấp trang, kiểm tra số dư và loại thử thách được hỗ trợ.
• Công cụ dựa trên trình duyệt yêu cầu phần mở rộng browser tùy chọn và Playwright Chromium. Các công cụ cơ bản dựa trên token không cần cài đặt trình duyệt bổ sung.
• Sử dụng CapSolver chỉ trong các quy trình bạn sở hữu hoặc được phép kiểm tra hoặc tự động hóa. Sự có mặt trong Registry không cấp quyền truy cập vào hệ thống riêng tư hoặc bị hạn chế.

Cài đặt CapSolver MCP từ Registry MCP Chính thức

Registry MCP Chính thức cung cấp cho khách hàng và nhà phát triển MCP một hồ sơ chuẩn để khám phá CapSolver MCP, gói, phương thức truyền, biến môi trường yêu cầu, kho lưu trữ và phiên bản hiện tại. Registry không lưu trữ gói Python; nó chỉ định cho khách hàng phiên bản đã xác minh capsolver-mcp trên PyPI.

Hướng dẫn này đi qua các bước khám phá, cài đặt, cấu hình và kiểm tra kết nối đầu tiên. Nó sử dụng CapSolver chỉ cho các quy trình hợp pháp, được phép, AI-agent, QA, RPA và tự động hóa trình duyệt.

Những gì Entry Registry Chính thức Cung cấp

Entry CapSolver MCP công bố dữ liệu mô tả chính xác mà một khách hàng tương thích cần để xây dựng cấu hình stdio cục bộ.

Bạn có thể xem entry hiện tại trong giao diện tìm kiếm Registry MCP Chính thức. Registry là một thư viện thượng nguồn: nó chuẩn hóa dữ liệu khám phá trong khi gói thực tế vẫn ở PyPI. Tài liệu ra mắt Registry MCP mô tả mô hình thư viện và phân phối này.

Yêu cầu tiên quyết

CapSolver MCP cần Python 3.10 hoặc mới hơn, một khách hàng MCP tương thích và một khóa API CapSolver.

Chuẩn bị những điều sau trước khi chỉnh sửa cấu hình khách hàng:

1. Cài đặt Python 3.10 hoặc mới hơn.
2. Cài đặt uv nếu bạn muốn quy trình uvx được khuyến nghị.
3. Tạo tài khoản CapSolver và lấy khóa API từ bảng điều khiển.
4. Xác nhận rằng khách hàng MCP của bạn hỗ trợ máy chủ stdio cục bộ.
5. Quyết định xem bạn cần các công cụ dựa trên token hay các công cụ trình duyệt tùy chọn.

Tài liệu dịch vụ CapSolver MCP https://docs.capsolver.com/en/guide/ai/mcp-service/ giải thích con đường tích hợp được hỗ trợ, trong khi https://docs.capsolver.com/en/guide/ai/capsolver-for-ai-agents/ giúp bạn chọn giữa MCP, công cụ AI agent và Core SDK.

Bước 1: Tìm Kiếm Bản Ghi Registry Đúng

Tìm capsolver trong Registry MCP Chính thức và chọn tên chính xác này:

io.github.capsolver-ai/capsolver-mcp

Xác nhận rằng phiên bản hiển thị là 0.1.3 hoặc mới hơn và trạng thái là active. Tránh các gói cộng đồng có tên tương tự trừ khi bạn đã xem xét riêng biệt nhà phát hành, kho lưu trữ, quyền hạn và mã nguồn.

Đối với kiểm tra cấp API, yêu cầu phiên bản máy chủ chính xác:

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"

Dấu gạch chéo trong tên registry được mã hóa thành %2F. Trả lời nên xác định capsolver-mcp là gói PyPI, uvx là gợi ý chạy và stdio là phương thức truyền.

Bước 2: Cài Đặt và Kiểm Tra CLI

Đường dẫn được khuyến nghị chạy CapSolver MCP trong môi trường cô lập:

uvx capsolver-mcp --help

Nếu bạn thích môi trường ảo được quản lý, cài đặt gói rõ ràng:

python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --help

CLI hiện tại hỗ trợ các chế độ chạy stdio, sse và streamable-http. Entry Registry MCP Chính thức sử dụng stdio vì khách hàng khởi động gói cục bộ như một quy trình con. Gói cũng có thể khởi động quy trình hỗ trợ HTTP trên cơ sở hạ tầng của bạn, nhưng CapSolver hiện tại không công bố điểm cuối MCP được lưu trữ trong registry.

Phương pháp uvx tuân theo mô hình thực thi công cụ cô lập được tài liệu trong hướng dẫn công cụ uv chính thức.

Nhận Mã Khuyến Mãi 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 tài khoản CapSolver để nhận thêm 5% khuyến mãi cho mỗi lần nạp — không giới hạn.
Nhận mã ngay trong Bảng điều khiển CapSolver

Bước 3: Cấu Hình Khách Hàng MCP Cục Bộ

Một khách hàng cục bộ phải khởi động uvx capsolver-mcp và truyền CAPSOLVER_API_KEY đến quy trình con.

Sử dụng hình dạng cấu hình này trong các khách hàng chấp nhận đối tượng mcpServers, bao gồm Claude Desktop và các khách hàng có cấu hình máy chủ cục bộ tương thích:

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Thay thế chỗ trống cục bộ. Không commit khóa API thực tế vào Git, dán nó vào báo cáo vấn đề hoặc bao gồm nó trong hình ảnh chụp màn hình.

Nếu ứng dụng desktop không tìm thấy uvx, sử dụng đường dẫn tuyệt đối trả về bởi lệnh sau:

which uvx

Trên PowerShell Windows, sử dụng:

Get-Command uvx

Sau khi lưu cấu hình, khởi động lại hoàn toàn khách hàng MCP. Một cửa sổ đóng có thể để ứng dụng chạy nền, vì vậy hãy dừng quy trình nếu máy chủ không xuất hiện sau khi chỉnh sửa cấu hình.

Bước 4: Kiểm Tra Giao Thoại MCP và Công Cụ

Một kết nối thành công nên hiển thị năm công cụ CapSolver MCP cho khách hàng.

Bắt đầu với kiểm tra không trình duyệt như:

Sử dụng máy chủ MCP CapSolver để liệt kê các loại CAPTCHA được hỗ trợ.

Sau đó xác minh xác thực tài khoản với:

Sử dụng máy chủ MCP CapSolver để kiểm tra số dư tài khoản của tôi.

Các kiểm tra này xác nhận rằng khách hàng có thể khởi động quy trình stdio, phát hiện công cụ và truyền biến môi trường. Một yêu cầu giải quyết thực tế cần thêm tham số mục tiêu được phép và số dư tài khoản đủ.

Bước 5: Kích Hoạt Công Cụ Dựa Trên Trình Duyệt Khi Cần Thiết

Phát hiện và tương tác trang dựa trên trình duyệt yêu cầu gói tùy chọn cộng thêm Playwright Chromium.

Đối với môi trường chuyên dụng, chạy:

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

Nếu khách hàng MCP khởi động uvx, bao gồm phần mở rộng trình duyệt trong đối số gói:

{
  "mcpServers": {
    "capsolver-browser": {
      "command": "uvx",
      "args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Playwright vẫn cần phiên bản Chromium tương thích trên cùng máy tính. Đối với quy trình sản xuất, cố định phiên bản, kiểm tra nâng cấp trong môi trường thử nghiệm và giữ cài đặt trình duyệt tách biệt với bí mật ứng dụng.

Các Vấn Đề Cài Đặt Thường Gặp

Hầu hết các lỗi kết nối CapSolver MCP đến từ đường dẫn chạy, phiên bản Python, thiếu thông tin xác thực hoặc phụ thuộc trình duyệt tùy chọn.

Khách hàng báo spawn uvx ENOENT

Ứng dụng desktop không thể thấy uvx trên đường dẫn của nó. Sử dụng đường dẫn tuyệt đối uvx trong trường command, sau đó khởi động lại ứng dụng hoàn toàn.

Máy chủ khởi động nhưng công cụ thất bại xác thực

Giá trị CAPSOLVER_API_KEY bị thiếu, sai định dạng hoặc không đến được quy trình con. Xác nhận tên biến chính xác, thay thế chỗ trống và tránh thêm dấu ngoặc kép bên trong giá trị JSON.

detect_captchas hoặc solve_on_page không khả dụng

Gói cơ bản không cài đặt Playwright. Cài đặt capsolver-mcp[browser], cài đặt Chromium và khởi động lại khách hàng để nó khởi động môi trường cập nhật.

Registry hiển thị nhiều hơn một kết quả CapSolver

API tìm kiếm Registry có thể trả về nhiều phiên bản được công bố của cùng máy chủ. Chọn bản ghi có isLatest là true, hoặc truy vấn điểm cuối phiên bản chính xác thay vì xem số lượng kết quả là kiểm tra duy nhất.

Khách hàng kết nối nhưng yêu cầu giải bị lỗi

Tách biệt các vấn đề kết nối khỏi các vấn đề nhiệm vụ. Trước tiên xác minh phát hiện công cụ và get_balance; sau đó kiểm tra loại nhiệm vụ, URL trang web, khóa trang, trường tùy chọn và số dư tài khoản theo https://docs.capsolver.com/en/.

Giới Hạn Vận Hành và Sử Dụng Có Trách Nhiệm

CapSolver MCP là giao diện công cụ cục bộ, không phải quyền tự động hóa mục tiêu. Sử dụng nó chỉ trên các trang web và hệ thống bạn sở hữu hoặc được phép kiểm tra hoặc tự động hóa. Tuân theo các điều khoản, yêu cầu bảo mật, giới hạn tốc độ và quy định lưu trữ dữ liệu.

Registry Chính thức xác nhận dữ liệu do nhà phát hành kiểm soát và vị trí gói; nó không thay thế cho đánh giá bảo mật của bạn. Kiểm tra kho lưu trữ nguồn CapSolver MCP, cố định phiên bản khi quy trình thay đổi của bạn yêu cầu, bảo vệ khóa API và kiểm tra cập nhật trước khi triển khai rộng rãi.

Đối với các quyết định kiến trúc vượt quá một khách hàng, xem cách các đội AI-agent doanh nghiệp cấu trúc xử lý thử thách được phê duyệt và xem định nghĩa của điểm cuối API khi thiết kế ranh giới dịch vụ.

Kết Luận

Registry MCP Chính thức hiện nay cung cấp hồ sơ chuẩn, có thể tìm kiếm cho CapSolver MCP, trong khi PyPI cung cấp gói Python thực thi. Một thiết lập đáng tin cậy tuân theo chuỗi ngắn: xác minh danh tính registry, chạy CLI, thêm CAPSOLVER_API_KEY vào môi trường khách hàng, khởi động lại khách hàng và xác minh phát hiện công cụ trước khi thực hiện nhiệm vụ được phê duyệt.

Sử dụng CapSolver để thêm các công cụ giải CAPTCHA được tài liệu vào các quy trình AI-agent và tự động hóa trình duyệt được hỗ trợ.

Xây Dựng Các Quy Trình Tự Động Hóa Tin Cậy Với CapSolver

Tạo tài khoản, lưu khóa API an toàn và bắt đầu với kiểm tra giới hạn trên trang web hoặc hệ thống bạn được phép tự động hóa. FAQ CapSolver giải đáp các câu hỏi phổ biến về sản phẩm và tài khoản trước khi di chuyển tích hợp vào sản xuất.

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

Câu hỏi: CapSolver MCP có sẵn trong Registry MCP Chính thức không?

Có. Tên registry là io.github.capsolver-ai/capsolver-mcp, và phiên bản 0.1.3 hiện đang hoạt động và được ghi nhận là phiên bản mới nhất.

Câu hỏi: Cài đặt từ Registry tạo ra kết nối từ xa được lưu trữ không?

Không. Bản ghi registry hiện tại mô tả một gói PyPI được khởi động cục bộ với uvx qua stdio; nó không quảng bá điểm cuối MCP được lưu trữ bởi CapSolver.

Câu hỏi: Tôi có cần cài đặt capsolver-mcp toàn cục không?

Không. uvx capsolver-mcp chạy công cụ trong môi trường cô lập, trong khi pip install rõ ràng vẫn có sẵn cho các nhóm quản lý môi trường ảo của riêng họ.

Câu hỏi: Tại sao khách hàng của tôi kết nối nhưng không hiển thị công cụ trình duyệt?

Các công cụ trình duyệt yêu cầu phần mở rộng capsolver-mcp[browser] và cài đặt Chromium Playwright. Khởi động lại khách hàng sau khi cài đặt cả hai thành phần.

Câu hỏi: Biến môi trường nào CapSolver MCP yêu cầu?

CapSolver MCP yêu cầu CAPSOLVER_API_KEY. Truyền nó qua môi trường khách hàng và giữ giá trị thực tế ngoài kiểm soát nguồn và hình ảnh chụp màn hình hỗ trợ.

Câu hỏi: Tôi có thể sử dụng CapSolver MCP trên bất kỳ trang web nào không?

Không. Sử dụng CapSolver MCP chỉ trên các trang web và hệ thống bạn sở hữu hoặc được phép kiểm tra hoặc tự động hóa, và tuân theo các điều khoản, quy định bảo mật và yêu cầu pháp lý liên quan.