Cách thiết lập công cụ MCP giải CAPTCHA trong Qwen Code

Tóm tắt nhanh

• Qwen Code có thể kết nối tới dịch vụ MCP CapSolver chính thức như một tiến trình local dùng stdio.
• Thêm máy chủ vào .qwen/settings.json của dự án, sử dụng Python executable từ môi trường đã cài đặt các package.
• Xem lại và chấp thuận máy chủ dự án, sau đó chạy qwen mcp list để kiểm tra kết nối.
• Máy chủ đã kết nối sẽ cung cấp các công cụ; điều này không chứng minh rằng một yêu cầu CAPTCHA trả phí hoặc việc gửi form qua trình duyệt đã thành công.
• Dùng các công cụ token cho tham số CAPTCHA tường minh và công cụ trình duyệt cho trang được dịch vụ đó quản lý. Các máy chủ MCP riêng biệt không tự động chia sẻ cùng một tab trình duyệt.

Qwen Code là một tác nhân lập trình mã nguồn mở chạy trong terminal. Nhà phát triển có thể dùng nó để làm việc với mã ứng dụng và gọi các công cụ đã kết nối. Khi một quy trình trình duyệt đã được cấp quyền gặp CAPTCHA, chỉ riêng mô hình lập trình không thể tự cung cấp lời giải CAPTCHA. Một trình giải CAPTCHA cần có các đầu vào thử thách liên quan và một nơi rõ ràng để trả kết quả về.

CapSolver cung cấp các khả năng đó thông qua dịch vụ MCP chính thức. Hướng dẫn này kết nối dịch vụ đó với Qwen Code, kiểm tra việc client có thể truy cập tới nó, và giải thích cách chọn công cụ phù hợp. Ví dụ kết nối không yêu cầu mô hình phải tự ứng biến mã Python hoặc bịa ra payload API.

Tích hợp Qwen Code mang lại điều gì

Tích hợp này cho phép Qwen Code truy cập tới một dịch vụ riêng biệt triển khai các công cụ liên quan đến CAPTCHA. Qwen Code vẫn là client tìm kiếm công cụ và gửi yêu cầu hành động; dịch vụ sẽ xử lý các thao tác giải CAPTCHA được tài liệu hóa.

Dự án Qwen Code chính thức mô tả sản phẩm như một tác nhân lập trình trong terminal. MCP mở rộng môi trường đó bằng các khả năng do máy chủ cung cấp. Cài một máy chủ CAPTCHA không biến mọi tác vụ lập trình thành tác vụ trình duyệt, và việc chỉnh sửa mã thông thường không cần trình giải CAPTCHA.

Một trường hợp hữu ích là khi nhà phát triển đang kiểm tra một quy trình trình duyệt hợp lệ nhưng bước tiếp theo bị chặn bởi CAPTCHA. Nhà phát triển có thể xem thử thách, chọn một thao tác được hỗ trợ và giữ kết quả gắn với trang đó. Phạm vi này hẹp hơn so với việc yêu cầu tác nhân làm cho toàn bộ website trở nên truy cập được.

Nếu MCP còn mới trong quy trình làm việc của bạn, sự khác biệt giữa client và một lời gọi API là quan trọng: mô tả công cụ quảng bá một thao tác, còn lời gọi thực tế mới thực hiện thao tác đó. Trạng thái kết nối mô tả khả năng sẵn sàng, chứ không phải sự thành công của mọi thao tác đã quảng bá.

Chuẩn bị client và môi trường Python

Chuẩn bị Qwen Code và một môi trường Python có chứa máy chủ chính thức trước khi chỉnh sửa cấu hình dự án.

Kết nối được mô tả ở đây sử dụng Qwen Code 0.26.1 với capsolver-core 0.1.1 và capsolver-mcp 0.1.3. Gói Qwen Code yêu cầu Node.js 22 trở lên. Hãy làm theo hướng dẫn cài đặt chính thức nếu lệnh qwen chưa khả dụng.

Cài các gói solver trong môi trường Python mà bạn muốn Qwen Code khởi chạy:

python -m pip install capsolver-core==0.1.1 capsolver-mcp==0.1.3

Hướng dẫn cài đặt MCP chính thức cũng mô tả browser extra và cài đặt Chromium. Các phụ thuộc đó cần thiết cho việc phát hiện dựa trên trình duyệt và giải trang. Chúng tách biệt với việc thiết lập kết nối stdio.

Một khóa API CapSolver hợp lệ và số dư tài khoản đủ là điều kiện tiên quyết cho việc giải CAPTCHA trả phí. Quyền truy cập mô hình trong Qwen Code là một điều kiện tiên quyết riêng khác cho việc dùng công cụ theo kiểu hội thoại. Bài kiểm tra kết nối dưới đây chỉ kiểm tra khởi động máy chủ và kết nối; nó không gửi yêu cầu giải trả phí hay chạy tác vụ do mô hình điều khiển.

