KI verbinden

Claude, ChatGPT oder einem anderen MCP-Client Lesezugriff auf Ihre Protokolle geben.

Auf dieser Seite geben Sie Ihrem KI-Assistenten den Lesezugriff auf Ihre Protokolle. Das ist der zweite von zwei Schritten.

Voraussetzung: Der KI-Zugriff ist in der maklly-App bereits eingeschaltet. Falls nicht, machen Sie zuerst KI-Zugriff aktivieren — sonst liegt auf dem Server nichts, was ein Assistent lesen könnte.

Sie brauchen drei Dinge, und alle drei stehen auf dieser Seite:

Einen Browser, der bei maklly angemeldet ist (Abschnitt 1).
Die Adresse https://app.maklly.de/api/mcp/mcp, die Sie in Ihren Assistenten eintragen (Abschnitt 2).
Ein Zustimmen auf dem Bestätigungsbildschirm von maklly (Abschnitt 3).

Abschnitt 1: Die maklly-Web-App im Browser öffnen — angemeldet

Das Verbinden passiert im Browser, und dieser Browser muss bei maklly angemeldet sein. Wie Sie dorthin kommen, hängt davon ab, wie Sie Ihr maklly-Konto angelegt haben.

Fall A: Ihr Konto stammt von „Mit Apple anmelden"

Dann gibt es für die Web-App kein Passwort. Der Weg in den Browser führt über die App auf Ihrem iPhone:

Öffnen Sie die maklly-App auf Ihrem iPhone.
Tippen Sie auf Einstellungen, dann auf KI-Zugriff.
Tippen Sie auf KI verbinden.
Bestätigen Sie noch einmal mit Apple. Das ist keine überflüssige Wiederholung: Eine frische Apple-Bestätigung ist der einzige Nachweis, gegen den maklly eine angemeldete Web-Sitzung eintauscht.
Safari öffnet sich mit der maklly-Web-App — bereits angemeldet.

Machen Sie ab jetzt alles in genau diesem Safari-Fenster auf dem iPhone weiter. Ein Browser auf einem anderen Gerät — Ihrem Mac, Ihrem PC — ist nicht angemeldet; dort endet das Verbinden auf der Anmeldeseite.

Die so übergebene Sitzung gilt 24 Stunden und wird danach nicht gespeichert. Ist sie abgelaufen, tippen Sie in der App einfach erneut auf Einstellungen → KI-Zugriff → KI verbinden.

Fall B: Ihr Konto hat E-Mail-Adresse und Passwort

Dann können Sie sich in jedem beliebigen Browser anmelden — auch am Rechner:

Öffnen Sie https://app.maklly.de.
Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem Passwort an.

Abschnitt 2: maklly in Ihrem Assistenten eintragen

Ein KI-Assistent greift über einen sogenannten Connector auf maklly zu. Claude nennt das Custom Connector, ChatGPT nennt es App, andere Programme sprechen von MCP-Servern. Gemeint ist immer dasselbe.

Einzutragen ist genau diese Adresse:

https://app.maklly.de/api/mcp/mcp

Drei Dinge dazu, bevor Sie anfangen:

Achten Sie auf das /mcp am Ende. https://app.maklly.de/api/mcp sieht plausibel aus, antwortet aber nicht. Der Assistent meldet dann nur, dass die Verbindung fehlgeschlagen sei, und nennt keinen Grund.
Es gibt keinen Schlüssel zu kopieren und kein Passwort einzugeben. Felder für Client-ID, Client-Secret oder API-Token bleiben leer — der Connector meldet sich selbst an.
Dieselbe Adresse steht in der Web-App unter https://app.maklly.de/settings/ai-access, dort mit einem Knopf zum Kopieren.

Wählen Sie unten Ihr Programm aus.

Claude (Web, Desktop, Handy) kann eigene Connectors in allen Plänen — auch im kostenlosen, dort genau einen.

Öffnen Sie Claude und gehen Sie in die Einstellungen, dort in den Bereich Connectors.
Klicken Sie auf + und wählen Sie Add custom connector.
Tragen Sie als Adresse ein: https://app.maklly.de/api/mcp/mcp — mit dem /mcp am Ende.
Lassen Sie unter Advanced settings die Felder für OAuth Client ID und Client Secret leer. maklly registriert den Client selbst.
Klicken Sie auf Add.
Claude schickt Sie zu maklly. Weiter mit Abschnitt 3 auf dieser Seite.
Nach dem Verbinden: Schalten Sie den maklly-Connector im Chat ein — unten links auf +, dann Connectors, dann maklly aktivieren.

Claude verbindet sich aus der Anthropic-Cloud, nicht von Ihrem Gerät aus. Deshalb funktioniert es auch am Handy und wenn Ihr Rechner ausgeschaltet ist. (Ein Server im Firmennetz oder hinter einem VPN wäre so nicht erreichbar — app.maklly.de ist es.)

