# Сервер MCP

Дайте Claude та іншим агентам шукати в тому, що ви експортували.

Exporter запускає сервер MCP всередині застосунку. Він надає ваші папки експорту Claude, Cursor, VS Code та будь-якому іншому клієнту MCP, лише для читання й лише на вашому Mac. Про навички й командний рядок, якими теж може користуватися агент, читайте на сторінці [Для агентів](https://exporter.dev/agents).

## Запуск

1. Експортуйте принаймні один застосунок у Markdown ([початок роботи](https://exporter.dev/docs/getting-started)). Сервер читає лише файли Markdown.
2. На картці «Сервер MCP» натисніть «запустити». Після цього картка показує `localhost:8744` і рядок «підключити».

Адреса `http://localhost:8744/mcp` (Streamable HTTP), на фіксованому порту. Сервер живе в застосунку: він відповідає, доки Exporter працює, з відкритим чи закритим вікном, і зупиняється, коли ви завершуєте роботу застосунку. Якщо сервер працював, коли ви завершили роботу, він знову запуститься разом із застосунком. `curl -s http://127.0.0.1:8744/health` відповідає `OK`, доки сервер працює.

## Під’єднання Claude Code

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

Додайте `--scope user`, щоб сервер був доступний у кожному проєкті. Кнопка «claude code» на картці копіює цю команду.

## Claude Desktop, Cursor і VS Code

- Claude Desktop: натисніть «claude desktop» на картці. Кнопка копіює запис, який запускає `npx -y mcp-remote http://localhost:8744/mcp` (`npx` постачається з Node.js). Вставте його всередину `mcpServers` у Settings > Developer > Edit Config, збережіть, потім завершіть роботу Claude і відкрийте його знову
- Cursor або VS Code: натисніть «cursor» або «vs code» на картці. Редактор відкривається із сервером, готовим до встановлення; підтвердьте там

## Які папки він надає

Папки експорту, що лежать у тій самій батьківській папці, що й папка експорту Нотаток Apple (якщо її немає, то першу знайдену папку експорту). Папка експорту в будь-якому іншому місці невидима для агентів, а картка «Сервер MCP» показує, які папки вони бачать.

| папки експорту | надаються |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | обидві |
| `~/Documents/notes`, `~/Dropbox/messages` | лише notes |

Щоб додати папку, натисніть «змінити...» в рядку «експортувати до» відповідного застосунку, виберіть папку в тій самій батьківській папці, потім натисніть «повна ресинхронізація» на цій картці. Сервер читає перелік папок під час запуску, тож після будь-якої зміни натисніть «зупинити» і «запустити». Кожне джерело називається за своєю папкою, як-от `notes` або `messages`.

## Шість інструментів

| інструмент | що робить | параметри |
| --- | --- | --- |
| `get_stats` | для кожного джерела: кількість файлів, найновіша й найстаріша дати, розмір. Викликайте першим, щоб дізнатися назви джерел | `source` (необов’язковий) |
| `search` | повнотекстовий пошук із ранжуванням | `query`, `source` (необов’язковий), `limit` (20) |
| `read` | один елемент: його Markdown, front matter, дата зміни й розмір | `source`, `id` (назва файлу без `.md`) |
| `list` | елементи одного джерела | `source`, `limit` (50), `offset` (0) |
| `get_recent` | елементи, змінені найнещодавніше | `sources` (через кому, необов’язковий), `limit` (20) |
| `get_metadata` | кількості й час останньої синхронізації | `source` (необов’язковий) |

`search` ранжує Нотатки Apple, Контакти й Повідомлення за індексом застосунку: ім’я знаходить розмову, а знайдена нотатка містить посилання, яке відкриває її в Нотатках Apple. Bear, Logseq, Екранний час і Документи теж надаються, але `search` не ранжує їх, доки відповідає індекс; до них можна дістатися через `list`, `get_recent` і `read`. Доки індекс ще порожній, `search` переглядає Markdown кожного джерела.

Відповіді повні настільки, наскільки повний експорт: у безкоштовному ліміті це перші 100 нотаток, 100 контактів і 10 останніх розмов, 10 днів і 10 документів.

## Конфіденційність

Сервер слухає 127.0.0.1, тож ніщо поза вашим Mac не може до нього дістатися, і він лише читає. Те, що повертає інструмент, стає частиною вашої розмови з ШІ й надходить до його моделі, як і все, що ви вставляєте.

## Коли він не працює

- `No export folders configured. Set an export folder first.`: виберіть папку експорту на будь-якій картці
- `No exported notes found. Run an export first.`: натисніть «синхронізувати зараз» на картці, потім «запустити»
- системна помилка під час запуску: порт 8744 використовує інша програма. Завершіть її роботу й запустіть знову
- джерела бракує: воно лежить поза батьківською папкою, було експортоване лише як HTML, з’явилося після запуску сервера або перевищує безкоштовний ліміт

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