Giữ khóa tài khoản trong môi trường dùng để khởi chạy Qwen Code. Không dán giá trị thật vào cấu hình dự án được theo dõi hoặc vào bài viết, issue, ảnh chụp màn hình, hay bản ghi hội thoại được chia sẻ.

Cấu hình máy chủ trong dự án

Thêm một mục capsolver vào đối tượng mcpServers trong .qwen/settings.json ở thư mục gốc dự án.

Tài liệu Qwen Code mô tả cả cấu hình dự án và cơ chế thay thế biến môi trường trong tài liệu thiết lập MCP. Hãy gộp mục này vào các thiết lập hiện có thay vì thay thế các máy chủ hoặc tùy chọn dự án khác.

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

Thay đường dẫn executable bằng đường dẫn Python thực tế bên trong môi trường đã cài đặt. Đường dẫn tuyệt đối giúp tránh việc terminal, editor hoặc trình khởi chạy dịch vụ tìm đến một bản cài Python khác thông qua đường dẫn tìm kiếm riêng của chúng. Giữ nguyên đường dẫn tới virtual environment; nếu bạn giải symlink tới interpreter gốc, bạn có thể chọn phải interpreter không có các gói cần thiết.

Placeholder là tham chiếu đến biến môi trường, không phải khóa API. Biến này phải tồn tại trong môi trường tiến trình khi Qwen Code khởi động. Một khóa được đặt trong một terminal không tự động khả dụng cho một client được khởi chạy ở nơi khác.

Cấu hình này dùng stdio: Qwen Code khởi chạy module Python như một tiến trình local. Nó không cần endpoint HTTP công khai, cổng được mở, hay thông tin xác thực MCP CMS được dùng bởi quy trình xuất bản nội dung.

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

Tăng ngân sách tự động hóa ngay lập tức!
Dùng mã thưởng CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% bonus cho mỗi lần nạp — không giới hạn.
Đổi mã ngay trong Bảng điều khiển CapSolver

Chấp thuận và xác minh kết nối thực sự

Chấp thuận máy chủ dự án đã được xem xét, sau đó kiểm tra kết nối từ cùng thư mục dự án.

qwen mcp approve capsolver
qwen mcp list

Với phiên bản client đã kiểm tra, một mục dự án chưa được chấp thuận sẽ hiển thị ở trạng thái chờ duyệt. Sau khi được chấp thuận, máy chủ có thể kết nối. Tín hiệu hữu ích mong đợi là mục capsolver ở trạng thái connected; dòng đó cũng cho biết executable và giao thức truyền.

Việc chấp thuận và trust phục vụ những mục đích khác nhau. Chấp thuận một máy chủ đã được xem xét cho phép nó kết nối. Giữ trust là false sẽ giữ lại hành vi xác nhận khi gọi công cụ như bình thường. Đừng đổi thiết lập đó chỉ để che giấu một vấn đề cấu hình.

Nếu kết nối thất bại, hãy kiểm tra đường dẫn executable trước, sau đó xác nhận rằng cùng môi trường Python đó có thể import các gói đã cài. Kiểm tra xem cấu hình nằm trong đúng dự án mà bạn đang mở. Tài liệu settings của Qwen giải thích các nguồn cấu hình; một mục trùng lặp ở nơi khác có thể làm rắc rối quá trình xử lý sự cố.

Kết nối thành công mà không có khóa giải CAPTCHA vẫn không chứng minh được khả năng truy cập tài khoản. Kiểm tra kết nối và thực hiện thao tác tính phí là hai phần khác nhau của hệ thống.

Chọn công cụ phù hợp với bước CAPTCHA

Chọn công cụ dựa trên thông tin và trạng thái trình duyệt sẵn có trong quy trình làm việc của bạn.

Dịch vụ chính thức cung cấp get_supported_captchas, get_balance, detect_captchas, solve_captcha, và solve_on_page. Hãy bắt đầu với danh sách kiểu CAPTCHA được hỗ trợ khi bạn cần xác nhận tên các khả năng của dịch vụ đã cài. Kiểm tra số dư riêng khi cần chẩn đoán tình trạng sẵn sàng của tài khoản.

Dùng solve_captcha khi quy trình đã có sẵn kiểu CAPTCHA và tham số site được tài liệu hóa. Kết quả của nó vẫn cần được ứng dụng yêu cầu CAPTCHA đó sử dụng. Với các tác vụ dựa trên token, việc nhận token không đồng nghĩa với việc tự động gửi form hoặc chứng minh rằng website chấp nhận yêu cầu.

Chỉ dùng các công cụ trình duyệt với thiết lập trình duyệt được tài liệu hóa của chúng. detect_captchas kiểm tra một URL trang. solve_on_page kết hợp phát hiện, giải CAPTCHA, và điền lại trong quy trình trình duyệt của dịch vụ. Tên của chúng không hề hứa hẹn truy cập vào một tab thuộc về máy chủ MCP khác.

