# Der MCP-Server

Lassen Sie Claude und andere Agenten durchsuchen, was Sie exportiert haben.

Exporter betreibt einen MCP-Server in der App. Er stellt Ihre Exportordner Claude, Cursor, VS Code und jedem anderen MCP-Client bereit, nur lesend und nur auf Ihrem Mac. Die Skills und die Kommandozeile, die ein Agent ebenfalls nutzen kann, finden Sie unter [Für Agenten](https://exporter.dev/agents).

## Starten

1. Exportieren Sie mindestens eine App als Markdown ([Erste Schritte](https://exporter.dev/docs/getting-started)). Der Server liest nur Markdown-Dateien.
2. Klicken Sie auf der Karte MCP-Server auf „starten“. Die Karte zeigt dann `localhost:8744` und eine Zeile „verbinden“.

Der Endpunkt ist `http://localhost:8744/mcp` (Streamable HTTP), auf einem festen Port. Der Server lebt in der App: Er antwortet, solange Exporter läuft, bei geöffnetem oder geschlossenem Fenster, und stoppt, wenn Sie die App beenden. Lief er beim Beenden, startet er mit der App wieder. `curl -s http://127.0.0.1:8744/health` antwortet mit `OK`, solange er läuft.

## Claude Code verbinden

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

Fügen Sie `--scope user` hinzu, um ihn in jedem Projekt zu haben. Die Taste „claude code“ auf der Karte kopiert diesen Befehl.

## Claude Desktop, Cursor und VS Code

- Claude Desktop: Klicken Sie auf der Karte auf „claude desktop“. Das kopiert einen Eintrag, der `npx -y mcp-remote http://localhost:8744/mcp` ausführt (`npx` gehört zu Node.js). Fügen Sie ihn in `mcpServers` unter Einstellungen > Entwickler > Konfiguration bearbeiten ein, sichern Sie, beenden Sie Claude und öffnen Sie es wieder
- Cursor oder VS Code: Klicken Sie auf der Karte auf „cursor“ oder „vs code“. Der Editor öffnet sich mit dem Server, bereit zur Installation; bestätigen Sie dort

## Welche Ordner er bereitstellt

Die Exportordner, die im selben übergeordneten Ordner liegen wie der Exportordner von Apple Notizen (ohne ihn der erste Exportordner, den er findet). Ein Exportordner an einem anderen Ort ist für Agenten unsichtbar, und die Karte MCP-Server zeigt, welche sie sehen können.

| Exportordner | bereitgestellt |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | beide |
| `~/Documents/notes`, `~/Dropbox/messages` | nur notes |

Um einen Ordner einzubeziehen, klicken Sie in der Zeile „exportieren nach“ der jeweiligen App auf „ändern...“, wählen einen Ordner im selben übergeordneten Ordner und dann „vollständig neu synchronisieren“ auf dieser Karte. Der Server liest seine Ordnerliste beim Start, klicken Sie nach jeder Änderung also auf „stoppen“ und „starten“. Jede Quelle ist nach ihrem Ordner benannt, etwa `notes` oder `messages`.

## Die sechs Tools

| Tool | was es tut | Parameter |
| --- | --- | --- |
| `get_stats` | pro Quelle: Anzahl der Dateien, neuestes und ältestes Datum, Größe. Rufen Sie es zuerst auf, um die Namen der Quellen zu erfahren | `source` (optional) |
| `search` | gewichtete Volltextsuche | `query`, `source` (optional), `limit` (20) |
| `read` | ein Eintrag: sein Markdown, die Front Matter, das Änderungsdatum und die Größe | `source`, `id` (der Dateiname ohne `.md`) |
| `list` | die Einträge einer Quelle | `source`, `limit` (50), `offset` (0) |
| `get_recent` | die zuletzt geänderten Einträge | `sources` (durch Kommas getrennt, optional), `limit` (20) |
| `get_metadata` | Anzahlen und Zeiten der letzten Synchronisierung | `source` (optional) |

`search` gewichtet Apple Notizen, Kontakte und Nachrichten über den Index der App: Ein Name findet die Unterhaltung, und ein Treffer in einer Notiz trägt einen Link, der sie in Apple Notizen öffnet. Bear, Logseq, Bildschirmzeit und Dokumente werden ebenfalls bereitgestellt, aber `search` gewichtet sie nicht, solange der Index antwortet; erreichen Sie sie mit `list`, `get_recent` und `read`. Solange der Index noch leer ist, durchsucht `search` das Markdown jeder Quelle.

Antworten sind nur so vollständig wie der Export: Mit dem kostenlosen Kontingent sind das Ihre ersten 100 Notizen, 100 Kontakte und 10 neuesten Unterhaltungen, 10 Tage und 10 Dokumente.

## Datenschutz

Der Server lauscht auf 127.0.0.1, sodass nichts außerhalb Ihres Macs ihn erreichen kann, und er liest nur. Was ein Tool zurückgibt, wird Teil Ihrer Unterhaltung mit der KI und geht an deren Modell, wie alles, was Sie einfügen.

## Wenn es nicht funktioniert

- `Keine Exportordner konfiguriert. Legen Sie zuerst einen Exportordner fest.`: Wählen Sie auf einer beliebigen Karte einen Exportordner
- `Keine exportierten Notizen gefunden. Führen Sie zuerst einen Export aus.`: Klicken Sie auf einer Karte auf „jetzt synchronisieren“, dann auf „starten“
- ein Systemfehler bei „starten“: Ein anderes Programm nutzt Port 8744. Beenden Sie es und starten Sie erneut
- eine Quelle fehlt: Sie liegt außerhalb des übergeordneten Ordners, wurde nur als HTML exportiert, kam nach dem Start des Servers hinzu oder liegt über dem kostenlosen Kontingent

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