MCP sign-in: OAuth, consent and keys
OAuth 2.1 for apps such as Claude and ChatGPT, a key for your own agents. Every call requires a sign-in, and consent applies per server.
Last updated:
Each of the two servers needs an Athaus account, even for initialize and tools/list. When an app acts for you (Claude, ChatGPT, Cursor, VS Code) it uses OAuth 2.1; your own agent without a browser takes an ath_ key, which only works with Athaus für Anbieter. If something does not work, see Troubleshooting.
How sign-in works
- The app calls the server and gets
401with theWWW-Authenticateheader, naming the rights and the description of the sign-in. - You sign in to Athaus, for example with a code by email.
- On app.athaus.ai/verbinden you see which app wants to connect to which server (the server follows from the address) and only its rights. The base right (
lesenorsuchen) is always on.vorschlagenandsuchauftraegeare on if the app asks for them. The boundary right (freigebenoranfragen) is off until you switch it on, unless you already gave it to this app at this server. - The app gets a token, valid for an hour, renewable and only at this server. Athaus checks the consent on every call: disconnecting blocks the app at once.
If an app registered itself, the page says its name is not verified: connect it only if you have just set it up yourself.
Disconnecting
In Settings, MCP under Connected apps you disconnect each connection on its own; that also ends its events.
For client developers
| Athaus für Anbieter | Athaus Immobiliensuche | |
|---|---|---|
| Resource | https://anbieter.mcp.athaus.ai/mcp | https://suche.mcp.athaus.ai/mcp |
| Metadata | 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 |
For both: authorization server https://www.athaus.ai/api/auth, Authorization Code with PKCE and refresh token, registration by Client ID Metadata Document or Dynamic Client Registration. resource (RFC 8707) is required; the JWT carries it as aud and is valid only there, for an hour; DPoP is supported.
If a right is missing, the server answers 403 with insufficient_scope (the scope lists the existing and the missing right). An invalid, expired, revoked token, or one issued for the other server, gets 401 with invalid_token.
Keep reading
MCP rights: what an agent may do
Three rights per server, independent of each other, and the rule for when a click is needed. In OAuth the rights are the scopes, under the same names.
Fixing problems with the MCP connection
What an error means when you connect to or call Athaus für Anbieter and Athaus Immobiliensuche, and what to do about it.
Create an API key and choose its scopes
An API key for the REST API, your own agents and services, with exactly the scopes you give it.