Docsbook
概要

ドキュメント向けMCPサーバー：その概要と優れている理由

Model Context Protocol（MCP）は、Anthropicが2024年後半にリリースしたコネクター標準です。2026年半ばまでに、Claude Code、Cursor、ChatGPT、および増加を続けるエージェントの一覧でサポートされています。ドキュメントにおいて、MCPはドキュメントをウェブサイト専用の資産から、AIエージェントが読み取り、操作できるプログラム可能なインターフェースへと変えます。

この記事では、MCPとは何か、ドキュメント向けMCPサーバーが公開するツール、そしてDocsbookがどのようにそれを提供しているかを説明します。

要約#

  • MCP = AIエージェントが外部ツールを呼び出すための標準的な方法
  • ドキュメントMCPサーバーは、get_analytics、update_branding、set_chat_hooks などのツールを公開します
  • エージェントは機能を検出し、OAuthを要求してから、作業の一環としてツールを呼び出します
  • Docsbookは、docsbook.io/api/mcp/server でマネージドMCPサーバーを提供しています
  • これは現在、主要なAI配信チャネルです — Mintlifyの測定によると、2026年3月に同社がホストするドキュメントサイトへのリクエストの45.3%をAIコーディングエージェントが占め、Claude Codeは25.2%、Cursorは18.0%でした（出典）

MCPとは実際には何か#

MCPは、HTTP（またはstdio）上に構築されたJSON-RPCプロトコルです。エージェントはMCPサーバーに接続し、「どのようなツールがありますか？」と尋ね、型付きスキーマを受け取り、ツールを呼び出します。認証にはPKCEを使用するOAuth 2.0が使われます。

最も簡単な捉え方は、REST API + OAuth + 検出エンドポイント + リソースの代わりにツール、というものです。

MCPによってドキュメント作成が有益になる理由#

3つのワークフロー：

1. ドキュメントを構造化データとして読み取る#

MCP がなければ、エージェントは HTML ページを取得して解析し、構造が完全なままであることを願います。markdown-lsp をローカルで実行すると（npx markdown-lsp <subcommand> ./docs）、エージェントはディスク上のドキュメントグラフを解析し、ネットワーク往復なしでクリーンな Markdown または JSON を受け取ります。

これは、エージェントが次のことを意味します：

  • 読み始める前に目次全体を把握できる
  • ページ全体ではなく個々のセクションを読める
  • 正規表現のマッチではなく、グラフのエッジとして相互リンクを確認できる
  • バージョンに左右されないメタデータを取得できる

2. エージェントからドキュメント設定を編集#

Claude Codeのユーザーは、「ドキュメントのアクセントカラーをブランドパープルに設定して、フッターにDiscordリンクを追加して」と指示できます。エージェントはMCPサーバー上でupdate_brandingとupdate_navigationを呼び出します。ダッシュボードの切り替えも、コピー＆ペーストも、Markdownの編集も必要ありません。

3. エージェント内からドキュメント分析をクエリする#

「先週、検索に最も失敗したページはどれですか？」— エージェントは get_failed_searches を呼び出し、一覧を確認して、その場で不足しているコンテンツの下書きを提案します。

優れたドキュメント MCP サーバーが提供するツール#

Docsbook の MCP サーバーは、以下のカテゴリのツールを提供します。完全な一覧は接続時にサーバー自体から返されます — 以下の表は在庫一覧ではなく、構成を示したものです。

カテゴリ 例
ワークスペース list_workspaces, get_workspace, create_workspace
コンテンツとドキュメント search_docs, get_doc_outline, write_docs
ブランディング update_branding, update_ui_settings, update_navigation
AI 設定 update_ai_settings, set_chat_system_prompt, set_chat_hooks
SEO とドメイン update_seo, update_domain
翻訳 update_languages, set_translation_mode, approve_translation
アナリティクス get_analytics, get_ai_questions, get_failed_searches, get_negative_feedback, get_top_visitors, get_visitor_activity
Webhook register_webhook_*, list_webhook_deliveries, test_webhook
スキル find_skill（docs-skills カタログにクエリを実行）

Claude Code からの接続#

mcp add --transport http https://docsbook.io/api/mcp/server

OAuth フローがブラウザで開き、認証すると、ツールが Claude Code に表示されます。管理する API キーも、編集する設定ファイルもありません。

Cursor も同じ MCP サーバーを使用し、同様の UX を提供します。ChatGPT と Gemini は 2026 年にかけて HTTP MCP のサポートを追加しています。

