MCP-Verbindung zum Q4-Hub einrichten
So verbinden Sie einen KI-Assistenten wie Claude über MCP mit Ihrem Q4-Kosmos.
MCP-Verbindung zum Q4-Hub einrichten
Mit dem MCP-Gateway der Q4 media AG können Sie einen KI-Assistenten — zum Beispiel Claude — direkt an Ihren Q4-Kosmos anbinden. Der Assistent kann dann in Ihrem Namen Kontakte nachschlagen, Termine und Aufgaben verwalten, Anrufe und Tickets einsehen oder das Smart Home schalten — je nachdem, welche Rechte Sie ihm beim Verbinden geben.
Diese Anbindung wird pro Kunde freigeschaltet. Wenn Sie sie nutzen möchten, sprechen Sie bitte kurz Ihren Ansprechpartner an.
Was ist MCP?
MCP steht für Model Context Protocol — ein offener Standard, über den ein KI-Assistent mit externen Systemen sprechen darf. Statt Daten mühsam zu kopieren, verbinden Sie den Assistenten einmalig mit einem sogenannten MCP-Server. Der Q4-Hub stellt genau so einen Server bereit.
Wichtig dabei:
- Sie entscheiden beim Verbinden, welche Rechte der Assistent bekommt.
- Ihr Zugang sieht ausschließlich die Daten Ihres Mandanten — die Trennung
steckt im Zugang selbst, nicht in einer Einstellung, die man vergessen kann.
- Jeder schreibende Zugriff wird protokolliert.
Voraussetzungen
- Ein Q4-Konto (dieselbe E-Mail-Adresse, mit der Sie sich auch im Cockpit
oder im Kundenportal anmelden).
- Die MCP-Anbindung ist für Ihr Unternehmen freigeschaltet.
- Ein KI-Client, der eigene MCP-Verbindungen („Connectors") unterstützt —
etwa die Claude-App auf dem Desktop, im Web oder auf dem Smartphone.
Schritt für Schritt verbinden
Die Adresse des Q4-MCP-Servers lautet:
https://mcp.q4m.de/mcp
- Öffnen Sie in Ihrem KI-Client die Einstellungen und dort den Bereich für
Verbindungen bzw. Connectors.
- Wählen Sie eigene Verbindung hinzufügen und tragen Sie die Adresse von
oben ein.
- Der Client öffnet daraufhin die Anmeldeseite „Mit q4m verbinden".
Melden Sie sich dort mit E-Mail und Passwort Ihres Q4-Kontos an. Alternativ können Sie sich einen Anmeldelink per E-Mail schicken lassen.
- Auf derselben Seite sehen Sie die angefragten Rechte als Liste mit
Häkchen. Nehmen Sie das Häkchen bei allem heraus, was der Assistent nicht können soll, und bestätigen Sie mit Anmelden & verbinden.
- Der Client meldet die Verbindung als aktiv. Zum Gegentest bitten Sie den
Assistenten einfach: „Prüfe die Verbindung zum Q4-Hub."
💡 Tipp: Beginnen Sie bewusst mit wenigen, lesenden Rechten. Sie können die Verbindung jederzeit trennen und mit mehr Rechten neu aufbauen.
Welche Rechte es gibt
| Recht | Was der Assistent damit darf |
|---|---|
| Kontakte lesen / anlegen und ändern | Im Adressbuch suchen, Einträge pflegen |
| Kalender lesen / Termine anlegen, verschieben, absagen | Ihren Kalender einsehen und pflegen |
| Aufgaben lesen / anlegen und erledigen | Ihre zentrale Aufgabenliste führen |
| Anrufliste lesen | Die letzten Gespräche einsehen |
| ERP-Kunden lesen / Rechnungs-Entwürfe erstellen | Kundendaten nachschlagen, Entwürfe vorbereiten |
| Bauprojekte lesen / Bau-Termine anlegen | Projektdaten aus qbau nutzen |
| Support-Tickets lesen / beantworten | Tickets einsehen, Antworten und Status setzen |
| Smart Home steuern | Licht, Rollläden und Szenen schalten |
| Energie- und PV-Daten lesen | Erzeugung, Verbrauch und Wallboxen abfragen |
Nicht jedes Recht ist für jedes Unternehmen sinnvoll oder freigeschaltet — Module, die bei Ihnen nicht gebucht sind, meldet der Assistent schlicht als „nicht verbunden".
Sicherheit: Entwurf und Freigabe
Alles, was Wirkung nach außen hat, läuft bewusst zweistufig. Der Assistent bereitet vor, Sie geben frei:
- E-Mails: Der Assistent legt einen Entwurf an, liest Ihnen Empfänger,
Betreff und Text vor — gesendet wird erst nach Ihrer ausdrücklichen Zusage.
- Terminabsagen: erst Entwurf mit Absagetext, dann Absage.
- Ticket-Antworten: erst Entwurf, dann Versand.
- Türen und Tore: werden nie direkt geöffnet, sondern erst nach einer
ausdrücklichen Bestätigung im Gespräch.
⚠️ Achtung: Lesen Sie Entwürfe wirklich, bevor Sie sie freigeben. Der Assistent formuliert selbst — die Verantwortung für den Inhalt bleibt bei Ihnen.
Zugangsdaten und Token
Ihr Zugang ist persönlich. Deshalb gilt:
- In diesem Hilfebereich stehen niemals Passwörter, Token oder Schlüssel —
hier steht nur, wie Sie sich verbinden.
- Ihre Zugangsdaten erhalten Sie im Kundenportal unter
kunden.q4m.de oder persönlich von Ihrem Ansprechpartner bei der Q4 media AG.
- Verlangt Ihr Client ausnahmsweise die manuelle Eingabe eines Zugangs-Tokens,
tragen Sie dort den Wert ein, den wir Ihnen persönlich übergeben haben. In Anleitungen steht an dieser Stelle immer nur der Platzhalter IHR-TOKEN.
- Geben Sie Token oder Passwort nie per Chat, Ticket oder E-Mail weiter,
auch nicht an uns. Wir fragen Sie nie danach.
Wenn es nicht klappt
- Die Verbindung wird nicht grün. Prüfen Sie die Adresse: sie endet auf
/mcp, ohne Schrägstrich am Ende.
- Anmeldung schlägt fehl. Nutzen Sie dieselbe E-Mail-Adresse wie im Cockpit.
Kein Passwort zur Hand? Lassen Sie sich den Anmeldelink schicken.
- Der Assistent sagt, ihm fehle ein Recht. Das betreffende Häkchen war beim
Verbinden nicht gesetzt. Trennen Sie die Verbindung und bauen Sie sie mit dem fehlenden Recht neu auf.
- Eine neue Funktion taucht nicht auf. Nach einer Erweiterung müssen Sie die
Verbindung einmal trennen und neu verbinden — bestehende Zugänge kennen die neuen Rechte noch nicht.
- „Nicht verbunden" oder „nicht konfiguriert". Dann ist das betreffende
Modul für Ihr Unternehmen nicht freigeschaltet. Melden Sie sich bei uns.
Kommen Sie nicht weiter? Schreiben Sie uns über das Support-Formular.
Stand: 2026-08-26