Đây là gì?
Xây dựng ứng dụng kết nối với dữ liệu người dùng COROS thông qua Model Context Protocol (MCP) với xác thực OAuth 2.0. Ko cần đăng ký ứng dụng hay phê duyệt. Triển khai OAuth 2.0 trong ứng dụng của bạn, và người dùng có thể kết nối tài khoản COROS của họ và cấp quyền truy cập dữ liệu cá nhân.
Cách hoạt động
- Bạn triển khai luồng ủy quyền OAuth 2.0 trong ứng dụng, trỏ đến endpoint MCP của COROS.
- Người dùng nhấn "Kết nối COROS" và đăng nhập tài khoản COROS của họ.
- Người dùng cấp quyền cho ứng dụng truy cập dữ liệu tập luyện của họ.
- Ứng dụng của bạn đọc dữ liệu tập luyện và ghi kế hoạch bài tập qua MCP.
Bạn có thể xây dựng gì
- Ứng dụng huấn luyện AI phân tích tập luyện và đề xuất bài tập
- Bảng điều khiển tập luyện và nền tảng phân tích
- Tích hợp sức khỏe và thể chất
- Công cụ tạo kế hoạch tập luyện cá nhân hóa
- Công cụ hồi phục và đánh giá sẵn sàng
Yêu cầu kỹ thuật
- Ứng dụng của bạn phải hỗ trợ luồng ủy quyền OAuth 2.0
- Endpoint máy chủ MCP: https://mcp.coros.com/mcp
- Tất cả truy cập dữ liệu chỉ giới hạn cho người dùng ủy quyền (một người dùng)
- Tài liệu MCP đầy đủ: COROS MCP GitHub
Để biết chi tiết triển khai luồng ủy quyền OAuth 2.0, tham khảo tài liệu chính thức: https://oauth.net/2/
COROS sử dụng giao thức OAuth 2.0 tiêu chuẩn. Bất kỳ thư viện client OAuth 2.0 nào bằng ngôn ngữ bạn chọn đều hoạt động.
Bắt đầu
- Bước 1: Triển khai luồng ủy quyền OAuth 2.0 trong ứng dụng, trỏ đến endpoint MCP của COROS.
- Bước 2: Thêm nút "Kết nối COROS" vào ứng dụng. Khi người dùng nhấn, họ đăng nhập và cấp quyền cho ứng dụng truy cập dữ liệu của họ.
- Bước 3: Bắt đầu xây dựng. Ứng dụng của bạn có thể đọc dữ liệu tập luyện và ghi kế hoạch bài tập cho người dùng ngay lập tức.
Các trường dữ liệu có sẵn
Các trường giống như Tier 1 (xem Kết nối COROS với AI của bạn). Bao gồm tất cả thao tác đọc và khả năng ghi kế hoạch tập luyện, bài tập.
Giới hạn
- Chỉ truy cập một người dùng (mỗi người dùng tự cấp quyền dữ liệu của họ)
- Ko có thông báo đẩy webhook (ứng dụng của bạn sẽ truy vấn MCP)
- Ko hỗ trợ nhập/xuất cung đường GPX
- Ko đồng bộ hoạt động hai chiều (COROS sang nền tảng của bạn cần Partner API)
Cần thêm?
Nếu nền tảng của bạn cần thông báo đẩy webhook, đồng bộ hai chiều, hoặc hỗ trợ cung đường GPX, bạn có thể đăng ký quyền truy cập đầy đủ Partner API.