Với lần kiểm tra hội thoại ban đầu, hãy yêu cầu Qwen Code liệt kê các loại CAPTCHA được hỗ trợ thông qua máy chủ đã cấu hình. Với một tác vụ trang được cấp phép, hãy nêu rõ trang và thao tác được phép một cách chính xác, và xem lại công cụ cùng tham số được chọn trước khi thực thi. Tránh các chỉ dẫn mở kiểu “tiếp tục thử cho đến khi site cho phép truy cập”.

Giữ việc bàn giao giữa các trình duyệt thật tường minh

Việc bàn giao giữa các trình duyệt phải giữ lại ngữ cảnh cần thiết cho tác vụ. Chỉ một URL có thể không tái tạo được trang vốn được truy cập thông qua các tương tác trước đó.

Nếu tự động hóa trình duyệt hiện tại của bạn đang điều khiển một trang sống, hãy quyết định xem bạn cần một token cho quy trình đó hay cần tích hợp SDK với trang đó. Đừng cho rằng việc thêm hai máy chủ MCP sẽ gộp chung session, cookie, tab hoặc trạng thái JavaScript của chúng.

Hướng dẫn tích hợp Core SDK mô tả tích hợp trực tiếp với trình duyệt. Đó có thể là lựa chọn phù hợp khi ứng dụng cần giữ lại một đối tượng trang hiện có. Bài viết về phân biệt token và cookie cũng giúp làm rõ sự khác nhau giữa artifact mà trình giải CAPTCHA trả về với trạng thái rộng hơn của một phiên trình duyệt.

Trước khi coi một quy trình là hoàn tất, hãy kiểm tra kết quả trong ứng dụng. Biểu mẫu mong đợi đã được chấp nhận chưa? Trang được phép truy cập có chuyển đến trạng thái dự định không? Một máy chủ đã kết nối, một widget được phát hiện, và một yêu cầu ứng dụng được chấp thuận là những cột mốc khác nhau.

Xây dựng quy trình tự động hóa đáng tin cậy với CapSolver

Kết nối dịch vụ chính thức, kiểm tra các công cụ, và bắt đầu với một thao tác có phạm vi rõ ràng phù hợp với CAPTCHA trong quy trình làm việc của bạn. CapSolver có thể cung cấp bước giải CAPTCHA được tài liệu hóa trong khi Qwen Code vẫn chịu trách nhiệm chọn và gọi công cụ trong phạm vi tác vụ bạn đã phê duyệt.

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

Hỏi: Qwen Code có sẵn trình giải CAPTCHA mặc định không?

Không. Hướng dẫn này thêm dịch vụ MCP CapSolver chính thức như một nhà cung cấp công cụ riêng. Mô hình của Qwen Code và tài khoản solver là hai thành phần tách biệt.

Hỏi: Tại sao máy chủ hiển thị ở trạng thái chờ chấp thuận (pending approval)?

Một mục MCP ở cấp dự án có thể yêu cầu chấp thuận trước khi Qwen Code kết nối. Hãy xem lại lệnh và cấu hình môi trường của nó, sau đó dùng lệnh chấp thuận được client bạn đã cài đặt hỗ trợ.

Hỏi: Tôi có thể kiểm tra kết nối mà không phải trả tiền cho CAPTCHA không?

Có. Kết nối máy chủ có thể được kiểm tra tách biệt với việc giải CAPTCHA trả phí. Trạng thái connected không xác minh số dư tài khoản, việc thực thi tác vụ trả phí, hoặc việc website chấp nhận lời giải.

Hỏi: Dịch vụ có dùng tab trình duyệt MCP khác của tôi không?

Đừng cho rằng có. Các máy chủ riêng biệt có các quy trình trình duyệt riêng trừ khi có tích hợp được tài liệu hóa kết nối chúng. Hãy chọn chế độ token hoặc tích hợp SDK trực tiếp khi bạn cần giữ nguyên một trang hiện có.

Hỏi: Tại sao các công cụ trình duyệt không khả dụng sau khi cài đặt?

Kiểm tra browser extra và các điều kiện tiên quyết về Chromium trong hướng dẫn MCP chính thức. Đồng thời kiểm tra bất kỳ bộ lọc công cụ phía client nào và liệu mục máy chủ mong đợi đã ở trạng thái connected hay chưa.

Hỏi: Thiết lập này có thể xử lý mọi CAPTCHA trên mọi trang không?

Không. Hãy sử dụng danh sách kiểu được hỗ trợ hiện tại và các tài liệu về tác vụ, và giới hạn thao tác ở những trang và quy trình mà bạn được phép tự động hóa. Một công cụ được quảng bá không phải là đảm bảo thành công trên mọi trang bất kỳ.