MCPサーバー

Docsbook MCPサーバーは、あなたのドキュメントとその全ての管理面をAIエージェントに公開するリモートモデルコンテキストプロトコルサーバーです。Claude Codeまたは任意のMCP互換クライアントを1つのエンドポイントに接続し、ページを読み込み、変更をコミットし、分析を読み取り、エディタを離れることなく設定を変更します。

このページは、サーバーが提供する内容と、呼び出しが依存する内容のリファレンスです。ここにリストされているすべてのツールは、接続されたクライアントから呼び出すことができ、メーター付き呼び出しのコストはDocsbookの料金ページおよび管理パネル内の各ツールの行に記載されています。

Docsbook MCPサーバーとは何ですか？#

Docsbook MCPサーバーは、型付きRPCインターフェースを介してAIエージェントにツール、リソース、プロンプトを渡すためのオープン標準であるModel Context Protocol上で、310個のツールを公開します。それらのツールのうち、18個はWebhookイベントごとに1つ用意された登録用ツールです。136個は、それぞれ1つの対象についてドキュメント作業の1ステップを実行し、検証済みのJSONペイロードで応答するアクションツールです。41個は目標ごとに1つ用意されたエージェントで、各アクションを順番に実行するルートとして実装されています。12個は、Docsbook独自のクローラーでは到達できない対象に対応する外部スクレイピングベンダーを基盤としています。5個は、判断を加えずにアクションの基盤となる証拠を返すコレクターです。4個はバックグラウンド実行を開始および読み取ります。残りの94個は、ワークスペース、コンテンツ、チャット、分析、Webhook操作を対象とする個別に名前が付けられたツールです。その中には、リポジトリまたはWebサイトを信頼できる情報源として接続・設定する2つのツールと、スケジュール、イベント、または接続されたリポジトリのコミットに基づいて常駐エージェントを検索・起動する2つのツールが含まれます。

エンドポイント#

Docsbook MCP サーバーは、すべてのワークスペースとクライアントに対して1つのURLで提供されます。

https://docsbook.io/api/mcp/server

認証には、PKCEを使用したOAuth認可コードフローを採用しています。クライアントは1つの不透明なBearerトークンを受け取り、すべての呼び出しで提示します。リフレッシュトークンは発行されず、トークンが自動的に期限切れになることもないため、ローテーションするにはパネルでトークンを取り消し、再度認可します。プロジェクトごとにMCP URLを確認する必要はありません。OAuthフローはサインイン済みのアカウントを対象としており、その後クライアントがワークスペースを選択します。フロー、スコープ、制限事項については、MCPサーバーのセキュリティを参照してください。

AI クライアントを Docsbook に接続するにはどうすればよいですか？#

クライアントを https://docsbook.io/api/mcp/server に向け、ブラウザで OAuth プロンプトを完了します。Docsbook MCP サーバーは OAuth に対応したリモート HTTP サーバーであるため、最新の MCP クライアントであれば、ローカルプロセスを実行せず、同じエンドポイントで接続できます。以下のサブセクションでは、各クライアントに対応する正確なコマンドまたは設定ファイルを示します。

自分のプロジェクト内でカタログを参照することもできます。管理パネルを開き、サイドバーで MCP を選択してください。初めて開くと、そのセクションにクライアント用のインストールコマンドを載せた有効化パネルが表示されます。これにより、カタログを読む前に接続でき、パネルを押すとテーブル上で短いガイドが実行されます。その背後には、現在サーバーが提供しているすべてのツールのテーブルがあります。これは書き留められたコピーではなく、サーバーからライブで読み込まれたもので、各ツールの課金クラス、1 回の呼び出しあたりの価格、通常どのくらいの時間呼び出しが開いたままになるか、トークンなしで読者が呼び出せるかどうかが表示されます。検索したり、フィルターで絞り込んだりできます。課金クラスはそれぞれ固有の価格とともに表示されます。また、任意の列で並べ替えることもできます。行にカーソルを合わせると、そのツールについて知っておくべき残りの情報をまとめたカードが開きます。そこには、ツールの動作、呼び出しにかかる費用と通常どのくらいの時間開いたままになるか、受け取る引数の数とそのうち必須のものの数、動作するサンプルから呼び出されている回数が表示されます。さらに自分のプロジェクトでは、これまでにかかった費用と最後に呼び出した日時、すぐコピーできる呼び出し可能な ID も確認できます。行をクリックすると、そのツール専用のページが開きます。このページにはアドレスがあり、URL にツールが含まれているため、更新、ブックマーク、同僚への送信を行っても、300 行あるテーブルではなく同じツールを表示できます。ページ内のすべては、その 1 つのツールに関するものです。引数はフォームとして表示され、実行ボタンを押すと、このプロジェクトに対して実際の呼び出しが行われます。ボタンには、料金が残高から引かれる前に価格が表示されます。その下には、この 1 つのツールに絞り込まれた呼び出し履歴があります。これは、他の場所で確認できるものと同じフィードテーブルから取得されます。呼び出しごとに 1 行が表示され、行を展開すると、入力された内容、返された内容、誰が要求したか（自分の実行、外部エージェント、スケジュール、イベント）、所要時間、設定価格、実際に残高から引かれた金額など、呼び出しの全内容を確認できます。その下には、呼び出しを無人で実行する仕組みがあります。スケジュール、イベント、または保存したフィードのいずれかで、呼び出しは単一のイベント名ではなくフィード全体を監視できます。また、有効になっている各行には、すでに何をトリガーとして実行しているかが表示されるため、以前に設定した実行を確認せずに置き換えてしまうことはありません。ページの最後にあるのはこのツールを使用するエージェントです。これは、実際にこのツールを呼び出すルートを持つエージェントセクションのカードで、有効なものが先に表示され、それぞれに個別の切り替えスイッチがあります。そのため、呼び出しの料金を確認したページから、ツールをスケジュールに設定できます。その下には、自分のクライアントにコピーできる動作するサンプルが 1 つあります。Docsbook 内から実行されるものが、その呼び出しです。

