クイックスタート — 約5分でmd-logを始める

md-logは、AIコーディングエージェントが自らの作業をMarkdown（.md）レポートとして書き出し、人が快適にレビューする、人間参加型（human-in-the-loop）のレビュー・アーカイブ層です。このガイドでは、ゼロから最初のレビュー済みレポートまで、約5分で（登録 → 接続 → 保存 → レビュー）セットアップする方法を案内します。

まず必要なもの

始める前に、以下を準備します。

• 無料のmd-logアカウント — 個人利用は運営会社ホスティングのSaaSで無料です。クレジットカードも営業問い合わせも不要です。
• AIコーディングエージェント — Claude Code、Claude Desktop、OpenAI Codex、CursorなどMCP対応クライアント。
• （任意）Node.js 22以上 — 推奨のURL接続にはNode.jsは不要です。ローカルnpx方式で接続する場合（例：ローカルファイルパスからの画像アップロード）のみ必要で、ターミナルでnode -vを確認し、なければnodejs.orgからLTSをインストールします。

ステップ1 — 無料で登録する

app.md-log.comでアカウントを作成します。個人利用は無料で、クレジットカードは不要です。

ステップ2 — MCPキーを発行する

ログイン後、設定 → トークンでMCPキー（パーソナルアクセストークン）を発行します。キーはmdlog_pat_...の形式で、作成時に一度だけ表示されるため、すぐにコピーして安全な場所に保管してください。

このキーはドキュメント範囲に限定されています。キーだけではパスワードの変更や他のキーの発行、ログインセッションの管理はできないため、漏洩してもアカウント全体を明け渡すことはありません。漏洩が疑われる場合は、設定 → トークンで無効化して発行し直せます。

ステップ3 — エージェントを接続する

最も簡単なのはURL接続です — インストールもNode.jsも不要で、リモートエンドポイントのアドレスと、ステップ2でコピーしたmdlog_pat_...キー（Bearerヘッダー）だけで済みます。

Claude Code（ターミナル）：

claude mcp add --transport http md-log https://mcp.md-log.com/mcp \
  --header "Authorization: Bearer mdlog_pat_YOUR_KEY"

Cursor・Claude Desktop・JSONを使うクライアントは、typeをhttp、urlをhttps://mcp.md-log.com/mcp、キーをAuthorization: Bearerヘッダーに入れます（typeを省略するとstdioと誤認されます）。接続確認はclaude mcp listまたはチャットで/mcp。クライアント別の詳細設定（リモート・ローカル）はMCP接続ガイドをご覧ください。ローカルnpx方式もそのままサポートしています。

ステップ4 — エージェントにレポートを保存させる

接続すると、エージェントはmd-logの15個のツールでパス基準の.mdドキュメントを保存・修正・検索できます。フォルダは保存時に自動生成されます（mkdir -pのように）。

一度だけ保存するなら、自然言語で指示すればよいです。

この分析をreports/2026-07-14-first.mdに保存して。

毎回指示しないためには、プロジェクトのエージェントルールファイル（Claude CodeはCLAUDE.md、CodexはAGENTS.md、Cursorはプロジェクトルール）に自動保存ルールを追加してください。例：「意味のある作業や分析を終えたら、何を・なぜ・どんな影響かをまとめたレポートを<プロジェクト>/<YYYY-MM-DD>-<トピック>.mdのパスにsave_markdownで保存し、commit_messageを添える。」そうすれば、作業が終わるたびにエージェントがレポートを作り、画像も一緒にアップロードされ、保存するたびに不変バージョンが積み重なります。詳しいルールはMCP接続ガイドをご覧ください。

パスのルール：ファイル名は.mdで終わる必要があり、..・バックスラッシュ・空のパスセグメント・制御文字は使えません。

ステップ5 — レビューする

app.md-log.comを開いて、いま保存されたレポートを確認します。モバイルアプリやタブレットでも同じように開けます。diffに埋もれる代わりに、レポートを読んで人が自分で承認/却下する、human-in-the-loopの流れです。

ペンに対応したタブレットでは、スタイラスで手書きの注釈を残せます（AndroidはS-Pen、iOSはApple Pencil、ペンがなければ指描きで代替）。各注釈レイヤーは特定のドキュメントバージョンに固定され、Webは注釈を読み取り専用（SVGオーバーレイ）で表示します。

次のステップとして、レビュー & 注釈ガイドでバージョン履歴・お気に入り・全文検索を、MCP接続ガイドで他のクライアント設定を確認してください。チーム・企業向けのオンプレミス導入はお問い合わせからご連絡ください。