AIエージェント（MCP）を接続する

md-log MCPは、AIコーディングエージェントが作業・分析の結果をMarkdown（.md）レポートとしてmd-logに直接保存できるようにする橋渡しです。インストール不要で、リモートURL（https://mcp.md-log.com/mcp）にMCPキーをBearerヘッダーとして付ければ、Claude Code、Claude Desktop、OpenAI Codex、CursorをはじめとするあらゆるMCPクライアントから接続できます（推奨・Node.js／npx不要）。ローカルファイルパスからの画像アップロードが必要なときにだけ選ぶローカルnpx方式も併せて案内します。以下の手順どおりに進めてください。

始める前に用意するもの

接続にはちょうど2つの値が必要です。

値	内容
MDLOG_API_BASE_URL	https://app.md-log.com/api/v1 — 末尾の/api/v1を必ず含める必要があります。
MDLOG_PAT	MCPキー。mdlog_pat_で始まります。設定 → トークンで自分で発行し、作成時に一度だけ表示されます。

キーはWebアプリにログインして設定 → トークンで発行してください。個人ユーザーは無料で、営業問い合わせやクレジットカードは不要です。アカウント作成からの全体の流れはクイックスタートのドキュメントをご覧ください。

MCPキーはパスワードのように扱ってください。作成直後に一度だけ表示されるため、安全な場所にコピーしておき、漏洩したらすぐに再発行するのが安全です。

（任意）ローカルnpx方式の準備：Node.js 22以上

推奨のリモートURL接続にはNode.jsは不要です。 下記のローカルnpx方式（主にローカルファイルパスからの画像アップロードが必要なとき）を使う場合にのみ、Node.js 22以上が必要です。npxは初回実行時にツールを自動でダウンロードするため、別途インストールやビルドをする必要はありません。ローカル方式を使うなら、バージョンを確認してください。

node -v

バージョンが22未満、またはnode／npxが見つからない場合は、nodejs.orgからLTS版をインストールし、ターミナル（またはアプリ）を再起動してください。

クライアント別の設定

以下から使用するクライアントに合ったブロックを選び、mdlog_pat_YOUR_KEYの箇所に実際のキーを入れてください。

リモート接続（URL）— 推奨・インストール不要

インストールなしでURLで接続したい場合は、リモートエンドポイントを指定し、キーをBearerヘッダーで渡してください。Node.jsもnpxも不要です。

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）：

{
  "mcpServers": {
    "md-log": {
      "type": "http",
      "url": "https://mcp.md-log.com/mcp",
      "headers": { "Authorization": "Bearer mdlog_pat_YOUR_KEY" }
    }
  }
}

リモートエンドポイントでは画像をインライン（base64）で入れてください — ローカルファイルパスから画像を読み込む機能は、下記のローカルnpx方式でのみ動作します。

Claude Code（ターミナル）

コマンド1行で登録します。

claude mcp add md-log --scope user \
  --env MDLOG_API_BASE_URL=https://app.md-log.com/api/v1 \
  --env MDLOG_PAT=mdlog_pat_YOUR_KEY \
  -- npx -y md-log-mcp

登録後、claude mcp listまたはチャット内で/mcpで接続状態を確認します。

Claude Desktop

claude_desktop_config.jsonを開いて、mcpServersに以下の項目を追加します。

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": ["-y", "md-log-mcp"],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "mdlog_pat_YOUR_KEY"
      }
    }
  }
}

設定ファイルのパスは次のとおりです。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

保存したら、Claude Desktopを完全に終了してから再起動すると設定が反映されます。

OpenAI Codex

~/.codex/config.toml（JSONではなくTOML）に次のブロックを追加します。

[mcp_servers.md-log]
command = "npx"
args = ["-y", "md-log-mcp"]
env = { MDLOG_API_BASE_URL = "https://app.md-log.com/api/v1", MDLOG_PAT = "mdlog_pat_YOUR_KEY" }

新しいバージョンではcodex mcp addコマンドもサポートしています。

Cursor

Settings → MCP → Add new serverで追加するか、~/.cursor/mcp.jsonに以下のJSONを入れます（Claude Desktopと同じ形式）。

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": ["-y", "md-log-mcp"],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "mdlog_pat_YOUR_KEY"
      }
    }
  }
}

サーバーの横に緑のドットが点灯すれば接続完了です。

その他のMCPクライアント

原理はどれも同じです。リモートURLに対応するクライアントなら、typeをhttp、urlをhttps://mcp.md-log.com/mcpに指定し、MCPキーをAuthorization: Bearer mdlog_pat_...ヘッダーで渡してください（推奨）。URL接続に対応しないクライアントなら、実行コマンドをnpx、引数を-y md-log-mcpに指定し、2つの環境変数（MDLOG_API_BASE_URL、MDLOG_PAT）を渡せば大丈夫です。

