MCP mit deinem KI-Agenten verbinden

Jede MCP-fähige App verbindet dieselben zwei Dinge: den etg24-MCP-Endpoint und deinen API-Key. Diese Seite zeigt die Einrichtung für die gängigsten Agenten.

Das allgemeine Muster

Egal welche App: Die Konfiguration sieht so aus – ein MCP-Server-Eintrag mit der Endpoint-URL und einem Authorization-Header mit deinem Key:

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

Die meisten Apps verstecken das hinter einem Formular: Servername, URL, API-Key. Die Menünamen variieren je nach App und Version – suche in den Einstellungen nach MCP, Connections oder Integrationen.

Claude

Claude Desktop – öffne den MCP-Server-Bereich in den Einstellungen und füge einen Server hinzu, oder bearbeite claude_desktop_config.json direkt (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Claude Code – registriere den Server über die CLI:

claude mcp add --transport http etg24 https://api.etg24.de/propertymanagement/v2/mcp \
  --header "Authorization: Bearer $ETG24_API_KEY"

Cursor

Öffne Settings → MCP, füge einen neuen Server hinzu und wähle den HTTP-Transport:

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

Cursor speichert das in ~/.cursor/mcp.json – du kannst die Datei auch direkt bearbeiten.

VS Code

Öffne die Befehlspalette (Ctrl+Shift+P / Cmd+Shift+P) und führe MCP: Add Server aus, wähle HTTP, trage Endpoint und Authorization-Header ein – oder bearbeite .vscode/mcp.json (Projekt) bzw. deine Benutzer-mcp.json:

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

ChatGPT

Öffne in ChatGPT Einstellungen → Apps (der Ort des MCP-Bereichs variiert je nach App-Version) und verbinde einen neuen MCP-Server. Trage die etg24-Endpoint-URL und deinen API-Key ein, wenn das Formular Zugangsdaten verlangt. Bietet deine App-Version nur OAuth-Connectors an, funktioniert ein MCP-Gateway als Brücke, das den Authorization-Header ergänzt.

Mistral

Mistral unterstützt MCP-Verbindungen für Agenten und Assistenten. Füge den etg24-Endpoint als MCP-Server hinzu (URL plus Authorization: Bearer <API_KEY>-Header) – in den Workspace- oder Agenten-Einstellungen.

Perplexity

Öffne Einstellungen → MCP-Server und füge einen eigenen Server hinzu: Vergib einen Namen, trage die etg24-Endpoint-URL ein und hinterlege deinen API-Key als Bearer-Token. Nach dem Speichern stehen die etg24-Tools deinen Prompts zur Verfügung.

opencode

Füge den Server zu opencode.json hinzu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "etg24": {
      "type": "remote",
      "url": "https://api.etg24.de/propertymanagement/v2/mcp",
      "headers": { "Authorization": "Bearer ${env:ETG24_API_KEY}" }
    }
  }
}

Clients ohne Remote-MCP-Unterstützung

Startet dein Client nur lokale MCP-Prozesse, brücke ihn mit mcp-remote:

{
  "mcpServers": {
    "etg24": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.etg24.de/propertymanagement/v2/mcp",
        "--header",
        "Authorization: Bearer <API_KEY>"
      ]
    }
  }
}

Andere Agenten

Jede App, die einen entfernten MCP-Server über HTTP mit eigenen Headern verbinden kann, funktioniert gleich: Endpoint-URL und Authorization-Header angeben – verbunden.

Die Verbindung prüfen

Bitte den Agenten, seine Tools aufzulisten – oder schau in der MCP-Sektion der App in die Tool-Liste. Der etg24-Server nennt seine Meta-Tools (meta.tools.search, meta.tool.describe, meta.tool.execute, meta.docs.search und mehr); Domänen-Tools werden zur Laufzeit darüber entdeckt. Siehe den Meta-Tool-Workflow.

Ein guter erster Prompt: „Nutze meta.tools.search, um Tools zum Auflisten von Kontakten zu finden, und liste dann ein paar Kontakte.”

Beispiel-Prompts

• „Finde alle Einheiten des Gebäudes ‚Schillerstraße 12’ und sage mir, welche leer stehen.”
• „Nutze meta.docs.search, um nachzuschlagen, wie der Mieterwechsel-Workflow funktioniert, und fasse ihn zusammen.”
• „Liste die Dokumente der Einheit X und prüfe, ob der letzte Abschlag abgelegt ist.”
• „Lege einen Kontakt für Ada Lovelace an und erfasse eine Wiedervorlage-Notiz.”

Bevor du einen Agenten Daten ändern lässt, lies die MCP-Sicherheitspraxis.