Mintlify を Claude Code につなぐ
Claude Code から Mintlify を検索・読み書きできます。Arlet が両者を 1 つの MCP 接続でつなぎ、鍵の管理と認証を引き受けます。
Mintlify 公式の管理用 MCP サーバーを、Arlet を通していつもの AI サービスから使えるようにします。Mintlify アカウントでログインするだけで接続が完了します。
ドキュメントページの読み書き、ナビゲーションの変更、docs.json の更新まで AI から行えます。編集はセッション用のブランチに積まれ、保存すると Pull Request として出るので、レビューしてからマージできます。デプロイ設定を変える操作だけは即時反映なので、AI クライアント側で実行前に確認する設定を推奨します。使えるツールは Mintlify 公式サーバーが提供するものと同じです。
Mintlify を Claude Code につなぐ手順
- 1
Arlet のダッシュボードの「サービス連携ツール」で「サービス連携ツールを追加」を開き、Mintlify を選びます。「Mintlify と連携」でログインし、接続の名前を付けて「作成」します。
- 2
ターミナルで claude mcp add --transport http arlet https://mcp.arlet.dev/mcp/ を実行し、Arlet を MCP サーバーとして追加します。
- 3
Claude Code を起動して /mcp を実行し、arlet を選んで Authenticate をクリックします。
- 4
ブラウザが開くので Google でサインインし、同意画面で Allow を押すと接続完了です。
接続はユーザーごとに行います。同じマシンの別プロジェクトでもそのまま使えます。
できること
Claude Code が呼び出せる Mintlify のツールです。
list_deployments接続で扱えるドキュメントのデプロイ (サイト) を一覧します。
checkout編集セッションを開きます。変更用のブランチが作られ、エディタの URL が返ります。
readページの MDX 本文を読みます。
searchセッション内のファイルを文字列や正規表現で検索します。
list_nodesナビゲーション (ページ・グループ・タブ) の構成を取得します。
edit_pageページ本文を部分的に置き換えて編集します。
write_pageページ本文を丸ごと書き換えます。
create_nodeページやグループ、タブをナビゲーションに追加します。
update_nodeページのタイトルや frontmatter、ナビゲーションの設定を変更します。
move_nodeナビゲーション内でページやグループを移動します。
delete_nodeページやグループをナビゲーションから外します。
update_configdocs.json (サイト設定) を変更します。
diffデプロイ中のブランチとの差分を確認します。
saveセッションの変更を Pull Request (または既存ブランチへのコミット) として出します。
discard_sessionセッションの変更を破棄します。
list_branchesドキュメントリポジトリのブランチを一覧します。
execute_codeデプロイの設定 (ワークフロー、メンバー、連携、分析など) をコードで操作します。即時反映です。
ツール一覧は Mintlify 公式 MCP サーバーの提供内容に従い、変わることがあります。
使い方の例
ドキュメントを直す
古い記述や誤字を探して修正し、Pull Request として出します。レビューしてからマージできます。
新しいページを起こす
仕様書や変更内容からページを書き、適切なグループに置いてナビゲーションに追加します。
構成を整える
ページの並びやグループ分けを見直し、タイトルや説明を揃えます。
サイト設定の変更
docs.json のテーマやナビゲーション設定を変更し、Pull Request で確認します。
そのまま使えるプロンプト
- docs の中で「v1 API」に言及しているページを探して、「v2 API」に直した Pull Request を作って
- この変更内容から「Slack 連携」のページを書いて、「連携」グループに追加して
- 「はじめに」グループのページを読みやすい順に並べ替えて、タイトルの表記を揃えて
- docs.json のナビゲーションに「API リファレンス」タブを追加して