接続を確認する

1. 設定を保存したら、クライアントを完全に再起動します（設定ファイルの編集後は必須です）。
2. ツール一覧にmd-logのツールが表示されるか確認します。Claude Codeではclaude mcp listまたは/mcpで状態を確認できます。
3. 自然言語で試してみます。例：「いま分析した内容をテスト/hello.mdとしてmd-logに保存して。」レポートが保存され、バージョンが1つ作られれば正常です。

エージェントルールファイルで自動保存する

毎回「これを保存して」と言う代わりに、プロジェクトのエージェントルールファイルにルールを1行入れておけば、エージェントが作業を終えるたびにレポートを自動で保存します。

• Claude Code: CLAUDE.md
• OpenAI Codex: AGENTS.md
• Cursor: プロジェクトルール

ルールの例：

意味のある作業や分析を終えたら、何を（WHAT）・なぜ（WHY）・どんな影響（IMPACT）かを
まとめたレポートを作成し、md-logのsave_markdownツールで
<プロジェクト名>/<YYYY-MM-DD>-<トピック>.md のパスに保存する。commit_messageを添える。

こうすると、作業が終わるたびに.mdレポートが自動で作成され、フォルダはmkdir -pのように自動で作られ、画像も一緒にアップロードされ、保存するたびに不変（immutable）バージョンが1つずつ積み重なります。蓄積された記録は、新しいチームメンバーや新しいエージェントのオンボーディング資料にもなります。

エージェントができること（15個のMCPツール）

md-log MCPは合計15個のツールを提供します。大きく分けると次のとおりです。

• ドキュメント操作（パス基準）： Markdownドキュメントの保存・修正・追記（append）・読み取り・削除・移動・名前変更
• バージョン履歴： 過去バージョンの一覧取得と、特定の過去バージョンの読み取り
• フォルダ管理： フォルダの作成・移動・名前変更・削除（保存時にフォルダは自動生成）
• 一覧・検索： ファイル一覧、フォルダ一覧、全文検索
• 画像／アセットのアップロード： スクリーンショットなどの画像添付

パスのルール：ファイル名は.mdで終わる必要があり、..・バックスラッシュ・空のパス区間・制御文字は使えません（NFC正規化）。保存・修正・追記には常にcommit_messageが入り、この値がバージョン履歴にそのまま表示されます。

保存されたレポートを人がレビューし、手書きで注釈を付ける方法はレポートのレビュー & 注釈のドキュメントをご覧ください。

トラブルシューティング

症状	対処
ツールが一覧に出ない／「未接続」	設定を編集したらクライアントを完全に再起動してください。（ローカルnpx方式ならnode -vが22以上かも確認します。）
npx／nodeが見つからない	nodejs.orgからNode.js LTSをインストールし、ターミナル・アプリを再起動してください。
すべてのリクエストが認証エラー（401）	キーが間違っているか、期限切れ・無効化されています。mdlog_pat_接頭辞まで空白なく正確に貼り直すか、設定 → トークンで再発行してください。
接続はできるがタイムアウトする	MDLOG_API_BASE_URLが正確にhttps://app.md-log.com/api/v1（末尾に/api/v1を含む）になっているか確認してください。
「トークン／セッション管理」が拒否される	正常な動作です。MCPキーはドキュメント専用のため、ログイン・セッション・トークン管理はできません。
パス検証エラー	ファイル名は.mdで終わり、..・バックスラッシュ・空のパス区間がないようにしてください。
オフラインで保存できない	ドキュメントはサービスサーバーに保存されるため、MDLOG_API_BASE_URLへのネットワーク接続が必要です。

キーのセキュリティ

MCPキー（mdlog_pat_...）はパスワードのように扱ってください。コードリポジトリや公開チャンネルに載せず、安全な場所に保管してください。

md-logのMCPキーは**ドキュメント専用（document-scoped）**に設計されています。キーだけではパスワードを変更したり、他のキーを発行したり、ログインセッションを管理したりはできません。したがって、キーが漏洩してもアカウント全体が奪われることはありません。それでも漏洩が疑われる場合は、設定 → トークンで該当キーを無効化（revoke）し、新しいキーを発行してください。

ログイン自体をより強固に保護するには、任意のTOTP二段階認証（2FA）を有効にしてください。2FAはWeb・モバイルのログインにのみ適用され、MCPキーには適用されません。

接続が終わったら、クイックスタートで最初のレポートを保存し、レポートのレビュー & 注釈でレビューの流れを確認してください。チーム単位のオンプレミス導入が必要な場合はお問い合わせからご連絡ください。