# Le serveur MCP

Laissez Claude et d’autres agents chercher dans ce que vous avez exporté.

Exporter fait tourner un serveur MCP dans l’app. Il sert vos dossiers d’export à Claude, Cursor, VS Code et à tout autre client MCP, en lecture seule et sur votre Mac uniquement. Pour les skills et la ligne de commande qu’un agent peut aussi utiliser, consultez [Pour les agents](https://exporter.dev/agents).

## Le démarrer

1. Exportez au moins une app en Markdown ([premiers pas](https://exporter.dev/docs/getting-started)). Le serveur ne lit que les fichiers Markdown.
2. Sur la carte Serveur MCP, appuyez sur « démarrer ». La carte affiche alors `localhost:8744` et une ligne « connecter ».

Le point d’accès est `http://localhost:8744/mcp` (Streamable HTTP), sur un port fixe. Le serveur vit dans l’app : il répond tant qu’Exporter tourne, fenêtre ouverte ou fermée, et s’arrête quand vous quittez l’app. S’il tournait quand vous avez quitté, il redémarre avec l’app. `curl -s http://127.0.0.1:8744/health` répond `OK` tant qu’il est actif.

## Connecter Claude Code

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

Ajoutez `--scope user` pour l’avoir dans tous vos projets. Le bouton « claude code » de la carte copie cette commande.

## Claude Desktop, Cursor et VS Code

- Claude Desktop : appuyez sur « claude desktop » sur la carte. Il copie une entrée qui lance `npx -y mcp-remote http://localhost:8744/mcp` (`npx` est fourni avec Node.js). Collez-la dans `mcpServers` sous Settings > Developer > Edit Config, enregistrez, puis quittez Claude et rouvrez-le
- Cursor ou VS Code : appuyez sur « cursor » ou « vs code » sur la carte. L’éditeur s’ouvre avec le serveur prêt à être installé ; confirmez-y

## Les dossiers servis

Les dossiers d’export qui se trouvent dans le même dossier parent que le dossier d’export d’Apple Notes (sans lui, le premier dossier d’export trouvé). Un dossier d’export situé ailleurs est invisible pour les agents, et la carte Serveur MCP indique ceux qu’ils peuvent voir.

| dossiers d’export | servis |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | les deux |
| `~/Documents/notes`, `~/Dropbox/messages` | notes uniquement |

Pour intégrer un dossier, appuyez sur « changer… » sur la ligne `exporter vers` de cette app, choisissez un dossier dans le même parent, puis « resynchronisation complète » sur cette carte. Le serveur lit sa liste de dossiers au démarrage : appuyez donc sur « arrêter » puis « démarrer » après tout changement. Chaque source porte le nom de son dossier, comme `notes` ou `messages`.

## Les six outils

| outil | effet | paramètres |
| --- | --- | --- |
| `get_stats` | par source : nombre de fichiers, dates la plus récente et la plus ancienne, taille. Appelez-le en premier pour connaître les noms des sources | `source` (facultatif) |
| `search` | recherche plein texte classée | `query`, `source` (facultatif), `limit` (20) |
| `read` | un élément : son Markdown, son front matter, sa date de modification et sa taille | `source`, `id` (le nom du fichier sans `.md`) |
| `list` | les éléments d’une source | `source`, `limit` (50), `offset` (0) |
| `get_recent` | les éléments modifiés le plus récemment | `sources` (séparées par des virgules, facultatif), `limit` (20) |
| `get_metadata` | nombres et heures de dernière synchronisation | `source` (facultatif) |

`search` classe Apple Notes, Contacts et Messages à l’aide de l’index de l’app : un nom trouve la conversation, et un résultat de note porte un lien qui l’ouvre dans Apple Notes. Bear, Logseq, Temps d’écran et Documents sont servis aussi, mais `search` ne les classe pas tant que l’index répond ; atteignez-les avec `list`, `get_recent` et `read`. Tant que l’index est encore vide, `search` parcourt le Markdown de chaque source.

Les réponses ne sont pas plus complètes que l’export : avec le quota gratuit, ce sont vos 100 premières notes, 100 contacts et 10 conversations les plus récentes, 10 jours et 10 documents.

## Confidentialité

Le serveur écoute sur 127.0.0.1 : rien en dehors de votre Mac ne peut l’atteindre, et il ne fait que lire. Ce que renvoie un outil fait partie de votre conversation avec l’IA et part vers son modèle, comme tout ce que vous collez.

## Quand ça ne marche pas

- `Aucun dossier d’export configuré. Définissez-en un d’abord.` : choisissez un dossier d’export sur n’importe quelle carte
- `Aucune note exportée. Lancez d’abord un export.` : appuyez sur « synchroniser » sur une carte, puis sur « démarrer »
- une erreur système au « démarrer » : un autre programme utilise le port 8744. Quittez-le et démarrez à nouveau
- une source manque : elle se trouve hors du dossier parent, a été exportée uniquement en HTML, est apparue après le démarrage du serveur, ou dépasse le quota gratuit

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