AthausDoku

MCP-Anmeldung: OAuth, Zustimmung und Schlüssel

OAuth 2.1 für Apps wie Claude und ChatGPT, ein Schlüssel für eigene Agenten. Jeder Aufruf verlangt eine Anmeldung, und die Zustimmung gilt je Server.

Zuletzt aktualisiert:

Jeder der zwei Server braucht ein Athaus-Konto, schon für initialize und tools/list. Wenn eine App für dich handelt (Claude, ChatGPT, Cursor, VS Code), läuft es über OAuth 2.1; ein eigener Agent ohne Browser nimmt einen ath_-Schlüssel, der nur bei Athaus für Anbieter gilt. Läuft etwas nicht, hilft die Fehlerbehebung.

So läuft die Anmeldung

  1. Die App ruft den Server und bekommt 401 mit dem Kopf WWW-Authenticate, der die Rechte und die Beschreibung der Anmeldung nennt.
  2. Du meldest dich bei Athaus an, zum Beispiel mit einem Code per E-Mail.
  3. Auf app.athaus.ai/verbinden siehst du, welche App sich mit welchem Server verbinden will (der Server folgt aus der Adresse) und nur dessen Rechte. Das Grundrecht (lesen bzw. suchen) ist immer an. vorschlagen und suchauftraege sind an, wenn die App sie verlangt. Das Recht an der Grenze (freigeben bzw. anfragen) ist aus, bis du es einschaltest, außer du hast es dieser App an diesem Server schon gegeben.
  4. Die App bekommt ein Token, eine Stunde gültig, erneuerbar und nur an diesem Server. Athaus prüft die Zustimmung bei jedem Aufruf: wer trennt, sperrt die App sofort.

Hat sich eine App selbst registriert, sagt die Seite, dass ihr Name nicht geprüft ist: verbinde sie nur, wenn du sie gerade selbst eingerichtet hast.

Trennen

In Einstellungen, MCP unter Verbundene Apps trennst du jede Verbindung für sich; das beendet auch ihre Events.

Für Entwickler eines Clients

Athaus für AnbieterAthaus Immobiliensuche
Ressourcehttps://anbieter.mcp.athaus.ai/mcphttps://suche.mcp.athaus.ai/mcp
Metadatenhttps://anbieter.mcp.athaus.ai/.well-known/oauth-protected-resource/mcphttps://suche.mcp.athaus.ai/.well-known/oauth-protected-resource/mcp
Scopeslesen, vorschlagen, freigebensuchen, suchauftraege, anfragen

Für beide: Autorisierungsserver https://www.athaus.ai/api/auth, Authorization Code mit PKCE und Refresh Token, Registrierung per Client ID Metadata Document oder Dynamic Client Registration. resource (RFC 8707) ist Pflicht; das JWT trägt sie als aud und gilt nur dort, eine Stunde, DPoP wird unterstützt.

Fehlt ein Recht, antwortet der Server mit 403 und insufficient_scope (der scope nennt die vorhandenen und das fehlende Recht). Ein ungültiges, abgelaufenes, entzogenes oder für den anderen Server ausgestelltes Token bekommt 401 mit invalid_token.

Weiter lesen

Auf dieser Seite