# MCP server

Nechte Claude a další agenty prohledávat, co jste exportovali.

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](https://exporter.dev/agents).

## Spuštění

1. Exportujte alespoň jednu aplikaci jako Markdown ([začínáme](https://exporter.dev/docs/getting-started)). 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

```sh
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

## Related

- [For agents](https://exporter.dev/agents): Skills, command line and MCP for agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac
- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code

---

human version: https://exporter.dev/cs/docs/mcp
every page: https://exporter.dev/llms.txt