BẮT ĐẦU SỬ DỤNG

Kết nối AI với thư viện Appdo.

Appdo MCP cho ứng dụng AI truy cập dữ liệu nghiên cứu app, ảnh màn hình và template đã công bố qua một chuẩn kết nối chung.

Server URL

https://www.appdo.net/mcp

Trước khi bắt đầu

Bạn cần tài khoản Appdo và ứng dụng hỗ trợ Streamable HTTP cùng OAuth. Đây là hướng dẫn cấu hình; hãy hoàn tất đăng nhập và gọi thử công cụ để xác nhận kết nối của bạn.

1. Kết nối ứng dụng AI

Chọn ứng dụng đang dùng. Cấu hình chỉ chứa URL máy chủ; xác thực được xử lý qua luồng đăng nhập của ứng dụng.

01
Thêm Appdo
Chạy trong Terminal có cài Codex CLI.
Terminal
```
codex mcp add appdo --url https://www.appdo.net/mcp
```
02
Đăng nhập tài khoản
Mở liên kết đăng nhập do Codex cung cấp. Đăng nhập Appdo và xem quyền truy cập trước khi chấp thuận.
Terminal · OAuth
```
codex mcp login appdo
```
03
Thử yêu cầu đầu tiên
Quay lại ứng dụng AI. Phản hồi công cụ thành công là dấu hiệu kết nối đã hoạt động.
Prompt đầu tiên
```
Dùng Appdo MCP. Gọi get_capabilities, sau đó tìm template Learning Language AI bằng list_templates.
```

Với ứng dụng tương thích khác, chọn máy chủ HTTP từ xa và dán URL phía trên. Đăng nhập theo hướng dẫn OAuth của ứng dụng đó.

2. Thử với Learning Language AI

Template này liên kết tới chín ảnh bản mẫu Appdo đã rà soát: hai biến thể giao diện chào mừng và bảy ảnh trạng thái hoặc theme của luồng luyện nói. Đây không phải chín route riêng hay toàn bộ onboarding.

Prompt nghiên cứu template

Dùng Appdo MCP. Gọi get_capabilities, sau đó get_template với slug learning-language-ai. Theo design_library để xem các màn hình Speaking Practice. Tóm tắt luồng chủ đề → hội thoại → gợi ý → tổng kết, dẫn screen_ref và đề xuất ba cải tiến dựa trên ảnh đã xem.

get_capabilities — kiểm tra nguồn dữ liệu và độ mới.
get_template — dùng slug learning-language-ai, sau đó theo design_library.
list_app_screens — app_id: market:appdo-learning-language-ai, flow: speaking-practice.
get_screen — truyền screen_ref nhận được và mở ảnh trước khi đề xuất thiết kế.

Ảnh chụp là bản mẫu có câu trả lời dựng sẵn và lớp công cụ phát triển; không phải bằng chứng nhận diện giọng nói hoặc chấm điểm AI.

Xem template

3. Danh sách 15 công cụ

AI chọn công cụ theo yêu cầu của bạn. Tất cả công cụ chỉ đọc dữ liệu, không sửa tài khoản hoặc phát hành ứng dụng.

Ứng dụng & màn hình

get_capabilities: Kiểm tra dữ liệu sẵn có, độ mới và giới hạn.
search_apps: Tìm ứng dụng bằng từ khóa và bộ lọc.
get_app: Đọc thông tin ứng dụng và các luồng đã ghi nhận.
list_app_screens: Xem ảnh màn hình theo thứ tự hành trình.
search_screens: Tìm màn hình theo từ khóa, luồng và nhãn UI.
get_screen: Mở ảnh, metadata và các ảnh liên quan từ screen_ref.

Luồng & thành phần UI

list_flows: Khám phá các luồng có trong thư viện.
get_flow_apps: Tìm ứng dụng có một luồng cụ thể.
list_ui_elements: Liệt kê các nhóm thành phần UI đã gắn nhãn.
get_element_screens: Xem màn hình có thành phần UI đã chọn.

Template & thư viện của bạn

list_templates: Tìm template Appdo đã công bố.
get_template: Xem chi tiết, demo, gallery và liên kết thư viện thiết kế.
list_my_boards: Liệt kê các nhóm đã lưu của tài khoản đang kết nối.
get_board: Đọc nội dung một nhóm đã lưu của bạn.
list_my_orders: Đọc đơn hàng của tài khoản đang kết nối.

