エージェント対応コンテンツ
人間だけのために構築されたドキュメントサイトは、それ以外のすべてにとってHTMLの壁です。そこに到達したエージェントは、どのページが重要なのかを推測し、事実を求めて散文をスクレイピングし、読んだ内容に対して行動する手段もありません。Docsbookは、同じドキュメントをマシンが直接利用できる4つのインターフェースで公開します。これにより、エージェントは方法を見つけ、コーパスを読み、その構造をたどり、変更できるようになります。
この4つは代替手段ではありません。エージェントが順番に尋ねる4つの異なる質問、つまりこの作業はどのように行うのか、何を呼び出せるのか、これはどこにあるのか、そしてそもそも何が存在するのかに答えるものです。
SKILL.mdカタログ:ドキュメント作業が実際にどのように行われるか、さらにその発見、バージョン管理、実行方法をあらゆるエージェントに教える4つのオーケストレータースキル
Model Context Protocol上の型付きツール310個:ページの読み取り、コミット、分析情報の読み取り、設定の変更、エージェント実行の開始
ドキュメントグラフ:ページ、見出し、リンク、アンカーをノードとエッジとして扱い、エージェントがgrepの代わりにたどれるようにするもの
認証モデル、トークンのスコープ、サーバーが保存するもの、そしてコンプライアンス上のギャップを明確に記載
トークンもチェックアウトもないエージェント向けの、公開サイトの機械可読インデックス
各サーフェスから得られるもの#
| サーフェス | エージェントの質問 | 得られるもの | かかるコスト |
|---|---|---|---|
| SKILL.md カタログ | 「この仕事を適切に行うにはどうすればよいか?」 | GitHub から取得できる、ガードレール、順序付きの手順、受け入れ基準を備えたワークフロー | なし — カタログは公開されており、find_skill に料金は発生しない |
| MCP サーバー | 「どのプロジェクトで、何を呼び出せるか?」 | 310 個のツール、接続時の instructions ブロック、次の操作を示す構造化エラー |
プロジェクトの残高に対して呼び出しごとに従量課金される。検出呼び出しは無料 |
| ドキュメントグラフ | 「この概念はどこにあり、何がリンクしているか?」 | 個別のノード名前空間としてのページと見出し、4 種類のエッジ、リンク切れ、アンカーの衝突 | すべてのプランで無料 — 独自の Markdown から構築される |
| llms.txt | 「このサイトにはそもそも何が存在するか?」 | 認証なしで取得できる、公開済みの全ページのフラットなインデックス | 無料で、Docsbook アカウントなしでも読める |
サーフェス同士の引き継ぎ方法#
引き継ぎこそが設計であり、偶然ではありません。
- スキルが必要なものを示し、MCPサーバーがそれに応えます。 Docsbookのスキルは、あるステップで必要となる証拠(「ページを読む前に数値を読む」)を示し、モデルにツールを選ばせます。これは意図的な設計です。ツール名をハードコードしたスキルは、ツール名が変更された瞬間に機能しなくなり、その失敗はサイレントです。つまり、エージェントは近いものを選び、見た目が同じレポートの裏側で別の方法を即興で実行してしまいます。
- MCPサーバーはスキルを代わりに実行できます。
run_docs_analyze、run_docs_create、run_docs_manage、run_docs_automateは、Docsbookのマシン上で4つのオーケストレータースキルのいずれかをワークスペースに対して実行し、結果ではなく実行IDを返します。 - グラフはコンテンツツールが読み取るものです。
search_docs、read_doc、get_doc_outlineはファイルをgrepするのではなく、リポジトリのMarkdownから構築され、サーバー側にキャッシュされたRichDocGraphに対してクエリを実行します。 - llms.txtは、そのどちらも持たないエージェント向けのフォールバックです。 トークンも、チェックアウトも、MCPクライアントも必要ありません。公開サイトに対するHTTP GETだけで済みます。
これが正しい方法である理由(エビデンス)#
| ルール | それを利用するマシン上で機能する理由 | 出典 |
|---|---|---|
| 手法はシステムプロンプト内の散文ではなく、エージェントが必要に応じて読み込むファイルとして公開する | AnthropicのAgent Skills設計では、スキルを段階的に読み込む — 「スキルがトリガーされるまで、コンテキストを占めるのはその名前と説明だけ」 | Agent Skillsの概要 |
| ツールの表面は型付きで名前付きにし、「ドキュメント作成を実行する」単一のエンドポイントにしない | MCPツールは「モデル制御されるように設計されており」、モデルがtools/listから発見して呼び出す |
MCP仕様 2026-07-28、Tools |
| すべてを一度にコンテキストウィンドウへ読み込まない | 「したがって、コンテキストは限界効用が逓減する有限のリソースとして扱わなければならない」 | 効果的なコンテキストエンジニアリング |
| 大規模なカタログには、フラットなリストではなく、モデルが検索できる構造を与える | Anthropicの測定では、「利用可能なツールが30~50個を超えると、Claudeが適切なツールを選ぶ能力は低下する」 | ツール検索ツール |
| 検索にはページの寄せ集めではなく、グラフを与える | 長いコンテキストの検索では中央部で性能が低下する。「モデルが長いコンテキストの中央にある関連情報へアクセスしなければならない場合、性能は大幅に低下する」(Liu et al., TACL 2024) | Lost in the Middle |
これらのうち2つについては、スローガンではなく測定結果の形で示す価値がある。大規模なツールレジストリに対する検索は独立してベンチマークされている。RAG-MCP(arXivプレプリント2505.03275、Gan and Sun、2025年5月)は、すべてのツールを一覧表示するのではなくツールを検索した場合のツール選択精度について、「ベースラインの13.62%に対して43.13%」と報告しており、プロンプトトークンを「50%以上」削減している。2026年のプレプリントは、「20~3,251個のツール」に及ぶレジストリをベンチマークし、固定された5ツールの候補リストに対する適応型の絞り込みで、選択精度93.1%対87.1%と報告している(arXiv 2605.24660)。いずれも査読前のプレプリントであるため、方向性は十分に裏付けられているものとして扱い、正確な数値はある1チームによる測定結果と考えるべきである。
制限と未解決の問題#
- 4つのサーフェスがすべて同じ料金というわけではありません。 スキルカタログ、グラフ、llms.txtはすべてのプランで無料です。MCPツールの呼び出しはプロジェクトの残高に対して呼び出しごとに従量課金され、Docsbookのモデル予算を消費する2つの機能 — エージェント実行(
run_docs_*、agent_*)と閲覧者向けAIチャット — はProから利用できます。現在の料金は料金ページに掲載されています。このドキュメントでは料金を一切記載していません。ページに転載した料金は、気づかないうちに古くなるためです。 - 「エージェント対応」は形状についての主張であり、ランキングについての主張ではありません。 Docsbookでは、ページを取得できること、セクションが単独で成立すること、アンカーが解決されることを確認できます。ただし、特定のアシスタントがそのページを引用するかどうかをこの製品が測定するわけではなく、一般的な割合を示す公的な情報源もありません。測定可能な内容についてはGEOを参照してください。
- ツール数は変動します。 310は、このビルドが登録しているツール名の数です。正確な数は、あなたのトークンに対して
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ツールリファレンス — パラメーターと請求クラスを含むすべてのツール
- Webhooks — 問いかけるのではなく、何かが起きたときに通知されるプッシュ側
- AIチャット — 読者が会話するアシスタントで、同じグラフを読み取る