MCP server

Exporter spouští MCP server uvnitř aplikace. Zpřístupňuje vaše složky exportu pro Claude, Cursor, VS Code a jakéhokoli dalšího klienta MCP, jen pro čtení a jen na vašem Macu. Skills a příkazovou řádku, které může agent také použít, najdete v části Pro agenty.

Spuštění

1. Exportujte alespoň jednu aplikaci jako Markdown (začínáme). Server čte jen soubory Markdown.
2. Na kartě MCP server stiskněte “spustit”. Karta pak ukáže localhost:8744 a řádek “připojit”.

Koncový bod je http://localhost:8744/mcp (Streamable HTTP), na pevném portu. Server žije v aplikaci: odpovídá, dokud Exporter běží, s otevřeným i zavřeným oknem, a zastaví se, když aplikaci ukončíte. Pokud běžel, když jste aplikaci ukončili, spustí se znovu spolu s ní. curl -s http://127.0.0.1:8744/health odpovídá OK, dokud server běží.

Připojení Claude Code

claude mcp add --transport http exporter http://localhost:8744/mcp

Přidejte --scope user, abyste ho měli v každém projektu. Tlačítko “claude code” na kartě tento příkaz zkopíruje.

Claude Desktop, Cursor a VS Code

• Claude Desktop: stiskněte na kartě “claude desktop”. Zkopíruje položku, která spouští npx -y mcp-remote http://localhost:8744/mcp (npx je součástí Node.js). Vložte ji do mcpServers v Settings > Developer > Edit Config, uložte a pak Claude ukončete a znovu otevřete
• Cursor nebo VS Code: stiskněte na kartě “cursor” nebo “vs code”. Editor se otevře se serverem připraveným k instalaci; potvrďte to tam

Které složky zpřístupňuje

Složky exportu, které leží ve stejné nadřazené složce jako složka exportu Apple Notes (bez ní první složku exportu, kterou najde). Složka exportu kdekoli jinde je pro agenty neviditelná a karta MCP server uvádí, které vidí.

složky exportu	zpřístupněno
~/Documents/notes, ~/Documents/messages	obě
~/Documents/notes, ~/Dropbox/messages	jen notes

Chcete-li složku přidat, stiskněte “změnit…” na řádku exportovat do dané aplikace, vyberte složku ve stejné nadřazené složce a pak na této kartě “úplná resynchronizace”. Server načte seznam složek při spuštění, takže po každé změně stiskněte “zastavit” a “spustit”. Každý zdroj se jmenuje podle své složky, například notes nebo messages.

Šest nástrojů

nástroj	co dělá	parametry
get_stats	pro každý zdroj: počet souborů, nejnovější a nejstarší data, velikost. Zavolejte ho jako první, abyste zjistili názvy zdrojů	source (volitelné)
search	fulltextové vyhledávání seřazené podle relevance	query, source (volitelné), limit (20)
read	jedna položka: její Markdown, front matter, datum změny a velikost	source, id (název souboru bez .md)
list	položky jednoho zdroje	source, limit (50), offset (0)
get_recent	naposledy změněné položky	sources (oddělené čárkami, volitelné), limit (20)
get_metadata	počty a časy poslední synchronizace	source (volitelné)

search řadí podle relevance Apple Notes, Kontakty a Zprávy v indexu aplikace: jméno najde konverzaci a nalezená poznámka nese odkaz, který ji otevře v Apple Notes. Bear, Logseq, Čas u obrazovky a Dokumenty jsou zpřístupněné také, ale dokud odpovídá index, search je neřadí; dostanete se k nim přes list, get_recent a read. Dokud je index ještě prázdný, search prochází Markdown všech zdrojů.

Odpovědi jsou jen tak úplné jako export: v rámci limitu zdarma to je prvních 100 poznámek, 100 kontaktů a 10 nejnovějších konverzací, 10 dnů a 10 dokumentů.

Soukromí

Server naslouchá na 127.0.0.1, takže se k němu nic mimo váš Mac nedostane, a jen čte. Co nástroj vrátí, se stane součástí vaší konverzace s AI a jde do jejího modelu, stejně jako cokoli, co vložíte.

Když to nefunguje

• No export folders configured. Set an export folder first.: vyberte složku exportu na kterékoli kartě
• No exported notes found. Run an export first.: stiskněte na kartě “synchronizovat nyní” a pak “spustit”
• systémová chyba při “spustit”: port 8744 používá jiný program. Ukončete ho a spusťte server znovu
• chybí zdroj: leží mimo nadřazenou složku, byl exportován jen jako HTML, objevil se až po spuštění serveru, nebo je za hranicí limitu zdarma