In einem Team- oder Enterprise-Workspace: Dort legt nur der Inhaber den Connector an, unter Organization settings → Connectors, mit derselben Adresse https://app.maklly.de/api/mcp/mcp. Die Mitglieder klicken danach bei diesem Connector auf Connect und bestätigen jeweils mit ihrem eigenen maklly-Konto.

Abschnitt 3: Die Verbindung bei maklly bestätigen

Ihr Assistent schickt Sie jetzt zu maklly. Dort erscheint ein Bestätigungsbildschirm mit der Überschrift „Name des Programms verbinden?", darunter die E-Mail-Adresse des Kontos und je eine Zeile pro Berechtigung.

Prüfen Sie die angezeigte E-Mail-Adresse. Ist es das richtige maklly-Konto?
Klicken Sie auf Zustimmen.

Wenn stattdessen eine Anmeldeseite erscheint, ist dieser Browser nicht bei maklly angemeldet — gehen Sie zurück zu Abschnitt 1 auf dieser Seite.

Womit Sie mit dem Klick auf Zustimmen einverstanden sind:

Das Programm darf jedes Rundgang-Protokoll lesen, das mit Ihrem Konto synchronisiert ist — den vollständigen Text samt Metadaten (Objekt, Bereich, Datum, Standort).
Es darf diesen Zugriff im Hintergrund behalten, ohne jedes Mal erneut nachzufragen, bis Sie ihn wieder trennen — sofern es danach gefragt hat.

Was es nicht darf: Ihre Audioaufnahmen und Fotos bekommt es nie zu sehen, und es kann nichts hinzufügen, ändern oder löschen. Der Zugriff ist rein lesend.

Zwei Hinweise zu diesem Bildschirm:

Zustimmungen werden nicht gespeichert. Der Bildschirm erscheint bei jeder Autorisierungsanfrage erneut — auch bei einem Programm, dem Sie vor einer Minute zugestimmt haben. Das ist Absicht und kein Fehler.
Erscheint dieser Bildschirm, ohne dass Sie selbst gerade eine Verbindung gestartet haben, klicken Sie auf „Ablehnen". Stimmen Sie nur Verbindungen zu, die Sie selbst in Ihrem eigenen Assistenten angestoßen haben.

Was der Assistent danach kann

Die Verbindung ist rein lesend. Das hier ist die vollständige Liste dessen, was ein Assistent abfragen kann — mehr gibt es nicht:

Werkzeug	Was es liefert
`list_properties`	Die Objekte, zu denen Sie Rundgänge aufgenommen haben — mit Anzahl der Aufnahmen, Zeitraum und den vorkommenden Bereichen (zum Beispiel „Erdgeschoss / Küche"). Aufnahmen ohne Objekt erscheinen gesammelt als ein Eintrag ohne Objektnamen.
`list_transcripts`	Ihre Protokolle, neueste zuerst, jeweils mit einer kurzen Vorschau statt des vollständigen Textes. Filterbar nach Objekt und Aufnahmedatum. Standardmäßig 20 Einträge, höchstens 100.
`get_transcript`	Ein Protokoll vollständig: Text, Abschnitte mit Zeitstempel und alle Metadaten. Sehr lange Protokolle werden gekürzt und ausdrücklich als gekürzt markiert, damit ein Teiltext nie für den ganzen gehalten wird.
`search_transcripts`	Volltextsuche über Ihre Protokolle, mit deutscher Wortstammerkennung — „Heizung" findet also auch „Heizungen". Liefert Kennungen und einen hervorgehobenen Textausschnitt; den vollen Text holt der Assistent anschließend gezielt nach.
`whoami`	Zu welchem maklly-Konto die Verbindung gehört und was sie darf.
`search` und `fetch`	Dieselbe Suche und derselbe Volltextabruf noch einmal unter den Namen, die manche Connectoren erwarten — etwa die Deep-Research-Connectoren von ChatGPT.

Jede dieser Abfragen wird ausschließlich für Ihr Konto beantwortet. Welches Konto das ist, entscheidet die Verbindung selbst. Ein Assistent kann also nicht nach den Rundgängen anderer Personen fragen — auch dann nicht, wenn man ihn darum bittet.

Gute erste Fragen

Sie müssen keine Werkzeugnamen kennen und keine Befehle eingeben. Schreiben Sie einfach:

„Zu welchen Objekten hast du Rundgänge?"
„Was habe ich zur Heizung in der Musterstraße 12 gesagt?"
„Fasse alles zusammen, was ich letzten Samstag aufgenommen habe."

Antwortet der Assistent, er finde nichts, prüfen Sie die Punkte unter Fehlerbehebung im Abschnitt „Beim Arbeiten mit dem Assistenten".

Dokumentation durchsuchen