Claude Code#

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

最初の呼び出しはOAuthのためにブラウザタブを開きます。承認後、ツールはClaude Code内で利用可能になります。

カーソル#

カーソルには mcp add コマンドはありませんが、ワンクリックインストールリンクを受け付けます：

cursor://anysphere.cursor-deeplink/mcp/install?name=docsbook&config=eyJ1cmwiOiJodHRwczovL2RvY3Nib29rLmlvL2FwaS9tY3Avc2VydmVyIiwidHlwZSI6Imh0dHAifQ==

または、サーバーを ~/.cursor/mcp.json に追加します（または 設定 → MCP & 統合 → 新しい MCP サーバー を使用します）：

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

カーソルを再読み込み — 最初の使用時に OAuth がブラウザで開きます。

Codex CLI#

codex mcp add docsbook --url https://docsbook.io/api/mcp/server

または、設定を直接編集します — CodexはMCPサーバーを~/.codex/config.tomlに保存します:

[mcp_servers.docsbook]
url = "https://docsbook.io/api/mcp/server"

ウィンドサーフィン#

~/.codeium/windsurf/mcp_config.jsonを編集して、カスケードパネルを更新してください：

{
  "mcpServers": {
    "docsbook": {
      "serverUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

クライン#

オープン Cline → MCP サーバー → MCP サーバーの構成 して貼り付けます:

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server",
      "transportType": "http"
    }
  }
}

Gemini CLI#

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

デフォルトのスコープは現在のプロジェクトです — --scope user を追加してグローバルにインストールします。あるいは、~/.gemini/settings.json に手動で追加します（キーは httpUrl です; url は SSE を意味します）:

