El servidor MCP

Exporter ejecuta un servidor MCP dentro de la app. Sirve sus carpetas de exportación a Claude, Cursor, VS Code y cualquier otro cliente MCP, en solo lectura y solo en su Mac. Para las skills y la línea de comandos que también puede usar un agente, consulte Para agentes.

Iniciarlo

1. Exporte al menos una app como Markdown (primeros pasos). El servidor solo lee archivos Markdown.
2. En la tarjeta Servidor MCP, pulse «iniciar». La tarjeta muestra entonces localhost:8744 y una fila «conectar».

El endpoint es http://localhost:8744/mcp (Streamable HTTP), en un puerto fijo. El servidor vive en la app: responde mientras Exporter está en marcha, con la ventana abierta o cerrada, y se detiene cuando sale de la app. Si estaba en marcha cuando salió, vuelve a iniciarse con la app. curl -s http://127.0.0.1:8744/health responde OK mientras está activo.

Conectar Claude Code

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

Añada --scope user para tenerlo en todos los proyectos. El botón «claude code» de la tarjeta copia este comando.

Claude Desktop, Cursor y VS Code

• Claude Desktop: pulse «claude desktop» en la tarjeta. Copia una entrada que ejecuta npx -y mcp-remote http://localhost:8744/mcp (npx viene con Node.js). Péguela dentro de mcpServers en Settings > Developer > Edit Config, guarde, y después salga de Claude y vuelva a abrirlo
• Cursor o VS Code: pulse «cursor» o «vs code» en la tarjeta. El editor se abre con el servidor listo para instalar; confírmelo allí

Qué carpetas sirve

Las carpetas de exportación que están en la misma carpeta superior que la carpeta de exportación de Apple Notes (si no la hay, la primera carpeta de exportación que encuentra). Una carpeta de exportación en cualquier otro lugar es invisible para los agentes, y la tarjeta Servidor MCP indica cuáles pueden ver.

carpetas de exportación	se sirven
~/Documents/notes, ~/Documents/messages	las dos
~/Documents/notes, ~/Dropbox/messages	solo notes

Para incluir una carpeta, pulse «cambiar…» en la fila «exportar a» de esa app, elija una carpeta dentro de la misma carpeta superior y después pulse «resincronización completa» en esa tarjeta. El servidor lee su lista de carpetas al iniciarse, así que pulse «detener» e «iniciar» después de cualquier cambio. Cada fuente lleva el nombre de su carpeta, como notes o messages.

Las seis herramientas

herramienta	qué hace	parámetros
get_stats	por fuente: número de archivos, fechas más reciente y más antigua, tamaño. Llámela primero para conocer los nombres de las fuentes	source (opcional)
search	búsqueda de texto completo ordenada por relevancia	query, source (opcional), limit (20)
read	un elemento: su Markdown, front matter, fecha de modificación y tamaño	source, id (el nombre del archivo sin .md)
list	los elementos de una fuente	source, limit (50), offset (0)
get_recent	los elementos modificados más recientemente	sources (separadas por comas, opcional), limit (20)
get_metadata	recuentos y horas de la última sincronización	source (opcional)

search ordena Apple Notes, Contactos y Mensajes con el índice de la app: un nombre encuentra la conversación, y un resultado de una nota lleva un enlace que la abre en Apple Notes. Bear, Logseq, Tiempo de uso y Documentos también se sirven, pero search no los ordena mientras responde el índice; llegue a ellos con list, get_recent y read. Mientras el índice sigue vacío, search recorre el Markdown de todas las fuentes.

Las respuestas solo son tan completas como la exportación: con el cupo gratuito, eso son sus primeras 100 notas, 100 contactos y 10 conversaciones más recientes, 10 días y 10 documentos.

Privacidad

El servidor escucha en 127.0.0.1, así que nada fuera de su Mac puede llegar a él, y solo lee. Lo que devuelve una herramienta pasa a formar parte de su conversación con la IA y llega a su modelo, como cualquier cosa que pegue.

Cuando no funciona

• No hay carpetas de exportación configuradas. Defina una primero.: elija una carpeta de exportación en cualquier tarjeta
• No se encontraron notas exportadas. Ejecute antes una exportación.: pulse «sincronizar ahora» en una tarjeta y después «iniciar»
• un error del sistema al pulsar «iniciar»: otro programa usa el puerto 8744. Ciérrelo y vuelva a iniciar
• falta una fuente: está fuera de la carpeta superior, se exportó solo como HTML, apareció después de que se iniciara el servidor o supera el cupo gratuito