4. Quyền truy cập, dữ liệu và giới hạn

Tài khoản của bạn: Nhóm đã lưu và đơn hàng thuộc tài khoản đã cấp quyền qua OAuth. MCP không trả tệp mã nguồn trả phí, đường dẫn lưu trữ riêng tư hoặc thông tin xác thực.
Lượt sử dụng: v1 chưa có cơ chế tính phí credit. Giới hạn là 90 lượt gọi/phút/người dùng trên mỗi tiến trình máy chủ. Xem get_capabilities để biết giới hạn hiện tại. Phí mua template và phí ứng dụng AI áp dụng riêng.
Chất lượng dữ liệu: Doanh thu và lượt tải là ước tính. Trường thiếu là chưa biết. Ảnh có thể chỉ bao phủ một phần hành trình; ảnh liên quan dựa trên metadata, không phải điểm tương đồng thị giác. Tìm kiếm dùng từ khóa, chưa hỗ trợ ngữ nghĩa.
Phân trang: Theo next_cursor và giữ nguyên bộ lọc. Trang nghiên cứu mặc định 10 mục (tối đa 20); danh sách template và đơn hàng cho phép 50. Cursor hết hạn sau một giờ. URL ảnh có thể không còn truy cập được; gọi lại get_screen bằng screen_ref đã lưu.
Ngắt kết nối: Tắt hoặc xóa appdo trong ứng dụng AI. Với Codex CLI, dùng codex mcp logout appdo để xóa thông tin OAuth đã lưu tại client đó. Xóa cấu hình server không đồng nghĩa thu hồi mọi phiên trên các client khác.

5. Xử lý lỗi thường gặp

Mở URL thấy 401 / Unauthorized

Địa chỉ /mcp là API dành cho ứng dụng AI. Mở URL trong trình duyệt không thay thế đăng nhập. Hãy thêm server trong ứng dụng và hoàn tất OAuth; không dán API key vào cấu hình.

Đăng nhập lỗi hoặc lặp lại

Kiểm tra URL là https://www.appdo.net/mcp. Kết nối lại server appdo và hoàn tất màn hình chấp thuận trong trình duyệt. Nếu đang dùng nhầm tài khoản Appdo, đăng xuất tài khoản đó trước. Cập nhật ứng dụng nếu chưa hỗ trợ MCP qua HTTP và OAuth.

Không thấy công cụ

Kiểm tra appdo đã bật, hoàn tất đăng nhập, rồi làm mới danh sách công cụ hoặc mở chat mới. Thử get_capabilities trước. Lưu cấu hình chưa có nghĩa là kết nối đã thành công.

Không có ảnh phù hợp hoặc nguồn chưa tải được

Xem độ mới và trạng thái nguồn bằng get_capabilities, thử từ khóa ngắn hơn và bỏ bớt bộ lọc. Không phải app nào cũng có mọi luồng. Nguồn lỗi khác với thư viện rỗng; hãy thử lại sau.

INVALID_CURSOR

Bắt đầu lại từ trang đầu. Theo next_cursor tuần tự, giữ nguyên bộ lọc và kích thước trang. Cursor hết hạn sau một giờ và có thể mất hiệu lực khi server khởi động lại hoặc cập nhật.

Quá nhiều yêu cầu / 429

Tạm dừng theo hướng dẫn thử lại mà công cụ trả về. Tránh gọi lặp liên tục hoặc quét toàn bộ thư viện. Giới hạn v1 hiện tại được công bố trong get_capabilities.

Nhóm đã lưu hoặc đơn hàng trống

Các công cụ dùng tài khoản bạn đã cấp quyền trong ứng dụng AI, có thể khác tài khoản đang mở trên trình duyệt. Kiểm tra đúng tài khoản và tài khoản đó đã có nội dung lưu hoặc đơn hàng chưa.

Vẫn cần hỗ trợ? Gửi tên ứng dụng, thông báo lỗi và thời điểm gặp lỗi cho Appdo. Xóa token và thông tin riêng tư trước khi chia sẻ log. Liên hệ hỗ trợ →