RemoteGymp · API v1

Kết nối trợ lý AI

Sử dụng ứng dụng khách MCP hỗ trợ HTTP có thể phát trực tuyến và OAuth được đăng ký trước với PKCE hoặc mã thông báo mang được định cấu hình. Hỗ trợ khách hàng khác nhau; đăng ký khách hàng tự động không có sẵn.

URL máy chủ MCP

https://api.remotegymp.com/mcp

Đối với Tự lưu trữ, hãy sử dụng cùng một đường dẫn MCP trên địa chỉ HTTPS công khai của cài đặt của bạn. Khách hàng của bạn phải có khả năng tiếp cận được nó. Địa chỉ Đám mây không yêu cầu ủy quyền cho cài đặt của bạn.

Kết nối với OAuth

  1. Trong Cài đặt, tạo thông tin xác thực có bật MCP và chỉ các quyền mà trợ lý cần. Đăng ký URL gọi lại chính xác do khách hàng của bạn cung cấp. Sử dụng tên người dùng thông tin xác thực làm ID ứng dụng khách OAuth. Luồng này không sử dụng bí mật của khách hàng.
  2. Cuộc gọi lại phải sử dụng HTTPS hoặc HTTP trên địa chỉ vòng lặp rõ ràng. URL đầy đủ phải khớp, bao gồm cả cổng. Để thay đổi nó, hãy tạo thông tin xác thực mới và thu hồi thông tin xác thực cũ.
  3. Kết nối từ khách hàng của bạn, đăng nhập với tư cách là Chủ sở hữu đã tạo thông tin xác thực và xem lại màn hình đồng ý. Máy khách phải sử dụng S256 PKCE và URL tài nguyên MCP. Sự đồng ý có thể thu hẹp quyền của thông tin xác thực; nó không thể thêm quyền.

Điểm cuối đám mây OAuth

Ủy quyền
https://app.remotegymp.com/integration/oauth/authorize
Trao đổi token
https://app.remotegymp.com/integration/oauth/token
Siêu dữ liệu máy chủ ủy quyền
https://app.remotegymp.com/.well-known/oauth-authorization-server
Siêu dữ liệu tài nguyên được bảo vệ
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth sử dụng tên trường mã thông báo tiêu chuẩn và mã thông báo làm mới luân phiên. Máy khách sẽ tự động xử lý việc làm mới. Mã thông báo truy cập kéo dài tối đa 30 phút. Các kết nối sẽ hết hạn sau bảy ngày nếu không được làm mới hoặc tổng cộng là 30 ngày. Việc sử dụng lại mã thông báo làm mới cũ sẽ làm mất hiệu lực kết nối; kết nối lại thay vì phát lại nó.

Kết nối bằng mã thông báo mang

Nếu khách hàng của bạn hỗ trợ mã thông báo mang được định cấu hình, hãy trao đổi thông tin xác thực hỗ trợ MCP ở điểm cuối mã thông báo với đối tượng MCP, sau đó đặt mã thông báo được trả về vào cài đặt mã thông báo mang an toàn của khách hàng. Nó hết hạn sau 30 phút. Không đặt mã thông báo vào URL máy chủ. Sử dụng OAuth cho các ứng dụng khách cần làm mới tự động.

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

Xác thực →

Kiểm tra quyền truy cập trước khi thực hiện công việc

Yêu cầu khách hàng liệt kê các công cụ có sẵn và khả năng đọc trước. Bắt đầu với yêu cầu chỉ đọc, chẳng hạn như liệt kê các thiết bị. Một công cụ vắng mặt có thể phản ánh quyền, phạm vi hoặc tính khả dụng. Chỉ kích hoạt MCP không cấp quyền điều khiển từ xa.

tools/list · get_capabilities

Việc xem màn hình phải tuân theo sự đồng ý của thiết bị. Đầu vào màn hình cần một ảnh chụp màn hình mới. Xem xét mục tiêu, xem trước xóa và báo giá chi phí AI trước khi phê duyệt công việc. Việc dừng khẩn cấp ngăn chặn tự động hóa hơn nữa; công việc đang chạy có thể kết thúc.

Ngắt kết nối hoặc thu hồi quyền truy cập

Ngắt kết nối trong ứng dụng khách của bạn và thu hồi thông tin xác thực trong Cài đặt khi không còn cần thiết. Việc thu hồi sẽ dừng các mã thông báo liên quan và kết nối OAuth trong các yêu cầu tiếp theo. Không bao giờ chia sẻ thông tin xác thực giữa các tích hợp không liên quan.

3f225a253 sửa đổi nội dung · OpenAPI SHA-256: b12c42306a89