使用支持 Streamable HTTP 以及使用 PKCE 预注册 OAuth 或配置的承载令牌的 MCP 客户端。客户支持各不相同；自动客户端注册不可用。
MCP服务器URL
https://api.remotegymp.com/mcp对于自托管，请在安装的公共 HTTPS 地址上使用相同的 MCP 路径。您的客户必须能够达到目标。云地址不会代理对您的安装的请求。
使用 OAuth 连接
- 在“设置”中，创建启用了 MCP 且仅具有助理所需权限的凭证。注册您的客户端提供的确切回调 URL。使用凭据用户名作为 OAuth 客户端 ID。此流程不使用客户端密钥。
- 回调必须在显式环回地址上使用 HTTPS 或 HTTP。完整的 URL 必须匹配，包括端口。要更改它，请创建一个新凭据并撤销旧凭据。
- 从您的客户端连接，以创建凭据的所有者身份登录并查看同意屏幕。客户端必须使用 S256 PKCE 和 MCP 资源 URL。同意可以缩小凭证的权限；它无法添加权限。
云 OAuth 端点
- 授权
https://app.remotegymp.com/integration/oauth/authorize- 代币兑换
https://app.remotegymp.com/integration/oauth/token- 授权服务器元数据
https://app.remotegymp.com/.well-known/oauth-authorization-server- 受保护的资源元数据
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp
OAuth 使用标准令牌字段名称和轮换刷新令牌。客户端应该自动处理刷新。访问令牌最多持续 30 分钟。连接在 7 天无刷新或总共 30 天后过期。重复使用旧的刷新令牌会使连接失效；重新连接而不是重播。
使用不记名令牌连接
如果您的客户端支持配置的不记名令牌，请在令牌端点与 MCP 受众交换启用 MCP 的凭证，然后将返回的令牌放入客户端的安全不记名令牌设置中。 30 分钟后过期。不要在服务器 URL 中放置令牌。对于需要自动刷新的客户端使用 OAuth。
{
"username": "<your-credential-username>",
"password": "<your-credential-secret>",
"audience": "mcp"
}工作前检查访问权限
要求客户首先列出其可用的工具和阅读功能。从只读请求开始，例如列出设备。缺少的工具可能反映权限、范围或可用性。单独启用 MCP 并不能授予远程控制权限。
tools/list · get_capabilities
屏幕观看须经设备同意。屏幕输入需要新的屏幕截图。在批准工作之前审查目标、删除预览和引用的人工智能成本。紧急停止阻止进一步的自动化；已经运行的工作可能会完成。
断开连接或撤销访问
当不再需要时，在客户端中断开连接并在“设置”中撤销该凭据。撤销会在后续请求中停止其关联的令牌和 OAuth 连接。切勿在不相关的集成之间共享凭证。