# Il server MCP

Permetta a Claude e ad altri agenti di cercare in ciò che ha esportato.

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](https://exporter.dev/agents).

## Avviarlo

1. Esporti almeno un'app in Markdown ([per iniziare](https://exporter.dev/docs/getting-started)). 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

```sh
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

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