RemoteGymp · API v1

Anslut en AI-assistent

Använd en MCP-klient som stöder Streamable HTTP och antingen förregistrerad OAuth med PKCE eller en konfigurerad bärartoken. Kundsupport varierar; automatisk klientregistrering är inte tillgänglig.

MCP-serverns URL

https://api.remotegymp.com/mcp

För Self-Hosted, använd samma MCP-sökväg på din installations offentliga HTTPS-adress. Din klient måste kunna nå den. Molnadressen skickar inga proxyförfrågningar till din installation.

Anslut med OAuth

  1. I Inställningar, skapa en autentiseringsinformation med MCP aktiverat och endast de behörigheter som assistenten behöver. Registrera den exakta återuppringnings-URL som tillhandahålls av din kund. Använd användarnamnet för autentiseringsuppgifterna som OAuth-klient-ID. Detta flöde använder inte en klienthemlighet.
  2. Återuppringningar måste använda HTTPS eller HTTP på en explicit loopback-adress. Den fullständiga webbadressen måste matcha, inklusive porten. För att ändra den, skapa en ny autentiseringsinformation och återkalla den gamla.
  3. Anslut från din klient, logga in som ägaren som skapade autentiseringsuppgifterna och granska samtyckesskärmen. Klienten måste använda S256 PKCE och MCP-resursen URL. Samtycke kan begränsa autentiseringsuppgifternas behörigheter; det kan inte lägga till behörigheter.

Cloud OAuth-slutpunkter

Auktorisation
https://app.remotegymp.com/integration/oauth/authorize
Tokenbyte
https://app.remotegymp.com/integration/oauth/token
Metadata för auktoriseringsserver
https://app.remotegymp.com/.well-known/oauth-authorization-server
Skyddad resursmetadata
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth använder vanliga tokenfältnamn och roterande uppdateringstoken. Klienten ska hantera uppdateringen automatiskt. Åtkomsttokens varar högst 30 minuter. Anslutningar upphör efter sju dagar utan uppdatering eller 30 dagar totalt. Återanvändning av en gammal uppdateringstoken ogiltigförklarar anslutningen; återanslut istället för att spela upp det igen.

Anslut med en bärartoken

Om din klient stöder en konfigurerad bärartoken, byt ut en MCP-aktiverad autentiseringsinformation vid tokenslutpunkten med MCP-publiken och placera sedan den returnerade token i klientens säkra bärartoken-inställning. Den löper ut efter 30 minuter. Lägg inte en token i serverns URL. Använd OAuth för klienter som behöver automatisk uppdatering.

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

Autentisering →

Kontrollera åtkomsten innan du utför arbete

Be klienten att lista sina tillgängliga verktyg och läsfunktioner först. Börja med en skrivskyddad begäran, till exempel lista enheter. Ett frånvarande verktyg kan återspegla behörigheter, omfattning eller tillgänglighet. Att enbart aktivera MCP ger inte fjärrkontroll.

tools/list · get_capabilities

Skärmvisning följer enhetens samtycke. Skärmindata behöver en ny skärmdump. Granska mål, raderingsförhandsvisningar och angivna AI-kostnader innan du godkänner arbete. Nödstoppet blockerar ytterligare automatisering; arbete som redan pågår kan avslutas.

Koppla bort eller återkalla åtkomst

Koppla från din klient och återkalla autentiseringsuppgifterna i Inställningar när det inte längre behövs. Återkallelse stoppar dess associerade tokens och OAuth-anslutningar vid efterföljande förfrågningar. Dela aldrig referensen mellan orelaterade integrationer.

Innehållsrevision 3f225a253 · OpenAPI SHA-256: b12c42306a89