Skip to main content
On this page

MCP

Schnell verbinden

Verbinde jeden MCP-Client mit dem etg24-Server über deinen API-Key – denselben Key, den du für die REST API nutzt.

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

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.
  • Zuordenbar bleiben – jeder Agenten-Key ist ein eigener Akteur im Änderungslog; Fehler werden soft-gelöscht und sind rollback-bereit.

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

Endpointhttps://api.etg24.de/propertymanagement/v2/mcp
AuthentifizierungAPI-Key im Authorization: Bearer-Header – dieselben Keys und Scopes wie die REST API
ProtokollJSON-RPC 2.0 über HTTP POST. Antworten kommen als JSON oder als SSE (text/event-stream), wenn der Client diesen Accept-Header sendet
Tool-Listingtools/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

Tool-Referenz

Der vollständige Katalog – Meta-Tools plus jedes Domänen-Tool, generiert aus dem mcp:exportTools des Backends – ist auf einer Seite durchsuchbar:

→ MCP-Tool-Referenz ansehen