Installation

There are two servers, and you add the one that fits you, or both:

On the first call you sign in with your Athaus account and confirm on app.athaus.ai/verbinden what the app may do. Which server it is follows from the address; you do not pick a side there. The details are under Sign-in.

Claude (web and desktop)Copy Anchor Link

One button per server. It opens the custom connector dialog in claude.ai with name and address filled in. By hand:

1. In Claude open Customize > Connectors, then Add custom connector.
2. Enter name and address: Athaus für Makler with https://anbieter.mcp.athaus.ai/mcp, or Athaus Immobiliensuche with https://suche.mcp.athaus.ai/mcp.
3. Keep the detected sign-in (OAuth), choose Add, then Connect.
4. Switch it on in a chat under + > Connectors.

On Team and Enterprise an owner adds the connector under Organization settings > Connectors; each member then connects on their own. A connector added in claude.ai is also available in Claude Desktop and the mobile apps.

Claude CodeCopy Anchor Link

claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp

claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcp

Then run /mcp in Claude Code and finish signing in in the browser.

CursorCopy Anchor Link

The button opens Cursor with the entry for you to confirm. By hand in ~/.cursor/mcp.json (or .cursor/mcp.json in the project); if you only need one server, leave out the other entry:

{
  "mcpServers": {
    "athaus-makler": {
      "url": "https://anbieter.mcp.athaus.ai/mcp"
    },
    "athaus-suche": {
      "url": "https://suche.mcp.athaus.ai/mcp"
    }
  }
}

VS CodeCopy Anchor Link

Or in .vscode/mcp.json in the project:

{
  "servers": {
    "athaus-makler": {
      "type": "http",
      "url": "https://anbieter.mcp.athaus.ai/mcp"
    },
    "athaus-suche": {
      "type": "http",
      "url": "https://suche.mcp.athaus.ai/mcp"
    }
  }
}

ChatGPTCopy Anchor Link

In ChatGPT your own MCP server is called an app, and it runs through developer mode on the web. Each of the two servers is an app of its own.

1. Turn on developer mode. Depending on your version of ChatGPT the switch is under Settings > Apps > Advanced settings or under Settings > Security and login.
2. Create an app (Create app or Create MCP App), authentication OAuth: name Athaus für Makler with the address https://anbieter.mcp.athaus.ai/mcp, or Athaus Immobiliensuche with https://suche.mcp.athaus.ai/mcp.
3. Sign in with your Athaus account and give your consent.
4. In a chat, pick the app for the conversation under + > Developer mode.

So far ChatGPT is the only client that subscribes to MCP Events.

Your own agentCopy Anchor Link

Without a browser, an agent signs in with an API key. A key only works with Athaus für Makler; the search server only takes sign-in through OAuth. Create the key under Settings, API keys and send it with every call:

Authorization: Bearer ath_...

Any MCP library that speaks Streamable HTTP can do this; in Claude Code, for example:

claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
  --header "Authorization: Bearer ath_..."

In tools/list a key only sees the tools its rights allow. Only an OAuth connection can subscribe to MCP Events, never a key.

If you added the old addressCopy Anchor Link

https://api.athaus.ai/mcp answers 410 and names the two new addresses. Remove the old entry, add the matching new address and connect again.