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
- Die App ruft den Server und bekommt
401mit dem KopfWWW-Authenticate, der die Rechte und die Beschreibung der Anmeldung nennt. - Du meldest dich bei Athaus an, zum Beispiel mit einem Code per E-Mail.
- 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 (
lesenbzw.suchen) ist immer an.vorschlagenundsuchauftraegesind an, wenn die App sie verlangt. Das Recht an der Grenze (freigebenbzw.anfragen) ist aus, bis du es einschaltest, außer du hast es dieser App an diesem Server schon gegeben. - 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 Anbieter | Athaus Immobiliensuche | |
|---|---|---|
| Ressource | https://anbieter.mcp.athaus.ai/mcp | https://suche.mcp.athaus.ai/mcp |
| Metadaten | https://anbieter.mcp.athaus.ai/.well-known/oauth-protected-resource/mcp | https://suche.mcp.athaus.ai/.well-known/oauth-protected-resource/mcp |
| Scopes | lesen, vorschlagen, freigeben | suchen, 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
MCP-Rechte: was ein Agent darf
Je Server drei Rechte, unabhängig voneinander, und die Regel, wann ein Klick nötig ist. Im OAuth-Protokoll sind die Rechte die Scopes, unter demselben Namen.
So behebst du Probleme mit der MCP-Verbindung
Was ein Fehler beim Verbinden oder Aufrufen von Athaus für Anbieter und Athaus Immobiliensuche bedeutet und was du dagegen tust.
API-Key anlegen und Scopes wählen
Ein API-Key für die REST-API, eigene Agenten und Dienste, mit genau den Scopes, die du ihm gibst.