Verwenden Sie einen MCP-Client, der Streamable HTTP und entweder vorregistriertes OAuth mit PKCE oder ein konfiguriertes Bearer-Token unterstützt. Der Kundensupport variiert; Eine automatische Kundenregistrierung ist nicht verfügbar.
MCP-Server-URL
https://api.remotegymp.com/mcpVerwenden Sie für Self-Hosted denselben MCP-Pfad für die öffentliche HTTPS-Adresse Ihrer Installation. Ihr Kunde muss es erreichen können. Die Cloud-Adresse leitet keine Proxy-Anfragen an Ihre Installation weiter.
Verbinden Sie sich mit OAuth
- Erstellen Sie in den Einstellungen einen Berechtigungsnachweis mit aktiviertem MCP und nur den Berechtigungen, die der Assistent benötigt. Registrieren Sie die genaue Rückruf-URL, die Sie von Ihrem Kunden erhalten haben. Verwenden Sie den Benutzernamen der Anmeldeinformationen als OAuth-Client-ID. Dieser Ablauf verwendet kein Client-Geheimnis.
- Rückrufe müssen HTTPS oder HTTP auf einer expliziten Loopback-Adresse verwenden. Die vollständige URL muss übereinstimmen, einschließlich des Ports. Um es zu ändern, erstellen Sie einen neuen Berechtigungsnachweis und widerrufen den alten.
- Stellen Sie von Ihrem Kunden aus eine Verbindung her, melden Sie sich als der Eigentümer an, der die Anmeldeinformationen erstellt hat, und überprüfen Sie den Zustimmungsbildschirm. Der Client muss S256 PKCE und die MCP-Ressourcen-URL verwenden. Durch die Zustimmung können die Berechtigungen der Anmeldeinformationen eingeschränkt werden. Es können keine Berechtigungen hinzugefügt werden.
Cloud-OAuth-Endpunkte
- Autorisierung
https://app.remotegymp.com/integration/oauth/authorize- Token-Austausch
https://app.remotegymp.com/integration/oauth/token- Metadaten des Autorisierungsservers
https://app.remotegymp.com/.well-known/oauth-authorization-server- Geschützte Ressourcenmetadaten
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp
OAuth verwendet Standard-Token-Feldnamen und rotierende Aktualisierungstoken. Der Client sollte die Aktualisierung automatisch durchführen. Zugriffstokens sind maximal 30 Minuten gültig. Verbindungen verfallen nach sieben Tagen ohne Aktualisierung bzw. nach insgesamt 30 Tagen. Durch die Wiederverwendung eines alten Aktualisierungstokens wird die Verbindung ungültig. Verbinden Sie die Verbindung erneut, anstatt sie erneut abzuspielen.
Verbinden Sie sich mit einem Inhaber-Token
Wenn Ihr Client ein konfiguriertes Bearer-Token unterstützt, tauschen Sie am Token-Endpunkt einen MCP-fähigen Berechtigungsnachweis mit der MCP-Zielgruppe aus und fügen Sie dann das zurückgegebene Token in die sichere Bearer-Token-Einstellung des Clients ein. Es läuft nach 30 Minuten ab. Fügen Sie kein Token in die Server-URL ein. Verwenden Sie OAuth für Clients, die eine automatische Aktualisierung benötigen.
{
"username": "<your-credential-username>",
"password": "<your-credential-secret>",
"audience": "mcp"
}Überprüfen Sie den Zugang, bevor Sie mit der Arbeit beginnen
Bitten Sie den Kunden, zunächst seine verfügbaren Tools und Lesefunktionen aufzulisten. Beginnen Sie mit einer schreibgeschützten Anfrage, z. B. der Auflistung von Geräten. Ein fehlendes Tool kann auf Berechtigungen, Umfang oder Verfügbarkeit hinweisen. Durch die alleinige Aktivierung von MCP ist keine Fernsteuerung möglich.
tools/list · get_capabilities
Die Bildschirmanzeige folgt der Zustimmung des Geräts. Für die Bildschirmeingabe ist ein neuer Screenshot erforderlich. Überprüfen Sie Ziele, Löschvorschauen und angegebene KI-Kosten, bevor Sie Arbeiten genehmigen. Der Not-Aus blockiert die weitere Automatisierung; Die bereits laufende Arbeit kann beendet werden.
Trennen Sie die Verbindung oder widerrufen Sie den Zugriff
Trennen Sie die Verbindung in Ihrem Client und widerrufen Sie die Anmeldeinformationen in den Einstellungen, wenn sie nicht mehr benötigt werden. Der Widerruf stoppt die zugehörigen Token und OAuth-Verbindungen bei nachfolgenden Anforderungen. Geben Sie die Anmeldeinformationen niemals zwischen unabhängigen Integrationen weiter.