# Serwer MCP

Pozwól Claude i innym agentom przeszukiwać to, co wyeksportowałeś.

Exporter uruchamia serwer MCP w aplikacji. Udostępnia twoje foldery eksportu Claude, Cursor, VS Code i każdemu innemu klientowi MCP, tylko do odczytu i tylko na twoim Macu. Umiejętności i wiersz poleceń, z których agent też może korzystać, opisuje strona [Dla agentów](https://exporter.dev/agents).

## Uruchomienie

1. Wyeksportuj co najmniej jedną aplikację jako Markdown ([pierwsze kroki](https://exporter.dev/docs/getting-started)). Serwer czyta tylko pliki Markdown.
2. Na karcie Serwer MCP naciśnij „uruchom”. Karta pokaże wtedy `localhost:8744` i wiersz „połącz”.

Punkt końcowy to `http://localhost:8744/mcp` (Streamable HTTP), na stałym porcie. Serwer żyje w aplikacji: odpowiada, dopóki Exporter działa, przy otwartym lub zamkniętym oknie, i zatrzymuje się, gdy zakończysz aplikację. Jeśli działał, gdy ją zakończyłeś, uruchomi się ponownie razem z nią. `curl -s http://127.0.0.1:8744/health` odpowiada `OK`, dopóki serwer działa.

## Połącz Claude Code

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

Dodaj `--scope user`, żeby mieć go w każdym projekcie. Przycisk „claude code” na karcie kopiuje to polecenie.

## Claude Desktop, Cursor i VS Code

- Claude Desktop: naciśnij „claude desktop” na karcie. Kopiuje to wpis, który uruchamia `npx -y mcp-remote http://localhost:8744/mcp` (`npx` jest instalowany razem z Node.js). Wklej go wewnątrz `mcpServers` w Settings > Developer > Edit Config, zapisz, a potem zakończ Claude i otwórz go ponownie
- Cursor lub VS Code: naciśnij „cursor” lub „vs code” na karcie. Edytor otworzy się z serwerem gotowym do instalacji; potwierdź tam

## Które foldery udostępnia

Foldery eksportu, które leżą w tym samym folderze nadrzędnym co folder eksportu Notatek Apple (bez niego pierwszy znaleziony folder eksportu). Folder eksportu w innym miejscu jest niewidoczny dla agentów, a karta Serwer MCP pokazuje, które z nich widzą.

| foldery eksportu | udostępniane |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | oba |
| `~/Documents/notes`, `~/Dropbox/messages` | tylko notes |

Aby dołączyć folder, naciśnij „zmień...” w wierszu `eksportuj do` danej aplikacji, wybierz folder w tym samym folderze nadrzędnym, a potem „pełna resynchronizacja” na tej karcie. Serwer czyta listę folderów przy uruchomieniu, więc po każdej zmianie naciśnij „zatrzymaj” i „uruchom”. Każde źródło nosi nazwę swojego folderu, na przykład `notes` lub `messages`.

## Sześć narzędzi

| narzędzie | co robi | parametry |
| --- | --- | --- |
| `get_stats` | dla każdego źródła: liczba plików, najnowsza i najstarsza data, rozmiar. Wywołaj je najpierw, żeby poznać nazwy źródeł | `source` (opcjonalny) |
| `search` | wyszukiwanie pełnotekstowe z rankingiem | `query`, `source` (opcjonalny), `limit` (20) |
| `read` | jeden element: jego Markdown, frontmatter, data modyfikacji i rozmiar | `source`, `id` (nazwa pliku bez `.md`) |
| `list` | elementy jednego źródła | `source`, `limit` (50), `offset` (0) |
| `get_recent` | ostatnio zmienione elementy | `sources` (rozdzielone przecinkami, opcjonalny), `limit` (20) |
| `get_metadata` | liczby i czasy ostatniej synchronizacji | `source` (opcjonalny) |

`search` szereguje Notatki Apple, Kontakty i Wiadomości według indeksu aplikacji: imię i nazwisko znajduje rozmowę, a trafienie w notatce ma link, który otwiera ją w Notatkach Apple. Bear, Logseq, Czas przed ekranem i Dokumenty też są udostępniane, ale `search` ich nie szereguje, dopóki odpowiada indeks; sięgaj do nich przez `list`, `get_recent` i `read`. Dopóki indeks jest jeszcze pusty, `search` przeszukuje Markdown każdego źródła.

Odpowiedzi są tak kompletne jak eksport: w darmowym limicie to pierwsze 100 notatek, 100 kontaktów i 10 najnowszych rozmów, 10 dni i 10 dokumentów.

## Prywatność

Serwer nasłuchuje na 127.0.0.1, więc nic spoza twojego Maca nie może się z nim połączyć, i tylko czyta. To, co zwraca narzędzie, staje się częścią twojej rozmowy z AI i trafia do jej modelu, jak wszystko, co wklejasz.

## Gdy to nie działa

- `No export folders configured. Set an export folder first.`: wybierz folder eksportu na dowolnej karcie
- `No exported notes found. Run an export first.`: naciśnij „synchronizuj teraz” na karcie, a potem „uruchom”
- błąd systemowy po „uruchom”: port 8744 zajmuje inny program. Zakończ go i uruchom ponownie
- brakuje źródła: leży poza folderem nadrzędnym, zostało wyeksportowane tylko jako HTML, pojawiło się po uruchomieniu serwera albo jest ponad darmowym limitem

## 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/pl/docs/mcp
every page: https://exporter.dev/llms.txt