O servidor MCP

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

1. Exporte pelo menos um app como Markdown (primeiros passos). O servidor lê só arquivos Markdown.
2. 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

Todas as pastas de exportação, onde quer que estejam, cada uma com o nome da sua pasta, como notes ou messages. Duas pastas com o mesmo nome são diferenciadas pelo nome da pasta-mãe, como export (Bear). O servidor lê a lista de pastas quando inicia, então clique em “Parar” e em “Iniciar” depois de qualquer mudança.

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 cobre todas as exportações. Apple Notes, Contatos e Mensagens são ordenados pelo índice do app: um nome encontra a conversa, e um resultado de nota traz um link que a abre no Apple Notes. Os arquivos de todos os outros apps, entre eles Mail, Calendário, Bear, Lembretes e Documentos, são percorridos ao lado, e as duas listas se revezam nos resultados. 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 50 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