md-log で発行した MCP キー1つで、お使いの AI クライアント（Claude Code · Claude Desktop · Codex · Cursor）から直接ドキュメントを保存・検索できます。URL 1つで連携でき、インストールは不要です。
連携には以下の2つが必要です。どちらも md-log Web アプリで確認・発行でき、連携に必要なすべてです。
mdlog_pat_ で始まる長い文字列 — 例: mdlog_pat_3f9a… （パスワードのように扱ってください）https://mcp.md-log.com/mcp （リモート URL 連携 — 推奨）https://app.md-log.com/api/v1 （ローカル npx 方式の MDLOG_API_BASE_URL）https://app.md-log.com/api/v1）で固定です。キーは発行時に一度だけ表示されるので、安全な場所に保管してください。連携方法は2つあります — 下のタブから1つだけ選んでください。どちらの場合も、MDLOG_PAT（MCP キー）を発行したご自身の値に置き換えるだけです。
インストール不要、URL 1つで連携します。 Node.js も npx も不要です。クライアントに URL + キー（Bearer ヘッダー）を入れるだけです。
claude mcp add --transport http md-log https://mcp.md-log.com/mcp \ --header "Authorization: Bearer mdlog_pat_your_key_here"
~/.cursor/mcp.json · claude_desktop_config.json · プロジェクトの .mcp.json などに追加します。
{
"mcpServers": {
"md-log": {
"type": "http",
"url": "https://mcp.md-log.com/mcp",
"headers": { "Authorization": "Bearer mdlog_pat_your_key_here" }
}
}
}type は必ず http にしてください（省略すると stdio と解釈されます）。リモートエンドポイントでは画像をインライン（base64）で埋め込んでください — ローカルファイルのパスによる画像アップロードはローカル（npx）方式でのみ動作します。
npx がコネクタを自動で取得・実行するため、手作業でのインストールはありません。ローカルファイルの画像アップロードが必要な場合はこの方式を使ってください。バージョン確認: node -v（v22.x 以上なら OK。低い場合は nodejs.org から LTS をインストール）。ターミナルで1行で登録します（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_here \ -- npx -y md-log-mcp
登録後は claude mcp list で確認し、チャット中は /mcp で状態を確認します。
設定ファイルを開いて mcpServers 項目を追加し、アプリを完全に終了してから再起動します。
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"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_here"
}
}
}
}連携されると、入力欄のツール（🔌）メニューにツール一覧が表示されます。
~/.codex/config.toml ファイルに以下のブロックを追加します（形式は JSON ではなく TOML です）。
# ~/.codex/config.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_here" }
最新バージョンでは codex mcp add md-log --env … -- npx -y md-log-mcp コマンドもサポートしています。
Settings → MCP → Add new server、または ~/.cursor/mcp.json に追加します。
{
"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_here"
}
}
}
}Settings → MCP で緑色のドットが表示されれば連携成功です。
ほとんどは同じように 実行コマンド + 環境変数2つを入れるだけです。
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_heremd-log が連携済み（connected）と表示されるか確認します。 （Claude Code は /mcp）連携されたら、AI にいつものように言葉で頼むだけです。例えば:
できること: パスによる Markdown の保存／編集／追記、読み取り、削除、移動・リネーム（履歴・注釈を保持）、バージョン履歴の閲覧・過去バージョンの読み取り、フォルダの作成・移動・リネーム・削除・一覧、全文検索、画像添付。フォルダは保存時に自動的に作成されます。
毎回「保存して」と言う必要はありません。エージェントのルールファイル（Claude Code は claude.md/CLAUDE.md、Codex は AGENTS.md、Cursor はプロジェクトルール）に
ルールを一度書いておくだけで、エージェントは作業や分析を終えるたびに自動で .md レポートを作成し md-log に保存します。
存在しないフォルダはパスに沿って自動的に作成され、画像も併せてアップロードされ、すべての保存が不変のバージョンとして蓄積されます。
例 — ルールファイルにこのようなルールを追加します:
## 作業ログのルール (md-log)
- 意味のある作業や分析を終えたら、「何を・なぜ・どんな影響」を要約したレポートを作成する。
- そのレポートを md-log MCP の save_markdown で次のパスに保存する:
<project>/<YYYY-MM-DD>-<topic>.md
- 大きな変更には、変更理由・影響範囲・後続項目（TODO）を含める（レビュー・オンボーディング用）。
- ユーザーがフィードバックをくれたら、反映したうえで同じ文書に続けて記録する。すると、作業の流れが次のように自動化されます:
mdlog_pat_…）はパスワードと同じです。 画面共有・スクリーンショット・チャット・公開リポジトリに露出させないでください。https:// であることを確認してください。| 症状 | 確認 / 対処 |
|---|---|
md-log が一覧にない / 未接続 | 設定を保存した後、クライアントを完全に再起動したか確認してください。 （ローカル npx 方式の場合は node -v が 22 以上かも確認。） |
npx / node が見つからない | Node.js が未インストールです — nodejs.org から LTS をインストールし、ターミナル／アプリを再起動してください。 |
| すべての操作が認証エラー（401）で失敗する | キーが間違っているか、期限切れ・失効しています。キーをもう一度正確に貼り付ける（mdlog_pat_ を含め、空白なしで）か、設定 → トークン で再発行してください。 |
| 連携はできるが応答がない / タイムアウト | MDLOG_API_BASE_URL がサービス URL（https://app.md-log.com/api/v1、末尾の /api/v1 を含む）と正確に一致しているか確認してください。 |
| 保存はできるが「トークン／セッション管理」は拒否される | 正常です — このキーはドキュメント操作専用で、アカウント管理の権限はありません。 |
| ファイルパスのエラー（VALIDATION） | ファイル名は .md で終わる必要があり、..・バックスラッシュ・空のフォルダ名は使用できません。 |
上記でも解決しない場合は、お使いのクライアント名と画面のエラーメッセージをキャプチャして md-log カスタマーサポート（support@md-log.com）にお問い合わせください。 （キャプチャにキーが写らないよう隠してください。）
リモート（URL）方式は何もインストールせず、URL とキーだけで連携できます（推奨）。ローカル（npx）方式は Node.js さえあればよく、連携ツールは初回利用時に npx が自動で取得・実行するため、別途のインストールやビルドは不要です。
はい。同じキーと URL を各端末のクライアント設定に入れてください。ただしキーは秘密に管理してください。
Web アプリの 設定 → トークン で既存のキーを失効させ、新しいキーを自分で発行できます。新しいキーを取得したら、URL 方式ではヘッダーの Bearer トークンを、ローカル npx 方式では MDLOG_PAT の値を差し替えて、クライアントを再起動してください。
いいえ。ドキュメントはサービスのサーバーに保存されるため、MDLOG_API_BASE_URL のサーバーにアクセスできるネットワークが必要です。