# MCP-Anmeldung: OAuth, Zustimmung und Schlüssel

Adresse: https://docs.athaus.ai/mcp/anmeldung

> 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.

Typ: Referenz
Zuletzt aktualisiert: 2026-11-10

Jeder der [zwei Server](/mcp) 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](/api/schluessel), der nur bei Athaus für Anbieter gilt. Läuft etwas nicht, hilft die [Fehlerbehebung](/mcp/fehlerbehebung).

## So läuft die Anmeldung [#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](https://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`](/mcp/rechte#lesen) bzw. [`suchen`](/mcp/rechte#suchen)) ist immer an. [`vorschlagen`](/mcp/rechte#vorschlagen) und [`suchauftraege`](/mcp/rechte#suchauftraege) sind an, wenn die App sie verlangt. Das Recht an der Grenze ([`freigeben`](/mcp/rechte#freigeben) bzw. [`anfragen`](/mcp/rechte#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 [#trennen]

In [Einstellungen, MCP](https://app.athaus.ai/einstellungen/mcp) unter **Verbundene Apps** trennst du jede Verbindung für sich; das beendet auch ihre Events.

## Für Entwickler eines Clients [#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`.
