# MCP 서버

Claude와 다른 에이전트가 내가 내보낸 것을 검색하게 합니다.

Exporter는 앱 안에서 MCP 서버를 실행합니다. 이 서버는 Claude, Cursor, VS Code를 비롯한 모든 MCP 클라이언트에 내보내기 폴더를 읽기 전용으로, 내 Mac 안에서만 제공합니다. 에이전트가 함께 쓸 수 있는 스킬과 명령줄은 [에이전트용](https://exporter.dev/agents)을 참고하세요.

## 시작하기

1. 적어도 앱 하나를 Markdown으로 내보냅니다([시작하기](https://exporter.dev/docs/getting-started)). 서버는 Markdown 파일만 읽습니다.
2. MCP 서버 카드에서 “시작”을 누릅니다. 그러면 카드에 `localhost:8744`와 “연결” 행이 표시됩니다.

엔드포인트는 고정 포트의 `http://localhost:8744/mcp`(Streamable HTTP)입니다. 서버는 앱 안에 있습니다. Exporter가 실행 중이면 창이 열려 있든 닫혀 있든 응답하고, 앱을 종료하면 멈춥니다. 앱을 종료할 때 서버가 실행 중이었다면 앱과 함께 다시 시작됩니다. 서버가 켜져 있는 동안 `curl -s http://127.0.0.1:8744/health`는 `OK`로 응답합니다.

## Claude Code 연결

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

모든 프로젝트에서 쓰려면 `--scope user`를 추가합니다. 카드의 “claude code” 버튼이 이 명령을 복사합니다.

## Claude Desktop, Cursor, VS Code

- Claude Desktop: 카드에서 “claude desktop”을 누릅니다. `npx -y mcp-remote http://localhost:8744/mcp`를 실행하는 항목이 복사됩니다(`npx`는 Node.js에 포함되어 있습니다). Settings > Developer > Edit Config에서 `mcpServers` 안에 붙여넣고 저장한 다음, Claude를 종료했다가 다시 엽니다
- Cursor 또는 VS Code: 카드에서 “cursor” 또는 “vs code”를 누릅니다. 서버를 설치할 준비가 된 상태로 편집기가 열리므로, 그곳에서 확인합니다

## 제공하는 폴더

Apple 메모 내보내기 폴더와 같은 상위 폴더에 있는 내보내기 폴더들입니다(Apple 메모 폴더가 없으면 처음 찾은 내보내기 폴더 기준). 다른 곳에 있는 내보내기 폴더는 에이전트에게 보이지 않으며, MCP 서버 카드에 에이전트가 볼 수 있는 폴더가 표시됩니다.

| 내보내기 폴더 | 제공 |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | 둘 다 |
| `~/Documents/notes`, `~/Dropbox/messages` | notes만 |

폴더를 포함시키려면 해당 앱의 “내보내기 위치” 행에서 “변경…”을 누르고 같은 상위 폴더 안의 폴더를 고른 다음, 그 카드에서 “전체 재동기화”를 누릅니다. 서버는 시작할 때 폴더 목록을 읽으므로, 무엇이든 바꾼 뒤에는 “중지”와 “시작”을 누르세요. 각 소스는 `notes`나 `messages`처럼 폴더 이름을 따릅니다.

## 도구 여섯 개

| 도구 | 하는 일 | 매개변수 |
| --- | --- | --- |
| `get_stats` | 소스별 파일 수, 가장 최근 날짜와 가장 오래된 날짜, 크기. 소스 이름을 알려면 먼저 호출합니다 | `source`(선택) |
| `search` | 순위를 매기는 전문 검색 | `query`, `source`(선택), `limit`(20) |
| `read` | 항목 하나: Markdown, 프런트매터, 수정 날짜, 크기 | `source`, `id`(`.md`를 뺀 파일 이름) |
| `list` | 소스 하나의 항목 | `source`, `limit`(50), `offset`(0) |
| `get_recent` | 가장 최근에 바뀐 항목 | `sources`(쉼표로 구분, 선택), `limit`(20) |
| `get_metadata` | 개수와 마지막 동기화 시각 | `source`(선택) |

`search`는 앱의 인덱스에서 Apple 메모, 연락처, 메시지를 순위대로 찾습니다. 이름으로 대화를 찾을 수 있고, 메모 결과에는 Apple 메모에서 여는 링크가 붙습니다. Bear, Logseq, 스크린 타임, 문서도 제공되지만, 인덱스가 응답하는 동안에는 `search`가 이들의 순위를 매기지 않으므로 `list`, `get_recent`, `read`로 접근합니다. 인덱스가 아직 비어 있는 동안에는 `search`가 모든 소스의 Markdown을 훑습니다.

답은 내보내기만큼만 완전합니다. 무료 한도에서는 처음 100개 메모, 100개 연락처, 최근 대화 10개, 10일, 문서 10개입니다.

## 개인정보 보호

서버는 127.0.0.1에서 수신하므로 Mac 밖에서는 접근할 수 없으며, 읽기만 합니다. 도구가 돌려준 내용은 붙여넣은 내용과 마찬가지로 AI와의 대화에 포함되어 모델에 전달됩니다.

## 작동하지 않을 때

- `No export folders configured. Set an export folder first.`: 아무 카드에서나 내보내기 폴더를 고르세요
- `No exported notes found. Run an export first.`: 카드에서 “지금 동기화”를 누른 다음 “시작”을 누르세요
- “시작”을 누르면 시스템 오류가 남: 다른 프로그램이 포트 8744를 쓰고 있습니다. 그 프로그램을 종료하고 다시 시작하세요
- 소스가 없음: 상위 폴더 밖에 있거나, HTML로만 내보냈거나, 서버가 시작된 뒤에 생겼거나, 무료 한도를 넘었습니다

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