Az MCP-szerver
Hadd keressen Claude és más AI-ügynökök abban, amit exportált.
Az Exporter az appon belül MCP-szervert futtat. Az exportmappáit szolgálja ki a Claude, a Cursor, a VS Code és bármely más MCP-kliens számára, csak olvasásra, és csak a Macjén. Az AI-ügynökök által szintén használható skillekről és parancssorról az AI-ügynököknek oldal szól.
Indítás
- Exportáljon legalább egy appot Markdownként (első lépések). A szerver csak Markdown fájlokat olvas.
- Az MCP-szerver kártyán nyomja meg az „indítás” gombot. A kártyán ezután megjelenik a
localhost:8744és egy „csatlakoztatás” sor.
A végpont a http://localhost:8744/mcp (Streamable HTTP), rögzített porton. A szerver az appban él: válaszol, amíg az Exporter fut, nyitott vagy zárt ablakkal, és leáll, amikor kilép az appból. Ha futott, amikor kilépett, az appal együtt újraindul. A curl -s http://127.0.0.1:8744/health válasza OK, amíg fut.
Claude Code csatlakoztatása
claude mcp add --transport http exporter http://localhost:8744/mcp
Adja hozzá a --scope user kapcsolót, ha minden projektben szeretné. A kártya „claude code” gombja ezt a parancsot másolja ki.
Claude Desktop, Cursor és VS Code
- Claude Desktop: nyomja meg a „claude desktop” gombot a kártyán. Ez egy bejegyzést másol ki, amely az
npx -y mcp-remote http://localhost:8744/mcpparancsot futtatja (aznpxa Node.js része). Illessze be azmcpServersrészbe a Settings > Developer > Edit Config alatt, mentse, majd lépjen ki a Claude-ból, és nyissa meg újra - Cursor vagy VS Code: nyomja meg a „cursor” vagy a „vs code” gombot a kártyán. A szerkesztő megnyílik, a szerver telepítésre készen; ott erősítse meg
Mely mappákat szolgálja ki
Azokat az exportmappákat, amelyek ugyanabban a szülőmappában vannak, mint az Apple Notes exportmappája (ha ilyen nincs, az első exportmappát, amelyet talál). Egy máshol lévő exportmappa láthatatlan az AI-ügynökök számára, és az MCP-szerver kártya megmutatja, melyeket látják.
| exportmappák | kiszolgálva |
|---|---|
~/Documents/notes, ~/Documents/messages |
mindkettő |
~/Documents/notes, ~/Dropbox/messages |
csak a notes |
Egy mappa bevonásához nyomja meg a „módosítás…” gombot az adott app „exportálás ide” sorában, válasszon egy mappát ugyanabban a szülőmappában, majd nyomja meg a kártyán a „teljes újraszinkronizálás” gombot. A szerver induláskor olvassa be a mappák listáját, ezért minden változtatás után nyomja meg a „leállítás”, majd az „indítás” gombot. Minden forrás a mappájáról kapja a nevét, például notes vagy messages.
A hat eszköz
| eszköz | mit csinál | paraméterek |
|---|---|---|
get_stats |
forrásonként: fájlok száma, legújabb és legrégebbi dátum, méret. Hívja meg először, hogy megtudja a források nevét | source (nem kötelező) |
search |
rangsorolt teljes szöveges keresés | query, source (nem kötelező), limit (20) |
read |
egy elem: a Markdownja, a front matter, a módosítás dátuma és a mérete | source, id (a fájlnév .md nélkül) |
list |
egy forrás elemei | source, limit (50), offset (0) |
get_recent |
a legutóbb módosított elemek | sources (vesszővel elválasztva, nem kötelező), limit (20) |
get_metadata |
darabszámok és az utolsó szinkronizálások ideje | source (nem kötelező) |
A search az app indexe alapján rangsorolja az Apple Notes, a Kontaktok és az Üzenetek találatait: egy név megtalálja a beszélgetést, egy jegyzettalálat pedig olyan linket hoz, amely megnyitja a jegyzetet az Apple Notesban. A Bear, a Logseq, a Képernyőidő és a Dokumentumok is ki vannak szolgálva, de a search nem rangsorolja őket, amíg az index válaszol; ezeket a list, a get_recent és a read eszközzel érheti el. Amíg az index még üres, a search minden forrás Markdownját átvizsgálja.
A válaszok csak annyira teljesek, amennyire az export: az ingyenes kerettel ez az első 100 jegyzet, 100 kontakt és a 10 legutóbbi beszélgetés, 10 nap és 10 dokumentum.
Adatvédelem
A szerver a 127.0.0.1 címen figyel, így semmi a Macjén kívülről nem érheti el, és csak olvas. Amit egy eszköz visszaad, az a beszélgetése része lesz az AI-jal, és eljut a modelljéhez, mint bármi, amit beilleszt.
Ha nem működik
Nincs beállított exportmappa. Először állítson be egyet.: válasszon exportmappát bármelyik kártyánNem található exportált jegyzet. Először futtasson egy exportálást.: nyomja meg egy kártyán a „szinkronizálás most”, majd az „indítás” gombot- rendszerhiba az „indítás” megnyomásakor: egy másik program használja a 8744-es portot. Lépjen ki belőle, és indítsa újra
- hiányzik egy forrás: a szülőmappán kívül van, csak HTML-ként exportálta, a szerver indulása után jelent meg, vagy túl van az ingyenes kereten