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

## Iniciar

1. Exporte pelo menos um app como Markdown ([primeiros passos](https://exporter.dev/docs/getting-started)). 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

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

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