エージェント対応コンテンツ

人間だけを対象に構築されたドキュメントサイトは、それ以外のすべてにとってHTMLの壁です。そこに到達したエージェントは、どのページが重要なのかを推測し、事実を得るために文章をスクレイピングし、読んだ内容に基づいて行動する手段を持ちません。Docsbookは、機械が直接利用できる4つの窓口を通じて同じドキュメントを公開します。これによりエージェントは、方法を見つけ、文書群を読み、その構造をたどり、変更できます。

この4つは代替手段ではありません。エージェントが順番に尋ねる4つの異なる質問、つまりこの作業はどう行うのか、何を呼び出せるのか、これはどこにあるのか、そもそも何が存在するのかに答えるものです。

各サーフェスから得られるもの#

各サーフェスが互いにどのように引き継ぐか#

引き継ぎこそが設計であり、偶然ではありません。

• スキルが必要性を示し、MCPサーバーがそれに応えます。 Docsbookのスキルは、あるステップで必要となる証拠（「ページを読む前に数値を読む」など）を示し、モデルがツールを選べるようにします。これは意図的な設計です。ツール名をハードコードしたスキルは、ツール名が変更された瞬間に機能しなくなり、しかも失敗は気づきにくい形で起こります。エージェントは隣接する別のものを選び、見た目は同じレポートの裏側で異なる方法を即興で実行してしまうのです。
• MCPサーバーが、エージェントにスキルの実行方法を伝えます。 以前は、Docsbookのマシン上で1つのスキルを実行し、実行ID（run_docs_*）を返すために4つのツールを使用していましたが、2026年12月9日に削除されました。現在は、docsbook_expertが方法、手順、各手順で使うツールを返し、リポジトリをすでに保持しているあなた自身のエージェントがそれらを実行します。
• コンテンツツールが読み取るのはグラフです。 search_docs、read_doc、get_doc_outlineはファイルをgrepするのではなく、リポジトリのMarkdownから構築され、サーバー側にキャッシュされたRichDocGraphに対してクエリを実行します。
• llms.txtは、どちらも持たないエージェントのためのフォールバックです。 トークンもチェックアウトもMCPクライアントも必要ありません。公開サイトに対してHTTP GETを実行するだけです。

これが正しい方法である理由（根拠）#

これらのうち2つについては、スローガンではなく測定結果として示す価値がある。大規模なツールレジストリに対する検索は独立にベンチマークされている。RAG-MCP（arXivプレプリント2505.03275、Gan and Sun、2025年5月）は、すべてのツールを一覧にするのではなくツールを検索した場合、ツール選択精度が「43.13%対13.62%のベースライン」となり、プロンプトトークンを「50%以上」削減できると報告している。20～3,251個のツールに「及ぶ」レジストリをベンチマークした2026年のプレプリントでは、固定された5ツールのショートリストに対する適応的な候補絞り込みについて、選択精度93.1%対87.1%と報告されている（arXiv 2605.24660）。いずれも査読前のプレプリントであるため、方向性は十分に裏付けられているものとして扱い、正確な数値についてはあるチームによる測定値として扱うべきである。

限界と未解決の問題#

• 4つのサーフェスのコストはすべて同じではありません。スキルカタログ、グラフ、llms.txtはすべてのプランで無料です。MCPツール呼び出しはプロジェクトの残高に対して呼び出しごとに従量課金され、Docsbookのモデル予算を消費する読者向けAIチャットはProから利用できます。現在の金額は料金ページに掲載されています。このドキュメントでは意図的に金額を記載していません。ページにコピーした価格は、気づかないうちに古くなるためです。
• 「エージェント対応」は形状に関する主張であり、ランキングに関する主張ではありません。Docsbookは、ページを取得できること、セクションが単独で成立すること、アンカーが解決されることを示せます。ただし、その後に特定のアシスタントがそのページを引用するかどうかを、この製品が測定するわけではなく、一般的な割合を示す公的な情報源もありません。測定可能な内容についてはGEOを参照してください。
• ツール数は変動します。140は、このビルドが登録しているツール名の数です。正確な数は、あなたのトークンに対してtools/listが返す値であり、管理パネルのMCPセクションでは、書き留められたコピーではなくライブの値を読み取ります。
• MCP仕様は、私たちの対応中にも変更されました。リビジョン2026-07-28によりMCPはステートレスになり、initializeハンドシェイクが完全に削除されました — 「ネゴシエーションハンドシェイクはありません」（バージョニングと互換性）。DocsbookのサーバーはステートレスなHTTPトランスポートで提供されていますが、SDKがサポートする初期化ベースのリビジョンにも対応しており、最新は2025-11-25です。また、オリエンテーションテキストをinitializeに保持していますが、これは2026-07-28以前の配置です。2026-07-28のみを話すクライアントは接続できません。残りの相違点についてはMCPサーバーのセキュリティを参照してください。
• ここにあるどのサーフェスも、ドキュメントが正しいことの代わりにはなりません。コーパスを完全にナビゲートできるエージェントでも、コーパスに書かれている内容を報告するだけです。

関連#

• GEO — 何にも接続しないアシスタントに引用されるためのもの
• llms.txt — SEOおよびGEOファミリーとともにドキュメント化された第4のサーフェス
• MCPツールリファレンス — パラメーターと課金クラスを含むすべてのツール
• ウェブフック — 何かが起きたときに尋ねるのではなく通知される、プッシュ側の仕組み
• AIチャット — 読者が会話するアシスタントで、同じグラフを読み取るもの