Il server MCP

Exporter esegue un server MCP dentro l’app. Serve le sue cartelle di esportazione a Claude, Cursor, VS Code e a qualsiasi altro client MCP, in sola lettura e solo sul suo Mac. Per le skill e la riga di comando, che anche un agente può usare, veda Per gli agenti.

Avviarlo

1. Esporti almeno un’app in Markdown (per iniziare). Il server legge solo file Markdown.
2. Sulla scheda Server MCP, prema “avvia”. La scheda mostra poi localhost:8744 e una riga “collega”.

L’endpoint è http://localhost:8744/mcp (Streamable HTTP), su una porta fissa. Il server vive nell’app: risponde finché Exporter è in esecuzione, con la finestra aperta o chiusa, e si ferma quando esce dall’app. Se era in esecuzione quando è uscito, riparte insieme all’app. curl -s http://127.0.0.1:8744/health risponde OK finché è attivo.

Collegare Claude Code

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

Aggiunga --scope user per averlo in ogni progetto. Il pulsante “claude code” della scheda copia questo comando.

Claude Desktop, Cursor e VS Code

• Claude Desktop: prema “claude desktop” sulla scheda. Copia una voce che esegue npx -y mcp-remote http://localhost:8744/mcp (npx è incluso in Node.js). La incolli dentro mcpServers in Settings > Developer > Edit Config, salvi, poi chiuda Claude e lo riapra
• Cursor o VS Code: prema “cursor” o “vs code” sulla scheda. L’editor si apre con il server pronto da installare; confermi lì

Quali cartelle serve

Le cartelle di esportazione che si trovano nella stessa cartella superiore della cartella di esportazione di Apple Notes (senza di essa, la prima cartella di esportazione che trova). Una cartella di esportazione che si trova altrove non è visibile agli agenti, e la scheda Server MCP indica quali possono vedere.

cartelle di esportazione	servite
~/Documents/notes, ~/Documents/messages	entrambe
~/Documents/notes, ~/Dropbox/messages	solo le note

Per includere una cartella, prema “cambia…” sulla riga esporta in di quell’app, scelga una cartella nella stessa cartella superiore, poi “risincronizza tutto” su quella scheda. Il server legge l’elenco delle cartelle all’avvio, quindi dopo ogni modifica prema “arresta” e poi “avvia”. Ogni sorgente prende il nome dalla sua cartella, come notes o messages.

I sei strumenti

strumento	cosa fa	parametri
get_stats	per sorgente: numero di file, date più recente e meno recente, dimensione. Lo chiami per primo per conoscere i nomi delle sorgenti	source (facoltativo)
search	ricerca full-text con ordinamento per pertinenza	query, source (facoltativo), limit (20)
read	un elemento: il suo Markdown, il front matter, la data di modifica e la dimensione	source, id (il nome del file senza .md)
list	gli elementi di una sorgente	source, limit (50), offset (0)
get_recent	gli elementi modificati più di recente	sources (separate da virgole, facoltativo), limit (20)
get_metadata	conteggi e orari dell’ultima sincronizzazione	source (facoltativo)

search ordina Apple Notes, Contatti e Messaggi sull’indice dell’app: un nome trova la conversazione, e un risultato di nota contiene un link che la apre in Apple Notes. Anche Bear, Logseq, Tempo di utilizzo e Documenti vengono serviti, ma search non li ordina finché risponde l’indice; li raggiunga con list, get_recent e read. Finché l’indice è ancora vuoto, search analizza il Markdown di ogni sorgente.

Le risposte sono complete quanto l’esportazione: con la quota gratuita sono le prime 100 note, 100 contatti e le 10 conversazioni più recenti, 10 giorni e 10 documenti.

Privacy

Il server ascolta su 127.0.0.1, quindi nulla al di fuori del suo Mac può raggiungerlo, e si limita a leggere. Ciò che uno strumento restituisce entra nella sua conversazione con l’IA e arriva al suo modello, come qualsiasi cosa incolli.

Quando non funziona

• Nessuna cartella di esportazione configurata. Ne imposti prima una.: scelga una cartella di esportazione su una scheda qualsiasi
• Nessuna nota esportata trovata. Esegua prima un’esportazione.: prema “sincronizza ora” su una scheda, poi “avvia”
• un errore di sistema su “avvia”: un altro programma usa la porta 8744. Lo chiuda e avvii di nuovo
• manca una sorgente: si trova fuori dalla cartella superiore, è stata esportata solo in HTML, è comparsa dopo l’avvio del server, oppure è oltre la quota gratuita