O servidor MCP

Deixe o Claude e outros agentes pesquisarem o que você exportou.

O Exporter roda um servidor MCP dentro do app. Ele entrega as suas pastas de exportação ao Claude, ao Cursor, ao VS Code e a qualquer outro cliente MCP, somente leitura e só no seu Mac. Para as skills e a linha de comando que um agente também pode usar, veja Para agentes.

Iniciar

Exporte pelo menos um app como Markdown (primeiros passos). O servidor lê só arquivos Markdown.
No cartão Servidor MCP, clique em “iniciar”. O cartão passa a mostrar localhost:8744 e uma linha “conectar”.

O endpoint é http://localhost:8744/mcp (Streamable HTTP), numa porta fixa. O servidor vive no app: ele responde enquanto o Exporter está aberto, com a janela aberta ou fechada, e para quando você encerra o app. Se ele estava rodando quando você encerrou o app, ele inicia de novo junto com o app. curl -s http://127.0.0.1:8744/health responde OK enquanto ele está no ar.

Conectar o Claude Code

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

Adicione --scope user para tê-lo em todos os projetos. O botão “claude code” do cartão copia este comando.

Claude Desktop, Cursor e VS Code

Claude Desktop: clique em “claude desktop” no cartão. Ele copia uma entrada que roda npx -y mcp-remote http://localhost:8744/mcp (o npx vem com o Node.js). Cole-a dentro de mcpServers em Settings > Developer > Edit Config, salve e depois encerre o Claude e abra-o de novo
Cursor ou VS Code: clique em “cursor” ou “vs code” no cartão. O editor abre com o servidor pronto para instalar; confirme por lá

Quais pastas ele entrega

As pastas de exportação que ficam na mesma pasta-mãe que a pasta de exportação do Apple Notes (sem ela, a primeira pasta de exportação que ele encontra). Uma pasta de exportação em qualquer outro lugar fica invisível para os agentes, e o cartão Servidor MCP diz quais eles conseguem ver.

pastas de exportação	entregues
`~/Documents/notes`, `~/Documents/messages`	as duas
`~/Documents/notes`, `~/Dropbox/messages`	só notes

Para incluir uma pasta, clique em “alterar…” na linha “exportar para” daquele app, escolha uma pasta na mesma pasta-mãe e depois clique em “ressincronização completa” naquele cartão. O servidor lê a lista de pastas quando inicia, então clique em “parar” e em “iniciar” depois de qualquer mudança. Cada fonte recebe o nome da sua pasta, como notes ou messages.

As seis ferramentas

ferramenta	o que faz	parâmetros
`get_stats`	por fonte: número de arquivos, datas mais nova e mais antiga, tamanho. Chame primeiro para saber os nomes das fontes	`source` (opcional)
`search`	busca de texto completo, ordenada por relevância	`query`, `source` (opcional), `limit` (20)
`read`	um item: o seu Markdown, o front matter, a data de modificação e o tamanho	`source`, `id` (o nome do arquivo sem `.md`)
`list`	os itens de uma fonte	`source`, `limit` (50), `offset` (0)
`get_recent`	os itens alterados mais recentemente	`sources` (separadas por vírgula, opcional), `limit` (20)
`get_metadata`	contagens e horários da última sincronização	`source` (opcional)

search ordena Apple Notes, Contatos e Mensagens pelo índice do app: um nome encontra a conversa, e um resultado de nota traz um link que a abre no Apple Notes. Bear, Logseq, Tempo de Uso e Documentos também são entregues, mas search não os ordena enquanto o índice responde; chegue a eles com list, get_recent e read. Enquanto o índice ainda está vazio, search percorre o Markdown de todas as fontes.

As respostas só são tão completas quanto a exportação: na cota gratuita, isso são as suas primeiras 100 notas, 100 contatos e 10 conversas mais recentes, 10 dias e 10 documentos.

Privacidade

O servidor escuta em 127.0.0.1, então nada fora do seu Mac consegue alcançá-lo, e ele só lê. O que uma ferramenta devolve passa a fazer parte da sua conversa com a IA e vai para o modelo dela, como qualquer coisa que você cola.

Quando não funciona

Nenhuma pasta de exportação configurada. Defina uma pasta de exportação primeiro.: escolha uma pasta de exportação em qualquer cartão
Nenhuma nota exportada encontrada. Faça uma exportação primeiro.: clique em “sincronizar agora” num cartão e depois em “iniciar”
um erro do sistema ao clicar em “iniciar”: outro programa usa a porta 8744. Encerre-o e inicie de novo
falta uma fonte: ela fica fora da pasta-mãe, foi exportada só como HTML, apareceu depois que o servidor iniciou ou passou da cota gratuita