RemoteGymp · API v1

AIアシスタントを接続する

Use an MCP client that supports Streamable HTTP and either pre-registered OAuth with PKCE or a configured bearer token. Client support varies; automatic client registration is not available.

MCP server URL

https://api.remotegymp.com/mcp

セルフホストの場合は、インストールのパブリック HTTPS アドレスで同じ MCP パスを使用します。 Your client must be able to reach it.クラウド アドレスは、インストールへのリクエストをプロキシしません。

Connect with OAuth

  1. [設定] で、MCP を有効にし、アシスタントに必要な権限のみを含む資格情報を作成します。クライアントから提供された正確なコールバック URL を登録します。認証情報のユーザー名を OAuth クライアント ID として使用します。このフローではクライアント シークレットを使用しません。
  2. コールバックでは、HTTPS、または明示的なループバック アドレス上の HTTP を使用する必要があります。 The full URL must match, including the port.これを変更するには、新しい認証情報を作成し、古い認証情報を取り消します。
  3. クライアントから接続し、資格情報を作成した所有者としてサインインし、同意画面を確認します。 The client must use S256 PKCE and the MCP resource URL. Consent can narrow the credential's permissions;権限を追加することはできません。

クラウド OAuth エンドポイント

Authorisation
https://app.remotegymp.com/integration/oauth/authorize
Token exchange
https://app.remotegymp.com/integration/oauth/token
Authorisation server metadata
https://app.remotegymp.com/.well-known/oauth-authorization-server
Protected resource metadata
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth は、標準のトークン フィールド名と循環リフレッシュ トークンを使用します。 The client should handle refresh automatically. Access tokens last at most 30 minutes.接続は、更新されない場合は 7 日後、または合計 30 日後に期限切れになります。古いリフレッシュ トークンを再利用すると接続が無効になります。 reconnect instead of replaying it.

ベアラートークンで接続する

クライアントが構成済みベアラー トークンをサポートしている場合は、トークン エンドポイントで MCP 対応の資格情報を MCP オーディエンスと交換し、返されたトークンをクライアントのセキュア ベアラー トークン設定に入れます。 30 分後に期限切れになります。 Do not put a token in the server URL.自動更新が必要なクライアントには OAuth を使用します。

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

認証 →

作業前にアクセスを確認する

クライアントに、利用可能なツールを一覧表示し、最初に機能を読み取るように依頼します。デバイスのリストなど、読み取り専用リクエストから始めます。存在しないツールは、権限、範囲、または可用性を反映している可能性があります。 MCP のみを有効にしても、リモート制御は許可されません。

tools/list · get_capabilities

画面の表示はデバイスの同意に従います。 Screen input needs a fresh screenshot.作業を承認する前に、ターゲット、削除プレビュー、見積もられた AI コストを確認します。 The emergency stop blocks further automation; work already running may finish.

Disconnect or revoke access

資格情報が必要なくなったら、クライアントで接続を切断し、設定で資格情報を取り消します。取り消しにより、後続のリクエストで関連するトークンと OAuth 接続が停止されます。無関係な統合間で資格情報を共有しないでください。

内容改訂3f225a253 · OpenAPI SHA-256: b12c42306a89