Connect an AI assistant

Give Claude, ChatGPT or another MCP client read access to your transcripts.

Once AI access is on, your transcripts sit on maklly's server — but no assistant can read them until you connect one and approve it. Connecting happens in a browser, and it is the browser that has to be signed in to maklly.

1. Open the maklly web app from your iPhone

An account created with Sign in with Apple has no web password, so the way into the browser is from the app:

In the maklly app, go to Settings → AI Access.
Tap Connect an AI assistant (in German: KI verbinden).
Confirm with Apple once more. This is not redundant — a fresh Apple confirmation is the only proof maklly will trade for a signed-in web session.
Safari opens the maklly web app, already signed in.

Do the rest in that same browser, on the phone. A browser on another device is not signed in and the connection will stop on the sign-in page. The handoff session lasts 24 hours and is not remembered afterwards; tap Connect an AI assistant again whenever you need it.

If you created your account in the web app and sign in there with an email address and password, you can simply sign in in any browser instead.

2. Add maklly as a connector

In your assistant, add a custom connector (Claude calls these custom connectors; other clients call them MCP servers) and give it this address:

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

There is no key to copy and no password to paste. The connector registers itself and then sends you to maklly to approve it. maklly publishes the standard OAuth discovery documents, so a compliant client needs nothing but the address above.

3. Approve the connection

maklly shows an approval screen: Connect name of the client?, the account email it would be connected to, and one line per permission. Check the account is the right one, then press Approve.

What you are approving:

Read every walkthrough transcript synced to your account — the full text and its metadata (property, area, date, location).
Keep that access in the background, without asking again, until you disconnect it — if the client asked for it.

It never receives your audio recordings or photos, and it cannot add, change or delete anything. Approvals are not remembered, so the screen appears again every time a client asks for access — including a client you approved a minute ago. If a screen like this appears when you did not start a connection yourself, press Deny.

What the assistant can do once connected

The connection is read-only. These are the exact things an assistant can ask for:

Tool	What it returns
`list_properties`	The properties you recorded walkthroughs for, with the number of recordings, the capture window and the area paths seen (for example "Erdgeschoss / Küche"). Recordings captured without a property appear once as the unfiled bucket.
`list_transcripts`	Your transcripts, newest first, with a short preview instead of the full text. Can be filtered by property and by capture date, 20 rows by default and 100 at most.
`get_transcript`	One transcript in full: text, timestamped segments and all metadata. A very long transcript is cut off and carries an explicit truncation marker, so a partial text is never mistaken for a complete one.
`search_transcripts`	Full-text search across your transcripts, with German stemming — "Heizung" also finds "Heizungen". Returns ids and a highlighted snippet; the assistant then fetches the ones it needs.
`whoami`	Which maklly account the connection belongs to and what it is allowed to do.
`search` and `fetch`	The same search and full-document lookup under the names some connectors expect, for example ChatGPT's deep research connectors.

Every one of these is answered for your account only. Which account is decided by the connection itself, so there is no way for an assistant to ask about anyone else's walkthroughs.