# 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](https://exporter.dev/agents) oldal szól.

## Indítás

1. Exportáljon legalább egy appot Markdownként ([első lépések](https://exporter.dev/docs/getting-started)). A szerver csak Markdown fájlokat olvas.
2. 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

```sh
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/mcp` parancsot futtatja (az `npx` a Node.js része). Illessze be az `mcpServers` ré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án
- `Nem 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

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