Model Context Protocol (MCP) in Qonekto

Der Model Context Protocol (MCP) ist eine standardisierte Schnittstelle, über die KI Systeme und Automationswerkzeuge strukturiert und sicher auf Daten in Qonekto zugreifen können. MCP wurde dafür entwickelt, Assistenzfunktionen, KI gestützte Workflows und automatisierte Vorgänge technisch sauber abzubilden. Während die klassische API grundsätzlich ähnliche Daten bereitstellt, ist MCP speziell auf Echtzeitinteraktionen und Tool basierte Operationen optimiert.

1. Grundlagen des MCP

MCP ermöglicht:

Zugriff auf Kunden, Verträge und Referenzdaten
Arbeiten mit Archiv Einträgen
Dokumenten Uploads bis 5 MB (PDF, JPEG, PNG, TIFF, DOCX, XLSX)
Auslesen und Anlegen von Archivvorgängen und Kommunikationsarten
CRUD Operationen für alle relevanten Objekte
KI gestützte Verarbeitung über standardisierte Tools

MCP dient damit als technische Basis für moderne KI Agenten und automatisierte Prozesse, die im Makleralltag unterstützen sollen.

2. MCP Endpoint und Authentifizierung

Der Endpoint lautet:


https://app.qonekto.de/api/{tenant}/mcp

Für den Zugriff wird ein API Token benötigt, das mindestens einen der folgenden Scopes besitzt:

MCP_READ (MCP Lesezugriff)
MCP_FULL (MCP Lese- und Schreibzugriff)

Die Authentifizierung erfolgt:

bevorzugt über den Authorization Header
alternativ über den URL Parameter _token

Zur Sicherheit empfiehlt Qonekto, Tokens möglichst restriktiv einzuschränken, zumindest auf Regionen, idealerweise auf bestimmte IP Adressen.

Ausblick: Qonekto arbeitet an einer integrierten KI Chat Oberfläche auf Basis des MCP. Dort gelten eigene Credit Limits und Makler können eigene API Keys für den Anbieter hinterlegen.

3. Funktionen des MCP im Detail

Über MCP stehen alle für KI relevante Ressourcen zur Verfügung:

Kunden auslesen und aktualisieren
Verträge abrufen
Archivdaten lesen und anlegen
Kommunikationseinträge erzeugen
Dokumente im Archiv speichern
Gecachte Referenzdaten nutzen, um Antwortzeiten zu verbessern

Diese Funktionen bilden die Grundlage für KI Assistenten, die z. B. Daten analysieren, Vorgänge vorbereiten oder Inhalte zusammenfassen.

4. Einrichtung des MCP in Qonekto

Schritt 1: API Token erzeugen

In Qonekto anmelden
Admin-Bereich öffnen
Bereich API Tokens wählen
Neuen Token anlegen
Berechtigung MCP_READ oder MCP_FULL auswählen
Optional Einschränkungen aktivieren wie Region oder IP Bindung

Einrichtung des API-Token im Qonekto Backend

Der Token wird später für n8n oder andere Tools gebraucht.

Schritt 2: Endpoint in externen Tools eintragen

Tools oder KI Systeme benötigen lediglich:

MCP Endpoint URL
API Token mit MCP Scope

Die Kommunikation erfolgt dann über standardisierte MCP Requests.

5. Integration des MCP in z.B. n8n

n8n kann MCP auf zwei Wegen nutzen:

n8n als MCP Client (empfohlen für Qonekto)
n8n als MCP Server (um eigene Tools bereitzustellen)

n8n als MCP Client für Qonekto

In dieser Konfiguration greift n8n direkt auf den Qonekto MCP Endpoint zu und kann Daten automatisiert abrufen oder verarbeiten.

Schritt für Schritt:

n8n öffnen und neuen Workflow anlegen
Einen Node vom Typ MCP Client Tool hinzufügen
In der Konfiguration folgendes setzen:
- Server URL: https://app.qonekto.de/api/{tenant}/mcp
- Authentifizierung: Bearer
- Token: Qonekto API Token mit MCP_READ oder MCP_FULL
Werkzeuge auswählen, die über MCP verwendet werden sollen
Weitere Nodes ergänzen, z. B. zur Weiterverarbeitung, Speicherung oder Transformation der Daten

Damit kann n8n MCP Calls ausführen, automatisiert Kundendaten auslesen, Archivdaten abrufen oder Verträge verarbeiten.

Typische Fehlerquelle:

Ältere n8n Versionen setzen den Bearer Header manchmal nicht korrekt. In diesem Fall den Authorization Header manuell eintragen.

6. Nutzung im Alltag

Mit eingerichtetem MCP können zum Beispiel:

KI Agenten Kundendaten analysieren
Workflows automatisch Archiv Einträge erzeugen
Assistenten Vertragsinformationen extrahieren
Dokumente abgelegt und Vorgänge kommentiert werden
Anfragen automatisiert beantwortet werden