LSP スタイルのツールは過小評価されているもう一つの柱（ローカルプラグイン、ホスト型 MCP ではない）#

Docs の MCP マーケティングの多くは読み取り/書き込みに焦点を当てています。Docsbook の場合、search_docs は引用可能なセクションを見つけるため、get_doc_outline は検索や書き込みの前にすべてのページのタイトル、見出し数、サイズを確認するため、そして write_docs は変更をコミットするために使われます（OAuth の同意によって制御されます。接続を認証する際に、顧客は読み取り専用または読み取り/書き込みのスコープを選択します）。エージェントにとってより大きな価値があるのは LSP スタイルの検索およびナビゲーション機能ですが、稼働中のリポジトリでは、その機能はホスト型 MCP ツールよりもローカルの Claude Code プラグインとして提供する方が適しています。ディスク上でローカルに解析できるため高速かつ低コストで、ドキュメントをまだ公開する必要もありません。

Docsbook は markdown-lsp を通じてこれを提供します。ローカルで実行すると、エージェントは次の機能を利用できます。

  • doc_outline — ページの見出し階層（本文なし）
  • doc_search_symbols — すべての見出しに対するあいまいな部分列検索（"oaf" → "OAuth flow"）
  • doc_search_text — スニペットと正確な行/列を含む全文検索
  • doc_search_links_to — 参照元（LSP references）
  • doc_resolve_link — 相対リンクまたは Wiki リンクから、アンカー付きの絶対 GitHub URL への変換
  • doc_definition — page#anchor から正確なソース位置への移動

LSP（Language Server Protocol）は、VS Code における定義へ移動、参照の検索、シンボル検索を支えるプロトコルです。このプラグインは同じモデルをローカルのドキュメントツリーに適用するため、エージェントは IDE のような精度でナビゲーションできます。ホスト型 MCP サーバーは、クラウドが実際にデータを所有するワークスペース操作（ブランディング、分析、Webhook、翻訳）に専念します。

なぜこれが本当の配布チャネルなのか#

2025～2026年に見られた3つの兆候：

  1. Mintlifyのテレメトリ。 Mintlifyは、同社がホストするドキュメントサイト全体の30日間のトラフィック（約7億9,000万件のリクエスト）を計測し、AIコーディングエージェントが全リクエストの45.3%を占めたと報告しました。その内訳はClaude Codeが25.2%、Cursorが18.0%です（ドキュメントにおけるエージェントトラフィックの現状、2026年4月3日公開）。その後の計測では、2026年7月のエージェントの割合はトラフィックの66%となっています（2026年半ばのレポート、2026年7月29日公開）。これはウェブ全体ではなく、1社のベンダーが運用するフリートを対象としたものですが、ドキュメントへのエージェントトラフィックについて公表された計測としては最大規模です。
  2. Anthropicによるドッグフーディング。 Anthropic独自のドキュメントとClaude Codeのドキュメントは、MCPファーストです。
  3. クライアント側はすでに構築されている。 Claude Code、Cursor、ChatGPTにはMCPサポートが組み込まれているため、コネクタは読者側での導入を必要とせず、あなたの側で導入するだけで済みます。

開発者向けに構築しており、対象ユーザーがClaude CodeやCursorを利用しているなら、MCPはもはや任意のインフラではありません。

自分で構築する場合のコスト#

実用的な docs MCP サーバーには、以下が必要です。

  • HTTP トランスポート + JSON-RPC フレーミング
  • OAuth 2.0 Authorization Code + PKCE フロー
  • 型付きスキーマを備えたツール定義
  • 読み取りツール用のドキュメントグラフ解析 — ディスク上のローカル解析のほうが高速かつ低コストであるため、通常はホスト型エンドポイントではなく、markdown-lsp のようなローカル CLI ツールとして提供
  • 設定を編集する場合は書き込みアクセス
  • レート制限と監査ログ

未経験の場合、エンジニアリング作業で約4～6週間かかります。Docsbook の MCP サーバーはワークスペースに付属し、実行に費用はかかりません。markdown-lsp はドキュメントグラフの読み取りツール向けに無料で利用できるオープンソースです。

Docsbook は OAuth 付きのマネージド MCP サーバーを提供しているため、Claude Code と Cursor で、何も実行せずにドキュメントを読み取り、編集できます。接続の詳細は docsbook.io/mcp にあります。

無料で始める — クレジットカード不要

次のステップ#

Updated

このページは役に立ちましたか？

提供： Docsbook