Model Context Protocol (MCP) in Qonekto

Model Context Protocol (MCP) in Qonekto

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
Info

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:
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.
Info

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 verschiedene 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
Info

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

  1. In Qonekto anmelden
  2. Admin-Bereich öffnen
  3. Bereich API Tokens wählen
  4. Neuen Token anlegen
  5. Berechtigung MCP_READ oder MCP_FULL auswählen
  6. 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:
  1. n8n öffnen und neuen Workflow anlegen
  2. Einen Node vom Typ MCP Client Tool hinzufügen
  3. In der Konfiguration folgendes setzen:
  4. Werkzeuge auswählen, die über MCP verwendet werden sollen
  5. 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.
Warning

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


    • Related Articles

    • Qonekto Trigger für n8n und Make

      Qonekto Trigger für n8n und Make Automatisierte Workflows bei neuen oder geänderten Datensätzen Die Qonekto Trigger ermöglichen es, Änderungen in Qonekto in Echtzeit an externe Systeme wie n8n oder Make zu übermitteln. Dadurch können Workflows ...

    • Integration Make (vormals Integromat)

      Was ist make (vormals Integromat)? Make ist eine Automatisierungsplattform, die es Benutzern ermöglicht, verschiedene Online-Anwendungen miteinander zu verbinden und automatisierte Abläufe zu erstellen, ohne dass Programmierkenntnisse erforderlich ...

    • DailyUp: CSV-Daten von blau über Qonekto abrufen und nutzen

      DailyUP - die Datenbasis von Qonekto Mit dem DailyUP-Service von blau erhältst du einmal täglich strukturierte CSV-Dateien, die Dir über unser Qonekto Backend bereitgestellt und über die Pipelines verarbeitet werden. Diese Dateien enthalten ...

    • Integration N8N

      1. Was ist N8N (https://n8n.io/) N8N ist eine europäische Automatisierungsplattform, mit der sich digitale Arbeitsabläufe zwischen verschiedenen Anwendungen ohne klassische Programmierung verbinden lassen. Der Name steht für „nodemation“ und ...

    • Qonekto API

      Anleitung Für Profis bieten wir eine einfache API an, die du fest in deinem System installieren kannst. Die Anleitung findest du im System unter Admin / API oder über diesen Link: https://app.mvp-connector.de/api/docs Wichtig: Nur für Profis und ...