# MCP サーバー

書き出したものを、Claude やほかのエージェントが検索できるようにします。

Exporter はアプリの中で MCP サーバーを動かします。サーバーは書き出しフォルダを Claude、Cursor、VS Code など、あらゆる MCP クライアントに、読み取り専用で、あなたの Mac の中だけで提供します。エージェントが使えるスキルとコマンドラインについては、[エージェント向け](https://exporter.dev/agents) をご覧ください。

## 起動する

1. 少なくとも 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 に含まれています）。これを設定 > 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` のように、フォルダの名前で呼ばれます。

## 6 つのツール

| ツール | 内容 | パラメータ |
| --- | --- | --- |
| `get_stats` | ソースごとのファイル数、最新と最古の日付、サイズ。ソース名を知るために最初に呼び出します | `source`（任意） |
| `search` | 順位付きの全文検索 | `query`、`source`（任意）、`limit`（20） |
| `read` | 1 つの項目：その Markdown、フロントマター、変更日、サイズ | `source`、`id`（`.md` を除いたファイル名） |
| `list` | 1 つのソースの項目 | `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/ja/docs/mcp
every page: https://exporter.dev/llms.txt