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

Ogni cartella di esportazione, ovunque si trovi, ciascuna con il nome della sua cartella, come notes o messages. Due cartelle con lo stesso nome si distinguono per il nome della cartella superiore, come export (Bear). Il server legge l’elenco delle cartelle all’avvio, quindi dopo ogni modifica prema “Arresta” e poi “Avvia”.

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 copre ogni esportazione. Apple Notes, Contatti e Messaggi vengono ordinati sull’indice dell’app: un nome trova la conversazione, e un risultato di nota contiene un link che la apre in Apple Notes. I file di ogni altra app, tra cui Mail, Calendario, Bear, Promemoria e Documenti, vengono analizzati accanto, e le due liste si alternano nei risultati. 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 50 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