KI verbinden

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

Sobald der KI-Zugriff eingeschaltet ist, liegen Ihre Transkripte auf dem maklly-Server — lesen kann sie aber erst ein Assistent, den Sie verbinden und bestätigen. Das Verbinden passiert im Browser, und dieser Browser muss bei maklly angemeldet sein.

1. Die maklly-Web-App vom iPhone aus öffnen

Ein Konto, das mit Mit Apple anmelden angelegt wurde, hat kein Web-Passwort. Der Weg in den Browser führt deshalb über die App:

Gehen Sie in der maklly-App auf Einstellungen → KI-Zugriff.
Tippen Sie auf KI verbinden.
Bestätigen Sie noch einmal mit Apple. Das ist nicht überflüssig: Eine frische Apple-Bestätigung ist der einzige Nachweis, gegen den maklly eine angemeldete Web-Sitzung eintauscht.
Safari öffnet die maklly-Web-App — bereits angemeldet.

Erledigen Sie den Rest in genau diesem Browser, also auf dem iPhone. Ein Browser auf einem anderen Gerät ist nicht angemeldet, und die Verbindung endet dort auf der Anmeldeseite. Die übergebene Sitzung gilt 24 Stunden und wird danach nicht gespeichert; tippen Sie bei Bedarf einfach erneut auf KI verbinden.

Wenn Sie Ihr Konto in der Web-App angelegt haben und sich dort mit E-Mail-Adresse und Passwort anmelden, können Sie sich stattdessen in jedem beliebigen Browser anmelden.

2. maklly als Connector hinzufügen

Fügen Sie in Ihrem Assistenten einen eigenen Connector hinzu (Claude nennt das Custom Connector, andere Clients sprechen von MCP-Servern) und geben Sie diese Adresse an:

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

Es gibt keinen Schlüssel zu kopieren und kein Passwort einzugeben. Der Connector meldet sich selbst an und schickt Sie danach zu maklly, um die Verbindung zu bestätigen. maklly veröffentlicht die üblichen OAuth-Discovery-Dokumente — ein konformer Client braucht also nichts außer der Adresse oben.

3. Verbindung bestätigen

maklly zeigt einen Bestätigungsbildschirm: „Name des Clients verbinden?", dazu die E-Mail-Adresse des Kontos und je eine Zeile pro Berechtigung. Prüfen Sie, ob es das richtige Konto ist, und klicken Sie dann auf Zustimmen.

Sie stimmen damit zu, dass der Client

jedes Begehungstranskript lesen darf, das mit Ihrem Konto synchronisiert ist — den vollständigen Text samt Metadaten (Objekt, Bereich, Datum, Standort);
diesen Zugriff im Hintergrund behalten darf, ohne erneut nachzufragen, bis Sie ihn wieder trennen — sofern der Client danach gefragt hat.

Ihre Audioaufnahmen und Fotos erhält er nie, und er kann nichts hinzufügen, ändern oder löschen. Zustimmungen werden nicht gespeichert: Der Bildschirm erscheint bei jeder Anfrage erneut, auch bei einem Client, dem Sie vor einer Minute zugestimmt haben. Erscheint so ein Bildschirm, ohne dass Sie selbst eine Verbindung gestartet haben, klicken Sie auf Ablehnen.

Was der Assistent danach kann

Die Verbindung ist rein lesend. Das sind genau die Dinge, die ein Assistent abfragen kann:

Werkzeug	Was es liefert
`list_properties`	Die Objekte, zu denen Sie Begehungen 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 Transkripte, neueste zuerst, mit kurzer Vorschau statt vollständigem Text. Filterbar nach Objekt und Aufnahmedatum, standardmäßig 20 und höchstens 100 Einträge.
`get_transcript`	Ein Transkript vollständig: Text, Abschnitte mit Zeitstempel und alle Metadaten. Sehr lange Transkripte 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 Transkripte, 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 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 Begehungen anderer fragen.