Kết nối Trợ lý AI với Khóa API
Không phải mọi trợ lý AI nào cũng có thể đăng nhập vào FitnessSyncer MCP Server thay cho bạn. Nhiều trợ lý chỉ cung cấp địa chỉ máy chủ và một trường để nhập mã thông báo, trong khi một số khác đọc toàn bộ cấu hình từ một tệp trên đĩa. Đối với những trường hợp này, FitnessSyncer cấp một API Key, tức là một mã thông báo duy nhất có thời hạn dài, thay thế cho toàn bộ quá trình đăng nhập.
Đây là câu trả lời dành cho trợ lý tự lưu trữ, máy khách dòng lệnh, khung công tác đại lý hoặc ChatGPT cung cấp cho bạn một tiêu đề thay vì màn hình OAuth, và Mistral Vibe cũng chấp nhận điều này. Claude, ChatGPT, Gemini, Perplexity, Grok, Mistral Vibe và Home Assistant đều có quy trình đăng nhập riêng, do đó hãy ưu tiên tuân theo hướng dẫn cụ thể của từng ứng dụng khi áp dụng.
Trước khi bắt đầu
- Một tài khoản FitnessSyncer đã kết nối với các nguồn dữ liệu của bạn. MCP Server được bao gồm trong mọi tài khoản, vì vậy bạn không cần mua thêm bất kỳ thứ gì; hãy xem phần Bắt đầu nếu bạn là người mới. Tài khoản miễn phí có phạm vi lịch sử dữ liệu ngắn hơn ở đây, giống hệt như ở mọi nơi khác trên trang web.
- Một trợ lý có thể gửi tiêu đề Authorization, hoặc gọi nó là Bearer Token hoặc API token. Nếu ứng dụng của bạn có thể đăng nhập bằng OAuth thay thế, đó là phương án tốt hơn, vì bạn có thể chọn quyền truy cập từng lần thay vì chỉ một lần duy nhất.
Khóa API là mật khẩu cho các quyền mà bạn cấp cho nó, và nó không tự hết hạn. Chỉ nên nhập khóa này vào một ứng dụng mà bạn tin tưởng để quản lý dữ liệu sức khỏe của mình, và chỉ cấp cho nó mức quyền tối thiểu cần thiết.
Bước 1: Tạo khóa API của bạn trên FitnessSyncer
- Truy cập trang Tài khoản Nhà phát triển.
- Ở cuối trang, chọn “MCP: API Key” từ danh sách và nhấp vào “Tạo”.
- FitnessSyncer hỏi quyền nào mà khóa này nên có. Chỉ chọn những quyền mà bạn muốn trợ lý thực hiện; để trả lời các câu hỏi, quyền đọc là đủ, và bất kỳ quyền nào bạn không chọn đều không thể được sử dụng sau này mà không tạo một khóa mới.
- Chọn "Tạo khóa API" và ghi lại khóa API trên trang tiếp theo. Khóa này chỉ được hiển thị một lần duy nhất; nếu bạn làm mất nó, bạn có thể tạo lại, nhưng sau đó bạn sẽ cần nhập lại khóa này vào ứng dụng của mình.
Bước 2: Thêm FitnessSyncer vào Mistral Vibe
Khi đã có API Key trong tay:
- Từ menu bên trái, chọn Context rồi chọn Connectors.
- Chọn "Thêm kết nối" ở góc trên bên phải màn hình.
- Chọn Bộ kết nối tùy chỉnh MCP.
- Nhập "FitnessSyncer" vào ô "Tên"
- Nhập https://www.fitnesssyncer.com/services/mcp vào trường Server
- Chọn "Xác thực bằng API Token" và dán API Key của bạn vào trường "Bearer Token".
Bước 2: Bất kỳ trợ lý nào khác có màn hình cài đặt
Các trường này có tên gọi khác nhau tùy theo từng trợ lý, nhưng chỉ bao gồm ba trường sau:
- Nhập "FitnessSyncer" vào ô "Tên"
- Nhập https://www.fitnesssyncer.com/services/mcp vào trường Server (mà một số trợ lý gọi là URL máy chủ từ xa MCP)
- Nhập API Key của bạn vào trường Bearer Token. Nếu trợ lý yêu cầu một header thay vì trường này, tên header là Authorization và giá trị của nó là từ Bearer, một khoảng trống, và API Key của bạn.
Nếu trợ lý cũng yêu cầu bạn chọn phương thức truyền tải, hãy chọn Streamable HTTP. FitnessSyncer không hỗ trợ phương thức truyền tải SSE cũ.
Bước 2: Một trợ lý được cấu hình từ một tệp
Nhiều ứng dụng dòng lệnh và ứng dụng máy tính để bàn đọc dữ liệu từ máy chủ thông qua một tệp JSON. Cấu trúc có thể khác nhau, vì vậy hãy tham khảo tài liệu hướng dẫn của trợ lý của bạn, nhưng thông thường nó trông như sau:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Hãy thay thế YOUR_TOKEN_HERE bằng API Key của bạn, đồng thời giữ nguyên từ "Bearer" và khoảng trống phía trước nó.
Hãy thử xem
Bắt đầu một cuộc trò chuyện mới và dán bất kỳ nội dung nào sau đây để kiểm tra xem mọi thứ có hoạt động bình thường không:
- Liệt kê tất cả các ứng dụng và thiết bị FitnessSyncer hiện đang được kết nối với tài khoản của tôi và hiển thị thời điểm lần đồng bộ hóa gần nhất.
- Tuần này tôi ngủ thế nào so với tuần trước?
- Nhịp tim khi nghỉ ngơi của tôi đã thay đổi như thế nào trong tháng qua?
Còn rất nhiều ý tưởng khác trên trang MCP Server.
Trợ lý AI của bạn giải thích các chỉ số của bạn dựa trên các hướng dẫn công khai; đây không phải là lời khuyên y tế.
Tôi nên sử dụng API Key hay đăng nhập?
Hãy đăng nhập ở nơi trợ lý của bạn hỗ trợ tính năng này. Khi đăng nhập bằng OAuth, hệ thống sẽ yêu cầu bạn chọn các quyền cần cấp tại thời điểm kết nối, và quyền này có thể bị thu hồi đối với kết nối đó; trong khi đó, API Key sẽ giữ nguyên các quyền bạn đã chọn khi tạo ra nó, miễn là nó còn tồn tại.
Sử dụng Khóa API khi trợ lý không thể đăng nhập, điều này thường xảy ra với hầu hết các khách hàng được cấu hình từ tệp.
Tôi có thể thay đổi các quyền hạn của API Key không?
Không thể thay đổi sau khi đã tạo. Quyền truy cập được xác định cố định khi khóa được tạo, vì vậy để mở rộng hoặc thu hẹp phạm vi quyền, hãy xóa khóa đó trong phần Cấu hình Nhà phát triển và tạo một khóa mới với các quyền bạn mong muốn. Trợ lý của bạn sau đó sẽ cần sử dụng khóa mới này.
Tôi đã mất khóa API. Giờ phải làm sao?
Khóa chỉ được hiển thị khi được tạo ra, do đó không có gì để tra cứu. Hãy tạo lại khóa trong phần Cấu hình Nhà phát triển và nhập khóa mới vào trợ lý của bạn. Khóa cũ sẽ ngừng hoạt động ngay khi bạn tạo lại, đây cũng là cách để khóa truy cập đối với một trợ lý mà bạn không còn tin tưởng.
Làm thế nào để ngắt kết nối trợ lý?
Hãy gỡ bỏ kết nối trong Trợ lý, sau đó xóa khóa trong Cấu hình Nhà phát triển. Việc xóa khóa là bước quan trọng nhất, vì nếu không, bất kỳ thành phần nào vẫn giữ khóa đó sẽ tiếp tục hoạt động bình thường.
