DotMDはMCPサーバーです。エージェントが、あなたの読んでいるものを見られます。
DotMDはMac上でローカルのMCPサーバーを動かします。Claude Code、Codex、Cursorなど、どのMCPクライアントも、Markdownファイルを開き、選択範囲とコメントを読み、行を指し示し、レビュー用のスペックを送れます。
macOS 14以降。閲覧は無料、DotMD Proは3日間無料でお試しいただけます。
要点
Settings → MCP → MCP server で、http://127.0.0.1:8089/mcp でサーバーが起動します。このアドレスをエージェントに一度追加すれば、エージェントはDotMDでファイルを開き、選択範囲とコメントを読み、行をハイライトし、レビュー用のドキュメントを送れます。レビューとエージェント用ツールはDotMD Proの機能です(3日間の無料トライアル付き)。閲覧は引き続き無料です。
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 --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 --transport http dotmd http://host.docker.internal:8089/mcp
ほかのクライアントも、設定に同じアドレスを入れます。このMac上のどのコンテナからも、Docker DesktopがMacへの通信を許しているほかのサーバーと同じように、サーバーにつなげます。ネットワーク上のほかのコンピュータからは、引き続きつなげません。
DotMDのMCPサーバーに関するよくある質問
ほかのコンピュータからDotMDのMCPサーバーにつなげますか?
いいえ。127.0.0.1でのみ待ち受けます。このMac上のDockerコンテナからは、host.docker.internal でつなげます。
Webページから使えますか?
いいえ。ブラウザからのリクエストは拒否され、受け付けるのはこのMacからのJSONリクエストだけです。
サーバーは私のファイルを書き込みますか?
いいえ。ファイルは書き込みません。最前面のDotMDウインドウに対して働きます。
ポート8089が使われています。
Settings → MCPでポートを変更し、サーバーをオフにしてオンに戻し、エージェントのアドレスも更新してください。