Le serveur MCP

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.

Le démarrer

1. Exportez au moins une app en Markdown (premiers pas). 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

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

Chaque dossier d’export, où qu’il soit, chacun sous le nom de son propre dossier, comme notes ou messages. Deux dossiers de même nom se distinguent par le nom de leur parent, comme export (Bear). Le serveur lit sa liste de dossiers au démarrage : appuyez donc sur « Arrêter » puis « Démarrer » après tout changement.

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 couvre chaque export. Apple Notes, Contacts et Messages sont classés à 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. Les fichiers de toutes les autres apps, dont Mail, Calendrier, Bear, Rappels et Documents, sont parcourus à côté, et les deux listes alternent dans les résultats. 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 50 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