{
  "mcpServers": {
    "docsbook": {
      "httpUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

GitHub Copilot (VS Code)#

code --add-mcp '{"name":"docsbook","type":"http","url":"https://docsbook.io/api/mcp/server"}'

または、ワークスペース内に .vscode/mcp.json を作成し、Copilot Chat MCP ピッカーからサーバーを有効にします（キーは servers であり、 mcpServers ではありません）:

{
  "servers": {
    "docsbook": {
      "type": "http",
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

ChatGPT#

ChatGPTは、ChatGPTの有料プランでConnectorsを通じてリモートMCPをサポートしています。その要件はOpenAIのものであり、Docsbookのものではありません。

ChatGPT → 設定 → Connectors → 高度な設定 → 開発者モードを開きます。
作成をクリックし、URLを貼り付けます: https://docsbook.io/api/mcp/server。
プロンプトが表示されたら、ブラウザで認証します。

Docsbook MCPツールは何のためにありますか？#

Docsbook MCPツールは、次の4つのことを実現するために存在します：より多くの適格な読者が訪れ、彼らの目的を達成して去り、購入意欲のある読者がアシスタントによって引き継がれ、質問が人に届くことが少なくなることです。以下のすべては、それらの4つのどれに対応しているかによってグループ化されています。

あなたのドキュメントはコストセンターではありません。それは3つの役割を持つチャネルです： 見つけられること（Googleや、あなたのバイヤーが今はGoogleの代わりに尋ねるAIアシスタントによって）、 読者を転換すること（何も得られずに訪問が終わるのは、決して不満を言わない失われた顧客です）、そして 何が効果的だったかを証明すること（次の編集が推測ではなく決定になるように）。

ドキュメントツールが収益を上げる方法は4つしかなく、以下のすべてのツールはそのうちの1つに対応しています：

レバー	メカニズム	コアツール
獲得	検索やAIの回答から、より多くの適格な読者が訪れる	`update_seo`, `update_geo`, `update_aeo`, `get_search_rankings`
転換	訪れた読者が目的を持って去る	`get_visit_outcomes`, `get_dead_end_pages`, `get_content_health`, `get_route_patterns`
販売	アシスタントが購入意欲のある読者を単に回答するのではなく引き継ぐ	`get_chat_intent`, `get_chat_conversations`, `set_chat_system_prompt`, `set_chat_hooks`
回避されたコスト	ドキュメントによって回答された質問は、人によって回答されなかった質問です	`get_ai_unanswered`, `get_failed_searches`, `get_search_zero_click`, `get_insights`

これらのいずれにも対応しないツールはコンテキストを返し、決定を返しません。 Pageviews: 12,340はコンテキストです。 31% of your readers left with nothingは決定です。

見つけられること#

ツール	その価値
`update_seo`	メタタグ、サイトマップ、OpenGraph。基本的な要素：これがなければ、ランク付けされるべきページができません。
`update_geo`	生成エンジン最適化 — ページを構造化して、LLMがそれを引用できるようにし、あなたに帰属させます。AIの回答のソースになることと、その中で見えなくなることの違い。
`update_aeo`	回答エンジン最適化 — コンテンツをAIアシスタントがそのまま引用する直接回答形式に整形します。
`get_search_rankings`	実際のGoogle Search Consoleのポジション、さらに「改善の価値がある」セットがポジション5–20に設定されている — Googleがすでに表示しているが、まだクリックを獲得していないページ。「SEOを行うべきだ」という考えを、特定のページと特定のクエリに変えます。Googleに対して約2日遅れています。
`get_analytics` (AIボットの分析)	ChatGPT、Perplexity、Claudeのクローラーがあなたを全く読んでいるかどうか。ここがゼロであれば、GEO作業が効果を上げていないことを意味します — クローリングなし、引用なし、リファラルなし。

バイヤーは、ベンダーに尋ねる前にアシスタントに尋ねることが増えています。アシスタントが競合のドキュメントから回答すると、あなたはショートリストに入らず、その損失はダッシュボードに現れません。

読者を失わない#

get_visit_outcomes は全体の製品のヘッドライン番号です：すべての訪問を成功 / 行き止まり / バウンス / 部分的に分類し、行き止まり率 と 自己解決率 を報告します。行き止まりとは、検索したり、AIに質問したり、いくつかのページを開いたりしたが、何も得られずに去った読者のことです。以下のすべては「…そして具体的にはどこですか？」という質問に答えます。

ツール	その価値
`get_dead_end_pages`	書き直しキュー、ランク付けされています。`terminal_success` でマークされた行は、人々が必要なものを得たために離れたページです — このツールは、あなたの最良のページが「修正」されるのを防ぎます。
`get_content_health`	ページごとの0–100スコア、行き止まりの出口と否定的なフィードバックを組み合わせています。大規模なドキュメントセットで手動で4つのレポートを相互参照するのを置き換えます。
`get_rage_signals`	1回の訪問で3回以上再入場したページ、A→B→Aのバウンスバック、繰り返しの検索。行き止まり率は訪問が失敗したことを示し、これはどこで失敗したかを示します。再入場は、そのページに答えがあるべきであることを意味し、実際にはない — 修正は新しいコンテンツではなく、構造の再編成です。
`get_route_patterns`	読者が実際に歩く2–4ページのシーケンスと、それぞれがどれだけの頻度でうまく終わるか。悪い結果で終わる頻繁なルートはナビゲーションの欠陥であり、ページの品質の問題ではありません — それらのページを書き直しても解決にはなりません。
`get_reverse_funnel`	成功した訪問から逆算します：どのエントリページが良い結末につながるか。仮説は必要なく、読者が見つけた道を浮き彫りにしますが、あなたが設計したものではありません。
`get_forward_funnel`	あなたが宣言したルートの完了と、どの遷移が漏れているか。あなたのオンボーディング完了率です。
`get_metric_timeseries`	日ごとの任意のヘッドラインメトリック — 「これは悪化しているのか？」という質問に答え、変更をリリース日と照らし合わせる唯一のツールです。
`get_visits`	レートの背後にある証拠：1回の再構築された訪問。数値が争われているときや、実際の読者を苦情に結びつけるために使用します。
`get_retention`	コホートごとのW1/W4リターン率。方向性はセクションによります：高いリターンはリファレンスドキュメントには健康的であり、オンボーディングには失敗です。

提供していない需要#

ここにある各行は、1ページを書くことで事前に対処できるサポートチケットです。

ツール	その価値
`get_ai_unanswered`	アシスタントが答えられなかった質問を、読者自身の言葉で。最も安価なコンテンツプランです。
`get_failed_searches`	結果がゼロの検索 — 別の扉を通った同じギャップ。
`get_search_zero_click`	結果が返ってきたがクリックなしだった検索。ゼロ結果レポートが見逃すギャップ：検索は機能したが、読者はすべての結果を拒否したことを示しており、これはタイトルと要約に関連しています — ページ本文を修正するよりもはるかに安価です。
`get_popular_searches`	人々が最も探しているもの。`get_content_health`と同じページで読み比べてください：高需要 + 低健康 = あなたの最も高価な壊れたページ。
`get_negative_feedback`	低評価のページ、ランク付け。読者の明示的な投票で、推測は不要です。
`get_insights`	事前に組み合わされた要約 — ドキュメントのギャップ、ゼロ結果の検索、嫌われたページの影響推定を1回の呼び出しで。今週何を修正すべきかを始めるための場所です。

アシスタントを通じた販売#

チャットはサポートウィジェットではありません。見込み客が自分の反対意見を明確な言葉で述べる唯一の場所です。

ツール	その価値
`get_chat_intent`	購入段階によって分割された会話 — 評価、価格設定、統合、サポート、バグ。誰が購入を決定しているのか、何が購入を妨げているのかを回答します。読者が競合他社を言及したときに競合他社の名前を挙げる: ページレベルのレポートでは得られない競争情報です。
`get_chat_conversations`	トピックごとにグループ化された質問、`click_through` — 読者が引用されたページを開いた会話の割合。購入意図のあるトピックでクリックがないのは販売漏れ: 回答は正しかったが、誰も前に進めなかった。単位は会話であり、質問ではありません。なぜなら、1人の立ち往生した読者からの4つの質問と、4人の読者からのそれぞれ1つの質問は、同じカウントと反対の結論をもたらすからです。
`set_chat_system_prompt`	修正がどこにあるか — アシスタントを図書館員から営業担当者に変える: 資格を与え、反対意見に対処し、デモにルーティングします。
`set_chat_hooks` / `test_chat_hook`	前後のLLMフック: ライブコンテキスト（価格、在庫、読者のプラン）を注入するか、意図が現れた瞬間にリードをキャッチします。
`get_ai_questions`	逐語的な質問ログ — FAQ、オンボーディングメール、反対意見処理のための原材料。

あなたのドキュメントチャットで述べられた価格に関する反対意見は、ページビューよりも価値があります: 読者は自分自身を資格付け、購入を妨げているものを正確に伝えました。

調査結果に対処する#

修正を伴わない診断は、単なる報告です。これらのツールは、1つの接続内でそのループを完了させます。

ツール	価値
`search_docs`	引用可能なそのままのセクション — テキスト、正規表現、見出し、パスの各モードに対応します。編集前にエージェントが読むことで、正しい行を変更できます。
`search`	意味検索（埋め込みベースの検索） — 文字どおり何と書かれているかではなく、何を意味しているかによってページを検索します。あらかじめ構築されたベクトルインデックスを使用します。ページタイトルとはまったく異なる表現で尋ねられた自然言語の質問も見つけられます。すべてのプランで利用でき、常に回答を返します。まだインデックスのないプロジェクトでも、代わりに全文検索で同じ質問に回答し、どのエンジンが実行されたかを示します（`mode`: `semantic` または `lexical`）。プロジェクトの公開エンドポイントではトークンなしで提供されるため、読者のエージェントもドキュメントを検索できます。
`get_doc_outline`	タイトル、見出し数、サイズを含むすべてのページを一覧表示します。検索や書き込みの前に、低コストで全体像を把握できます。
`write_docs`	1つまたは複数のMarkdownファイルを1つのアトミックなgitコミットとしてコミットします。分析をリリース済みの変更へと変換します。
`fetch_url`	公開ウェブページを1ページ、クリーンなMarkdownとして読み取ります。ワークスペースの外部にある世界とページを照合できるツールです — 競合他社の料金、自社のマーケティングサイト、またはドキュメントが依存するリンクがまだ有効かどうかを確認できます。
`get_change_history`	編集前に呼び出します。以前に何が変更され、その後、影響を受けたページのトラフィックがどう動いたかを確認します — 変更前後の生の訪問数、`low_sample` および `pending` フラグを含み、意図的に判定は行いません（同じ週にコミットとトラフィックの変動があったからといって、因果関係があるとは限りません）。これがなければ、同じ推奨事項が同じ確信度で永遠に繰り返されます。
`get_page_diff_impact`	リリース後に呼び出します。その編集は実際に役立ったでしょうか。コミットが変更したページと変更していないページを、変更前後で比較します — 成果の内訳、セルフサービスでの解決、最初の価値に到達するまでの時間を確認できます。変更していないページが対照群であり、そこが重要なポイントです。ドキュメントのトラフィックは編集とは無関係な理由でも変動するため、改善として数えられるのはサイト全体の傾向を上回った場合だけです。単にサイト全体の傾向と一致した変更は、成功ではなく無効果として報告されます。さらに、国、読者の言語、デバイス別に訪問数を分解し、それぞれについて変更していないページの同じ区分の変動と並べて表示します。これにより、「トラフィックが増えた」を意思決定につなげられます。平均価格とCTA URLを設定している場合は、変更前後の変更対象ページのコンバージョンと収益も算出し、その編集の価値を金額化します。
`update_navigation`	見つかった欠陥 `get_route_patterns` または `get_reverse_funnel` を修正します。多くの場合、ページを書き直すよりも安価で効果的です。
`find_skill` / `find_widget`	ワークフローのスキルやインタラクティブウィジェットなど、パッケージ化された機能を自分で作成するのではなく見つけます。
`list_issues` / `get_issue` / `create_issue`	プロジェクト独自のGitHubイシュートラッカーです。すべての調査結果が、その場ですぐに行う変更とは限りません — `create_issue` は、そうでないものを会話の終了で終わらせず、記録する方法です。既にオープンしているイシューと調査結果が重複しないよう、まず `list_issues` を実行します。起票には読み書き可能なトークンが必要ですが、読み取りには必要ありません。

見ることなく知る#

ダッシュボードは誰かが開かなければ機能しません。ウェブフックは常に機能します。ウェブフックを登録するには1回の書き込み呼び出しが必要で、その後の各配信はDocsbookネットワークからのアウトバウンド呼び出しです。

イベントツール	その価値
`register_webhook_chat_no_answer`	アシスタントが読者を失敗させました — Slackで、数秒のうちに、彼らがまだページにいるかもしれない間に。
`register_webhook_search_no_results`	検索についても同様です。
`register_webhook_traffic_spike` / `_drop`	スパイクは、追求する価値のあるマーケティングの勝利か、トラブルシューティングに人々を駆り立てるインシデントのいずれかです。リリース後のドロップは、次の四半期に見つけることになる回帰です。
`register_webhook_content_outdated`	製品から逸脱したドキュメント — ほとんどの悪いAI回答の根本原因です。
`register_webhook_chat_negative_feedback`, `_feedback_received`	読者の明示的な苦情で、そのセクションを所有する人にルーティングされます。
`register_webhook_usage_limit_approaching`, `_overage_limit_reached`	予算管理 — 驚きの請求書はありません。
`list_webhooks`, `unregister_webhook`, `list_webhook_deliveries`, `replay_webhook_delivery`, `test_webhook`	上記を操作します：監査、再試行、検証。

リーチと所有権#

ツール	その価値
`update_languages`	ターゲット言語を有効にします。`get_analytics`の国/言語の内訳と並行して読む: 読者がすでにいる場所で翻訳する、希望する場所ではなく。
`set_translation_mode`, `upload_translation`, `approve_translation`, `list_pending_translations`, `get_translation`, `delete_translation`	翻訳パイプライン — 自動、または人間の承認を伴う外部提供。
`update_access`	プライベートワークスペース、パスワード、または独自のSSO/OIDC。調達が必要な企業への販売を妨げません。
`update_domain`	自分のドメイン上のドキュメント — SEOの権威はあなたに蓄積され、ベンダーのサブドメインには蓄積されません。
`update_branding`, `update_ui_settings`	あなたの製品であり、プラットフォームのものではありません。

支払いの組み合わせ#

上記のどのツールも製品ではありません。これらのループが製品です。

ループ 1 — "どのページが顧客を失わせているのか？"#

get_visit_outcomes      → the rate: 31% of visits end with nothing
get_dead_end_pages      → which pages those visits died on
get_rage_signals        → what the reader was trying to do there
get_change_history      → has this page been "fixed" before, and did it work?
search_docs → write_docs → ship the fix
get_page_diff_impact    → did the edited pages beat the pages you did not touch?

率だけでは行動に移せず、ページリストだけでは原因が欠けており、get_change_historyなしの修正は、完全な自信を持って失敗した編集を繰り返すことになります。最後のステップがループを閉じるのです：サイト全体のトレンドラインは十数の理由で動くため、「私のコミットの後に率が改善された」というのは、あなたが編集したページが 編集しなかったページよりも改善された 時のみ証拠となります。順序だけが、あなたが擁護できる変化を生み出します。

get_route_patterns   → a frequent 3-page route that keeps ending badly
get_reverse_funnel   → the route successful readers actually take
update_navigation    → promote the working entry point
get_forward_funnel   → confirm completion on the declared route improved

個々のページが良好なスコアを持ちながら失敗するルートはナビゲーションの欠陥です — get_content_health は健康なページを永遠に指し続けます。

ループ 3 — 「取引はどこで漏れているのか？」#

get_chat_intent          → 40 pricing-stage conversations, a competitor named in 12
get_chat_conversations   → those topics have near-zero click_through
set_chat_system_prompt   → handle that objection, route to a demo
write_docs               → a comparison page that answers it once and for all
get_chat_intent (later)  → did the objection stop recurring?

明示された反対意見から始まり、出荷された回答で終わるドキュメント製品の唯一のループです。 click_through は「アシスタントが回答した」と「アシスタントが販売した」を分けるものです。

ループ 4 — "私はAIに見えますか、そしてそれは誰かを連れてきましたか？"#

update_geo + update_aeo   → structure content for citation
get_analytics (ai_bots)   → confirm crawlers are actually reading it
get_search_rankings       → track classic-search position alongside
get_analytics (referrers) → referrals arriving from AI assistants
get_visit_outcomes        → and whether those arrivals end in success

最後のステップは、誰もがスキップするものです。行き止まりになるAIの回答からのトラフィックは、トラフィックがないよりも悪いです — あなたは可視性を得て、インプレッションを消費しました。

自己修復ループ#

CIからのスケジュールでループ1を実行します：

weekly:  get_content_health  → take the worst 3
         get_change_history  → skip anything already tried and failed
         search_docs → write_docs → open a PR
         get_page_diff_impact → report on the PR whether the edited pages
                                beat the untouched ones, or say they did not

自ら修復し、その作業を示すドキュメント — 「問題を見た」と「問題を修正した」接続を残さずに。

全体の仕事を引き渡す#

上記のすべてのツールは、それを要求した呼び出しの中で応答します。四つは応答せず、それが彼らのポイントです。

サイトを監査すること、構築すること、再構成すること、またはそれを正直に保つためのモニターを立ち上げることは、数分の作業です — ページを読み、数字を考え、ファイルをコミットします。 find_skill は、SKILL.mdをあなたのエージェントに渡すことでそれを処理します。これは、あなたのエージェントがここに接続されていて、ワークスペースを選択し、それに20回のツール呼び出しを費やす場合にのみ機能します。これらの四つは、代わりに私たちの側でスキルを実行し、あなたのワークスペースに対して、スキルが書かれた完全な管理ツールセットを使用します。

ツール	その価値
`run_docs_analyze`	あなたのために実行される完全な `docs-analyze` 監査：何が間違っているのか、検索ポジション、読者の行動、あなた自身の目標から判断されます — さらに、数字では示されないギャップ、ドキュメントが決して扱わないオーディエンスとユースケースも含まれます。監査モードが宣言されているため、何も変更できず、読み取り専用トークンで動作します。
`run_docs_create`	完全な `docs-create` パイプライン：製品を監査し、構造を決定し、ページを書き、公開します。あなたのサイト、リポジトリ、離れている別のプラットフォーム、または製品名だけから。
`run_docs_manage`	引用されるのではなく適用される `docs-manage` ルールブック：ページが書き直され、サイトが構成され、目標とファネルが宣言されます。リクエストが判断（「これを良くして」）であるときに使用しますが、値（「アクセントを#0f0に設定」）ではありません。
`run_docs_automate`	`docs-automate`、したがってチェックが継続されます：ドリフトガード、ウェブフック、CIチェック、アラート、常駐モニター。

ジョブを開始し、その結果を読むことは二つの別々の呼び出しです。 run_docs_* 呼び出しは { run_id, state: "queued" } を返します — 決して発見を返さず、決してページを返しません。 get_agent_run は状態を返し、実行中のライブ進捗を示し、成功した場合はレポート、実行が行ったすべてのアクション、そして何が変わったかを返します。 list_agent_runs は、失った実行IDを見つけます； cancel_agent_run は、完了していないものを停止し、すでにコミットされたものを元に戻すことなく停止します。

書き込みを必要とする三つは、読み書きトークンを必要とします。 run_docs_analyze は、書き込むことができないため、必要ありません。

意見なしで証拠を購入する#

監査は1回の呼び出しで7つのことを行います：収集、正規化、解釈、判断、スコア付け、ランク付け、推奨。最初の2つを2回実行すると同じ答えが得られ、誰でも手作業で再実行して確認できます。 judge 以降の答えはモデルのものです。両方の半分は1つのエージェント実行として請求されていました。これは、検証できる半分が信頼しなければならない半分の価格で販売されていたことを意味します。

5つの コレクター は、単独での最初の半分であり、エージェント実行ではなく probe として請求されます：

ツール	返される内容
`collect_page_text`	実際にワイヤーが提供するあなたのライブページ — ステータス、タイトル、メタディスクリプション、見出し、コードブロック、JavaScriptエンジンなしで生き残る散文の単語数 — と、同じパスのために保存しているソースのサイズの横にあります。これら2つの間のギャップが行です：リポジトリに8,000文字があり、40単語として到着するのは、ソースを読み取るすべてのチェックにとって完璧なページであり、ページを読むすべてのアシスタントにとって引用不可能です。
`collect_corpus_map`	サイズ、見出しの数と深さ、セクション、スタブ、ナビゲーションが到達する量を持つすべてのページ。
`collect_assistant_questions`	読者があなたのドキュメントアシスタントに尋ねたこと、逐語的に、未回答のもの、回答率とその分母、到着した言語。
`collect_traffic`	誰が到着したか、訪問がどのように終了したか、どのページで終了したか、そして読者が歩く2〜4ページのシーケンス — 4つのテーブル、分けて保持。
`collect_onsite_search`	読者があなた自身の検索ボックスに入力した内容、何も返さなかったもの、結果を返したがクリックされなかったもの — 3つのテーブル、分けて保持、最初は欠落したページであり、2番目は失敗したタイトルです。

パスにはモデルがないため、信じられないものは何もありません — そしてペイロードがそれを証明します。すべての回答には reproduce ブロックが含まれています：行ごとの正確なMCP呼び出しとそれに使用された引数。自分で実行すると、タイムスタンプを除いて同じ記録が返されます。監査が返すものはそれを提供できません。なぜなら、監査の答えはモデルを通過したからです。

あなたが得られないのは判断です。発見、スコア、ランク付け、推奨はありません — それらはアクションツールの価格が購入するものです。そして、静かに1つを含めたコレクターは、価格の一部でのエージェント実行となります。

安い方が正しい場合。 Search Consoleが接続されていない場合、 measure_intent_match はそのランキング軸を未測定としてスコアし、実行のために請求します； collect_corpus_map は検索データ、トラフィック、履歴を全く必要とせず、今朝上がったサイトの実際の行を返します。アクションが構築された数字を取得したい場合も同様で、読むかどうかを決定する前にそれを確認できます。

欠けているものは声に出して言われます。 読まれなかったソースは3回現れます — skipped、それを持っていた場合に追加される内容の unavailable、そして失敗した理由を持つ独自の reproduce 行。割るものが何もない率は null として返され、その理由と共に、決してゼロとしては返されず、すべての率にはその分母が含まれます。

数字を正直に読む#

Docsbook MCPサーバーからのすべての分析応答には、metricsフィールドに独自の注意事項があります。繰り返す価値のある3つの点があります：

訪問者はハッシュ化されたIPです。 オフィスNATは複数の読者を1つに統合し、モバイルネットワークは1人の読者を多くに分割します。トレンドを報告し、人数を数えないでください — get_retentionが最も影響を受けます。
30回未満の訪問ではレートが保持されません、そして薄い日はthinとしてフラグが立てられます。4回の訪問で100%の行き止まり率はノイズです。
terminal_successは失敗ではありません。 スニペットをコピーした後に人々が離れるページは、あなたが持っている最良のページです。すべてのランキングツールはこれを除外します — 手動でその間違いを再導入しないでください。

エージェントからドキュメントのコンテンツを検索・編集するには？#

エージェントからドキュメントのコンテンツを操作する方法は2つあります。どちらを選ぶかは、エージェントがリポジトリをディスク上に持っているかどうかによって異なります。

MCPトークン経由のホスト型 — search_docs（読み取り専用。スコープに関係なく、接続された任意のトークンで動作）、get_doc_outline（読み取り専用。検索または書き込みの前に、すべてのMarkdownページのタイトル、見出し数、サイズを一覧表示）、write_docs（読み書きスコープで承認されたトークンが必要。1つ以上のファイルを単一のアトミックなGitコミットとしてコミット）。これらはローカルチェックアウトを必要とせず、Docsbookがホストするリポジトリに直接対して実行されます。
markdown-lsp経由のローカル — チェックアウト済みのファイルを直接操作するエージェント向けに、markdown-lspは、より高度なグラフに関する質問（ワークスペースのアウトライン、見出しのあいまい検索、コンテキスト付き全文検索、被リンクと発リンク、リンク解決）に、エージェントがコマンドとして実行する形 — npx markdown-lsp <subcommand> ./docs — または言語サーバーとして応答します。これはMCPサーバーではなく、トークンも必要ありません。サブコマンドの一覧とその理由については、Source of Truthを参照してください。

エージェントがMCP接続のみを持っている場合（ローカルチェックアウトがない場合）はsearch_docs/write_docsを使用し、すでにリポジトリをディスク上に持っていて、より詳細なグラフナビゲーションを行いたい場合はmarkdown-lspを使用してください。

Docsbook MCP サーバーへの呼び出しは何を使用しますか？#

Docsbook MCP サーバーへの従量課金対象の呼び出しはすべて、その呼び出しの対象となるプロジェクトの残高から差し引かれます。この残高は、チャージによって補充され、そのプロジェクトの他の AI 作業にも使用されるものです。MCP 専用の別メーターや、計画の基準となる月間呼び出し回数の上限はありません。制限となるのは資金だけです。

呼び出しには、実行前に固定され、回答のサイズに左右されない定額が課金されます。同じレポート呼び出しであれば、10 ページのサイトでも 1 万ページのサイトでも同じ金額です。金額を決めるのは、呼び出しを提供するためにサーバーが行う処理です。

分類	呼び出しによってサーバーが行うこと	含まれるツール
含まれるもの	検索以外は何もしない	`get_info`, `find_skill`, `find_widget`, `list_workspaces`, `get_workspace`, `create_workspace`
読み取り	すでに保存されている行を読み取る	ページ、設定、またはレジストリ行 — 分類されていないツールが該当する分類
書き込み	保存された状態を変更する	`create_`, `update_`, `set_`, `delete_`, `register_`, `unregister_`, `upload_`, `approve_`, `mark_*`
分析	イベントストアをスキャンする	ファネル、ジャーニー、リテンション、ランキング、フィード、`query_events`
外部送信	Docsbook ネットワークの外部へ出る	`fetch_url`, `read_source`, `test_`, `replay_`、4 つのトラッカー読み取り (`list_issues`, `get_issue`, `get_pull_request`, `search_prior_work`)、およびベンダー連携のスクレイピングツール
調査	モデルを使わずに、1 つの種類の情報を収集して正規化する	`collect_*`
AI	モデルを呼び出して書き込み、読み取り、またはランキングを行う	`write_docs`, `search_docs`, `search`, `get_insights`, `get_chat_intent`
レンズ	渡された証拠レコードを単一の指定された視点から再読み取りし、1 回のモデル処理を行う	予約済み (`lens_*`) — 現在この分類に属するツールはありません
エージェント	1 回の呼び出しの背後でエージェント全体を実行する	135 個のアクションツール (`observe_`, `explain_`, `discover_`, `decide_`, `plan_`, `draft_`, `measure_`, `verify_`, `learn_`, `handoff_`)、41 個の `agent_` 目標に加え、`audit_geo`、`generate_issues`、`run_docs_`

アクションツールの料金は、宣言された作業内容に基づいて決まります。つまり、読み取る証拠の種類がいくつあるか、モデルとの往復を何回行う可能性があるか、サイト外へデータを送信するか、成果物を書き込むか、といった要素に基づくもので、分類全体に対する一律の金額ではありません。そのため、限定的な観測は詳細な下書きよりも少ない割合の料金となり、公開されている待ち時間（およそ 20 秒から 70 秒）も同様に異なります。

すべての分類および個々のツールの現在の金額は、管理パネルの MCP セクションにある各ツールの行で確認できます。金額は記載されたコピーではなく、サーバーからリアルタイムに読み取られます。また、Docsbook の料金ページでも確認できます。このページでは意図的にどちらの金額も記載していません。ドキュメントにコピーされた価格は、誰にも気づかれないまま古くなる可能性があるためです。

検出に料金はかかりません。サーバーの説明、スキルやウィジェットの検索、ワークスペースの一覧表示、ワークスペースの作成はすべて無料です。ハンドシェイクや、課金対象となるものを作成する呼び出しに対して料金が請求されることはありません。

どのプロジェクトが支払うかは、呼び出し自体から判断されます。指定したワークスペースや、対象範囲となるリポジトリに基づき、所有しているプロジェクトだけが対象になります。プロジェクトを指定しない呼び出しは、従量課金なしで提供されます。ツールが続けて AI 作業を行う場合、その作業についても料金が発生します。両方の料金は置き換わるのではなく、加算されます。

残高がなくなると、従量課金対象の呼び出しは実行前に拒否されます。拒否メッセージには、残高がなくなったプロジェクト、その呼び出しに必要な金額、残額、およびそのプロジェクトにチャージする場所が示されます。残高に定期的に付与される金額はありません。ただし、請求画面で独自に月次支払いを設定すると、同じ残高に毎月チャージできます。無料の検出機能は引き続き利用できるため、エージェントは何が起きたのかを確認できます。

失敗した呼び出しにも料金が発生します。処理が実行されたためであり、回答にもその旨が示されます。サーバーが実行できなかった呼び出しには料金がかかりません。

呼び出しは行単位で確認できます。従量課金対象のすべての呼び出しは、プロジェクトのフィードパネルに表示されます。使用したツール、成功したかどうか、所要時間、消費した金額を確認でき、課金分類でフィルタリングできます。単一のプロジェクトを対象としない呼び出し（サーバーの説明、プロジェクトの一覧表示、プロジェクトの作成）はアカウントに属し、どのプロジェクトのフィードにも表示されません。検出呼び出しには行自体が残りません。

認証なしで公開ドキュメントサイトにリポジトリスコープでアクセスする場合、従量課金は発生しません。

トークンに許可されている操作#

Docsbook MCP サーバーへのアクセスは、階層ではなくトークンによって決まります。トークンにはスコープがあり、読み取りと書き込みを分けるのはこのスコープだけです。

読み取り専用 — すべてのレポート、検索、アウトラインツールは応答します。write_docs、create_issue、connect_source、configure_source、enable_agentおよび3つの書き込み用run_docs_*の実行は拒否され、その理由が示されます。現在スコープを確認するツールはこの8つです。設定、Webhook、目標、翻訳の書き込みツールはプロジェクトの所有権だけで制限されるため、読み取り専用は「何も変更できない」トークンではありません。詳しくはMCP サーバーのセキュリティを参照してください。
読み書き可能 — アカウントで実行できるすべての操作が可能です。ページのコミット、課題の登録、ソースの接続、エージェントの有効化、設定の変更などが含まれます。
トークンなし — リポジトリにスコープ設定されたエンドポイント（docsbook.io/{owner}/{repo}/api/mcp/server）では、get_info、find_skill、find_widget、list_content_widgetsは公開カタログから応答し、searchはそのサイト独自のドキュメントについて応答します。これはここでプロジェクトを読み取る唯一のツールですが、読み取る対象は公開済みサイトです。非公開サイト、プランの有効期限が切れたサイト、サイトに固定されていないエンドポイントでは拒否されます。また、プロジェクトのAI残高がなくなった場合も拒否されます。このツールはプロジェクト引数を受け取らないため、固定先のサイトだけを読み取ることができます。それ以外のすべてのツールには、Docsbookアカウントに紐付いた有効なBearerトークンが必要です。

呼び出しが拒否されると、サーバーは単なる403ではなく、理由を示す構造化エラーを返すため、エージェントは読者に何を修正すべきか伝えられます。認証フローとサーバーが保存する内容については、MCP サーバー — 信頼とセキュリティを参照してください。

MCPツールリファレンス — パラメーターを含むすべてのツール。
チャットフック — MCPを介してLLMの前後に実行するフックを設定します。
Docsスキル — find_skillを通じてSKILL.mdファイルを検出するか、run_docs_*で実行します。
Webhooks — MCPからイベントハンドラーを登録し、その署名を検証します。
料金 — 従量制の呼び出しで使用されるもの。リアルタイムの課金定数から生成されます。

Updated Sep 5, 2026