DotMDはMCPサーバーです。エージェントが、あなたの読んでいるものを見られます。
DotMDはMac上でローカルのMCPサーバーを動かします。Claude Code、Codex、Cursorなど、どのMCPクライアントも、Markdownファイルを開き、選択範囲とコメントを読み、行を指し示し、レビュー用のスペックを送れます。
macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。
要点
DotMDはMac上でローカルのMCPサーバーを動かすので、Claude Code、Codex、Cursorなど任意のMCPクライアントが、Markdownファイルを開き、選択範囲とコメントを読み、レビュー用のドキュメントを送ってきます。DotMDでMarkdownを扱うためのもので、ほかの形式への変換用ではありません。エージェント用ツールはDotMD Reviewerに含まれ、閲覧は無料です。
Markdown向けMCPサーバーを有効にする
これは、DotMDでMarkdownファイルを扱うためのMCPサーバーです。ファイルを開く、あなたのコメントを読む、エージェントが書いたものをレビューする、といったことをします。ほかの形式をMarkdownに変換するツールではありません。操作はすべて Settings → MCP で行います。
- MCP server でサーバーを起動します。上部のステータスが緑になり、Listening と表示されます。
- Start with DotMD をオンにすると、DotMDの起動時に毎回サーバーも起動します。
- Port の初期値は8089です。変更したら、サーバーをオフにしてからオンに戻してください。
- アドレス
http://127.0.0.1:8089/mcpは上部に表示され、コピー用のボタンがあります。
サーバーが動くのは、DotMDを開いている間だけです。DotMDを閉じると、エージェントはつなげません。
エージェントをMCPサーバーに接続する
サーバーのアドレスを、お使いのエージェントのやり方で一度だけ追加します。
Claude Code
ターミナルで次を実行します。詳しくはClaude Codeのガイドをご覧ください。
claude mcp add -s user --transport http dotmd http://127.0.0.1:8089/mcp
Codex
Codexアプリで Settings → MCP servers → Add server を開いて Streamable HTTP を選ぶか、次の内容を ~/.codex/config.toml に追加します。tool_timeout_sec の行で、レビュー中もCodexが待てます。詳しくはCodexのガイドへ。
[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600
Cursor、Visual Studio Codeなど
次の設定でサーバーを追加します。手順はCursorのガイドにあります。
{
"mcpServers": {
"dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
}
}
エージェントがDotMDでできること
サーバーはエージェントに12個のツールを提供します。
| ツール | できること |
|---|---|
open_file | ファイルやフォルダをDotMDで開きます。行を指定するとその行がハイライトされます |
request_review | エージェントが書いたドキュメントをレビューに送り、あなたが Send か Approve をクリックするまで待ちます |
get_current_file | 開いているファイル、そのタイトル、モード、読んでいるセクション |
get_selection | あなたが選択したテキストと、その行番号 |
highlight | 指定の行までスクロールし、数秒間ハイライトします |
show_changes | エージェントの編集を、コメントの隣かバージョン履歴に表示します |
list_files | ワークスペース内のMarkdownファイルを、タイトル付きで一覧します |
search | ワークスペース内のすべてのファイルのテキストを検索します |
get_review_comments | ファイルのコメント。あなたのものも、レビューするエージェントのものも対象です |
add_review_comments | ファイルの行に、レビュアーとして、エージェント名でコメントを残します |
complete_review | レビューするエージェントが終わったことを、判定と1文の要約付きで知らせます |
resolve_review_comments | コメントを、メモと変更した行を添えて、確認のためあなたに戻します |
スペックでの流れ:エージェントが書いて request_review を呼び、あなたがコメントして Send をクリックし、エージェントがコメントごとに修正して resolve_review_comments で返します。実際の画面はClaude Codeのガイドで見られます。
すべての呼び出しが見える
Settings → MCP の Recent Requests には、各アシスタントが何をしたかが平易な言葉で表示されます。たとえば、緑のチェック付きの「Codex · Opened plans/auth.md at line 42」、「Searched for “rate limit” (5 matches)」、赤いバツ付きの「Couldn't open ~/notes/a.md — no access」などです。行にカーソルを合わせると、フルパスや理由が表示されます。Technical details を選ぶと、代わりに生のHTTPリクエストが並びます。この一覧は、DotMDを開いている間だけ保持されます。
セキュリティ:サーバーにつなげるのは誰か
- サーバーは127.0.0.1でのみ待ち受けるので、ほかのコンピュータからはつなげません。
- Webページからは使えません。ブラウザから来たリクエストはすべて拒否され、このMacを指していないアドレスのリクエストも拒否されます。これでDNSリバインディングも防げます。
- 受け付けるのはJSONリクエストだけで、Webフォームからは送れません。
- ファイルを書き込むことはありません。ツールは最前面のDotMDウインドウに対して働きます。
- 開けるのは、DotMDがアクセスできるファイルだけです。ワークスペース、ダウンロード、許可した場合はホームフォルダが対象です。それ以外は、フォルダをワークスペースに追加するようあなたに頼むよう、エージェントに伝えられます。
拒否されたリクエストは、Recent Requests に赤で、理由とともに表示されます。
Docker上のエージェント
Dockerコンテナの中では、127.0.0.1 はMacではなくコンテナ自身です。Docker Desktopでは、コンテナからMacへは host.docker.internal でつなげるので、このアドレスを使います。
claude mcp add -s user --transport http dotmd http://host.docker.internal:8089/mcp
ほかのクライアントも、設定に同じアドレスを入れます。このMac上のどのコンテナからも、Docker DesktopがMacへの通信を許しているほかのサーバーと同じように、サーバーにつなげます。ネットワーク上のほかのコンピュータからは、引き続きつなげません。
DotMDのMCPサーバーに関するよくある質問
MacでMarkdownファイルをレビューするためのMCPサーバーはありますか?
はい、DotMDに内蔵されています。Settings → MCPでオンにすると、DotMDを開いている間、http://127.0.0.1:8089/mcpで応答します。エージェントはファイルを開き、選択範囲とコメントを読み、レビュー用のドキュメントを送れます。
DotMDのMCPサーバーに対応しているエージェントは?
Claude Code、Codex、Cursor、Visual Studio Codeなど、あらゆるMCPクライアントです。どれも、同じアドレスをMCP設定に一度追加するだけです。
ほかのコンピュータからDotMDのMCPサーバーにつなげますか?
いいえ。127.0.0.1で待ち受けるので、アクセスできるのはあなたのMacだけです。サーバーがファイルを書き込むことはありません。ファイルはこれまでどおりエージェントが編集し、すべての変更をDotMDで確認できます。
Webページから使えますか?
いいえ。ブラウザからのリクエストは拒否され、受け付けるのはこのMacからのJSONリクエストだけです。
ポート8089が使われています。
Settings → MCPでポートを変更し、サーバーをオフにしてオンに戻し、エージェントのアドレスも更新してください。