On this page

MCP

Schnell verbinden

Verbinde jeden MCP-Client mit dem etg24-MCP-Server, der zu Rolle und Key deines Agenten passt:

	Property-Management-API	Internal API
Endpoint	`https://api.etg24.de/propertymanagement/v2/mcp`	`https://api.etg24.de/api/internal/v1/mcp`
Verwendung	der Agent handelt im Namen des Unternehmens	der Agent handelt im Namen eines Nutzers
Erforderlicher Key	ein tenant-gebundener (Unternehmens-)API-Key	ein user-gebundener API-Key
Tool-Katalog	die Tools der Property-Management-v2-Ebene, wie in der Tool-Referenz	die Tools der Internal API, inklusive interner Domänen wie Notes

Beide sprechen dasselbe Protokoll und nutzen denselben Meta-Tool-Loop (meta.tools.search → meta.tool.describe → meta.tool.execute), aber jeder bedient die Tools seiner eigenen API-Ebene – die Kataloge unterscheiden sich.

{
  "mcpServers": {
    "etg24": {
      "url": "https://api.etg24.de/propertymanagement/v2/mcp",
      "headers": { "Authorization": "Bearer <COMPANY_API_KEY>" }
    }
  }
}

Tausche die URL gegen https://api.etg24.de/api/internal/v1/mcp und nutze einen user-gebundenen Key, wenn der Agent im Namen einer Person handelt. Die Schritt-für-Schritt-Einrichtung für Claude, ChatGPT, Mistral, Perplexity, opencode, Cursor und VS Code findest du in der MCP-Einrichtungsanleitung.

Was Agenten können

Alles lesen, was dein Portal speichert – Query-Tools über Objekte, Einheiten, Kontakte, Verträge, Dokumente.
Daten bewusst ändern – Command-Tools folgen derselben CQRS-Trennung wie die REST API, mit Scopes und Audit-Trail.
Tools nach Bedeutung finden – meta.tools.search entdeckt das richtige Tool, meta.tool.describe prüft sein Schema, meta.tool.execute führt es aus.
Antworten in Dokumenten verankern – meta.docs.search ruft Dokumente und Handbuch-Inhalte semantisch ab.
Revisionssicher zugeordnet – jeder Agenten-Key agiert als eigenständiger Akteur im Audit-Log; fehlerhafte Löschungen werden per Soft Delete & Rollback geschützt und lassen sich sofort wiederherstellen.

Neu bei MCP auf etg24? Starte mit Warum MCP bei etg24, folge dann dem Meta-Tool-Workflow und lies die MCP-Sicherheitspraxis, bevor du einen Agenten Daten schreiben lässt.

Authentifizierung & Transport


Endpoints	`https://api.etg24.de/propertymanagement/v2/mcp` (Unternehmens-Agenten) · `https://api.etg24.de/api/internal/v1/mcp` (Nutzer-Agenten)
Authentifizierung	API-Key im `Authorization: Bearer`-Header – ein tenant-gebundener (Unternehmens-)Key an der Property-Management-API, ein user-gebundener Key an der Internal API
Protokoll	JSON-RPC 2.0 über HTTP `POST`. Antworten kommen als JSON oder als SSE (`text/event-stream`), wenn der Client diesen Accept-Header sendet
Tool-Listing	`tools/list` zeigt die Meta-Tools an. Domänen-Tools werden zur Laufzeit über `meta.tools.search` entdeckt und über `meta.tool.execute` aufgerufen – siehe den Meta-Tool-Workflow

Stabilität

Eine Fähigkeit, die auf der MCP-Oberfläche gelandet ist, bleibt dort, bis die Funktionalität selbst aus dem Produkt entfernt wird – wir nehmen MCP-Fähigkeiten nicht einfach zurück. Die technischen Verträge hinter den Tools (Endpoint-Pfade, Input- und Output-Schemas) können sich ohne weitere Ankündigung ändern, denn sie zur Laufzeit zu entdecken ist der vorgesehene Weg, MCP zu nutzen. Siehe MCP-Stabilität & Versionierung.

Tool-Referenz

Der Integrator-Katalog – Meta-Tools plus die Domänen-Tools der Property-Management-v2- und Platform-Ebene, generiert aus dem mcp:exportTools des Backends – ist auf einer Seite durchsuchbar. Tools der Internal API sind nicht Teil dieser öffentlichen Referenz:

→ MCP-Tool-Referenz ansehen