MCP サーバー

Docsbook MCP サーバーは、ドキュメントとその管理機能全体を AI エージェントに公開するリモートの Model Context Protocol サーバーです。Claude Code または MCP 対応クライアントを 1 つのエンドポイントに接続すれば、エディターを離れることなく、ページの読み取り、変更のコミット、分析データの確認、設定の変更を行えます。

このページでは、サーバーが提供する内容と、各呼び出しで参照される情報について説明します。ここに記載されているすべてのツールは、接続されたクライアントから呼び出すことができます。従量課金される呼び出しの料金はDocsbook の料金ページと、管理パネルの各ツールの行に記載されています。

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

Docsbook MCP サーバーは、Model Context Protocol 経由で156 個のツールを公開します。Model Context Protocol は、型付き RPC インターフェースを介して AI エージェントにツール、リソース、プロンプトを渡すためのオープン標準です。

そのうちエージェントは正確に 1 つだけです。 docsbook_expert は、「ドキュメントを改善して」「この API をドキュメント化して」「なぜ読者がコンバージョンしないのか」といったドキュメントに関する依頼をあなた自身の言葉で受け取り、どのように作業すべきかを 1 回の往復で回答します。回答には、手順の順序、各手順で呼び出すツール、次の手順へ引き継ぐもの、どのような場合に回答が誤りになるか、そして後で覚えておくべきことが含まれます。これは自分で何も実行せず、承認も必要としません。示された呼び出しを、あなた自身のトークンで、読み取り料金で実行します。まずこれを呼び出してから、以下のものに進んでください。

その他のツールはすべて、ワークスペースとブランディング、コンテンツ、課題トラッカー、AI チャット、翻訳、分析、呼び出し履歴、プロジェクトメモリ、リマインダー、仮説、作業ボード、Webhook のための、個別に名前が付けられた単純な呼び出しです。その中には、リポジトリまたはウェブサイトを信頼できる情報源として接続・設定する 2 つのツールと、回答エンジンがあなたの情報を取得して引用できるかどうかを評価する collect_ai_citability も含まれます。これらのツールはいずれも自動実行されません。独自のスケジュールやリポジトリのコミットをトリガーに実行される常駐エージェントと、その内部でのみ実行されていた 135 個のより特化したツールは、docsbook_expert が置き換えた理由により、2026-09-12 に廃止されました。そこに価値があったのは実行そのものではなく、どの読み取りをどの順序で行うか、そして何が回答を誤りにするかを把握することでした。これは実行するものではなく、伝えるべきものです。全リストについてはMCP ツールのリファレンスを参照してください。

エンドポイント#

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

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

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

AIクライアントをDocsbookに接続するには？#

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

自分のプロジェクト内でカタログを閲覧することもできます。管理パネルを開き、サイドバーでMCPを選択してください。初めて開くと、そのセクションにクライアント用のインストールコマンドを表示した有効化パネルが表示されるため、カタログを読む前に接続できます。また、これを押すと、テーブル上で短いガイドが実行されます。その背後には、現在サーバーが提供しているすべてのツールのテーブルがあります。これは書き留められたコピーではなく、サーバーからライブで読み込まれたもので、各ツールの請求区分、呼び出しごとの料金、通常呼び出しが継続する時間、トークンなしで読者が呼び出せるかどうかを確認できます。検索したり、フィルターで絞り込んだりできます。フィルターには各請求区分がそれぞれの料金とともに表示されます。また、任意の列で並べ替えることもできます。行にカーソルを合わせると、そのツールについて知っておくべき残りの情報をまとめたカードが開きます。そこには、ツールの機能、呼び出しにかかる料金と通常の継続時間、受け取る引数の数と必須の引数の数、それを呼び出す動作例の数が表示されます。さらに自分のプロジェクトでは、これまでにかかった費用と最後に呼び出した日時、コピーできる状態の呼び出し可能なIDも確認できます。行をクリックすると、そのツール専用のページが開きます。このページにはアドレスがあり、URLにツールが含まれるため、更新、ブックマーク、同僚への送信が可能です。同僚は300行のテーブルに戻されるのではなく、同じツールのページを開けます。ページの内容はすべて、その1つのツールに関するものです。引数は実行ボタン付きのフォームになっており、このプロジェクトに対して実際の呼び出しを行います。料金が表示された状態でボタンを押せるため、支払いが発生する前に価格を確認できます。その下には呼び出し履歴があり、これは他の場所で確認できるものと同じフィードテーブルから取得され、このツールだけに絞り込まれています。呼び出し1件につき1行が表示され、行を展開すると呼び出しの全内容が確認できます。入力された内容、返された内容、誰が要求したか（自分のクライアント、外部エージェント、Webhook配信）、所要時間、設定された料金、実際に残高から引き落とされた額が表示されます。その下には、自分のクライアントにコピーできる動作例が1つあります。Docsbook内から実行されるものは、あなたまたはエージェントが行う呼び出しです。このページ内の何かが自動的に呼び出すわけではありません。

Claude Code#

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

最初の呼び出しで、OAuth用のブラウザタブが開きます。同意すると、Claude Code内でツールを使用できるようになります。

Cursor#

Cursor には 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"
    }
  }
}

Cursor を再読み込みすると、初回使用時にブラウザで 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"

Windsurf#

~/.codeium/windsurf/mcp_config.jsonを編集し、Cascadeパネルを更新します：

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

Cline#

Cline → MCP Servers → Configure MCP Serversを開き、次を貼り付けます：

{
  "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 ピッカーからサーバーを有効にします（キーは mcpServers ではなく servers であることに注意してください）。

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

ChatGPT#

ChatGPTは、ChatGPT独自の有料プランでコネクタを通じたリモートMCPをサポートしています。この要件はDocsbookではなく、OpenAIによるものです。

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

Docsbook MCP ツールは何のためにあるのか#

Docsbook MCP ツールは、次の4つのいずれかを実現するために存在します。より適格な読者を呼び込み、そのうちより多くの読者に目的の情報を持ち帰ってもらい、購入意欲のある読者をアシスタントが次の段階へ進め、担当者に届く質問を減らすことです。以下では、それぞれの目的に沿って分類しています。

ドキュメントはコストセンターではありません。ドキュメントには3つの役割があります。見つけてもらう（Googleだけでなく、現在では購入者がGoogleの代わりに質問するAIアシスタントにも）、読者をコンバージョンさせる（何も得られないまま終わる訪問は、苦情すら言わずに失われる顧客です）、そして何が機能したかを証明する（次の編集を推測ではなく意思決定にするため）ことです。

ドキュメントツールが収益を生み出す方法は4つしかなく、以下のすべてのツールはそのいずれかに貢献します。

これらのいずれにも貢献しないツールがもたらすのは、意思決定ではなくコンテキストです。Pageviews: 12,340 はコンテキストです。31% of your readers left with nothing は意思決定です。

見つけてもらう#

購入者はますます、ベンダーに問い合わせる前にアシスタントに尋ねるようになっています。アシスタントが競合他社のドキュメントをもとに回答すれば、あなたは候補リストに入ることすらなく、その損失がダッシュボードに表示されることもありません。

読者を迷わせない#

get_visit_outcomes はプロダクト全体の主要指標です。すべての訪問を成功 / 行き止まり / 直帰 / 部分的成功に分類し、行き止まり率とセルフサービス解決率を報告します。行き止まりとは、読者が検索したり、AI に尋ねたり、複数のページを開いたりしたにもかかわらず、何も得られないまま離脱することです。以下のすべては、「…それで、具体的にどこで？」という問いに答えるものです。

対応できていない需要#

ここにある各行は、1ページを書くだけで先回りして解決できるサポートチケットです。

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

チャットはサポートウィジェットではありません。見込み客が異議を平易な言葉で述べる唯一の場所です。

ドキュメントのチャットで示された価格に関する異議は、ページビューよりも価値があります。読者自身が見込み客として条件を満たし、購入を妨げているものを正確に伝えてくれたからです。

発見事項に対応する#

修正のない診断は、ただの報告です。これらのツールは、1つの接続内で対応を完了させます。

見なくても把握できる#

ダッシュボードは誰かが開いたときにしか機能しません。Webhookは常に機能します。Webhookの登録には1回の書き込み呼び出しが必要で、その後の各配信はDocsbookネットワークからの送信呼び出しになります。

リーチと所有権#

成果を生む組み合わせ#

上記の単独のツールがプロダクトなのではありません。プロダクトなのは、これらのループです。

ループ 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
list_tool_calls         → 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?
compare_tool_calls      → …and for a change that was not a commit, the same
                          reading before and after

率だけでは行動につなげられず、ページ一覧だけでは原因がわからず、list_tool_callsなしの修正では、失敗した編集を確信を持って繰り返すことになります。最後のステップがループを完結させます。サイト全体のトレンドラインは十数個の理由で変動するため、「コミット後に率が改善した」というのは、編集したページが何もしなかったページよりも改善した場合にのみ証拠となります。この一連の流れによって初めて、変化を説明できるようになります。

ループ 2 — 「ナビゲーションは読者に嘘をついているか？」#

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, and this reading is
                                also the baseline for next week
         list_tool_calls     → 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
         compare_tool_calls  → next week, this week's reading against
                                last week's, on the same pages

自らを修復し、その作業内容を示すドキュメント — 接続を切断することなく、「問題を確認した」そして「問題を修正した」。

プロンプトライブラリ#

上記の各レバーにつき1つのリクエストを、実際に入力する言葉でまとめています — OAuthの完了後、これらをClaude Code、Cursor、または別の接続済みクライアントに貼り付けてください:

• 獲得: 「AIアシスタントは実際に私たちのドキュメントを読んでいるのか、そして自社のクイックスタートはGoogleで何位なのか？」 → get_analytics (AIボットの内訳), get_search_rankings
• コンバージョン: 「どのページで読者が離脱していて、その理由は何か？」 → get_visit_outcomes, get_dead_end_pages, get_rage_signals
• 営業: 「誰かが競合他社と私たちを比較していたチャットの会話をすべて抽出して。」 → get_chat_intent
• 回避できたコスト: 「ドキュメントアシスタントに、答えられずに人々が尋ねていることは何か？」 → get_ai_unanswered, get_failed_searches

docsbook_expert は、まずこれらの質問それぞれに対して完全なルートを順番どおりに返します。上記で名前を挙げたツールは、最終的に呼び出されるものです。

作業全体を引き渡す#

ここにあるすべてのツールは、それを求めた呼び出しの中で回答します。開始すべきジョブも、状態を確認するためにポーリングすべき実行もありません。

以前は4つありました — run_docs_analyze、run_docs_create、run_docs_manage、run_docs_automate — これらは、こちら側であなたのワークスペースに対してスキルを実行し、ポーリング用の実行IDを返していました。これらは、get_agent_run、list_agent_runs、cancel_agent_run とともになくなりました。サイトの監査、構築、再構成、監視の立ち上げには今でも数分かかりますが、それはあなた自身のエージェントがすでにリポジトリを保持して行っている作業であり、監視できない実行にその時間を費やすのは、より悪い方法です。

それらに代わるのが docsbook_expert です。このサーバー上で唯一のエージェントであり、実行するのではなく助言します。あなた自身の言葉で尋ねると、その依頼についてどう考えるべきか、各手順で使うツールを含む順序立てた手順、各手順を誰が実行するのか、手順間で何を引き継ぐのか、何が回答を誤らせるのか、何を覚えておく価値があるのかを回答します。また、その前に読むべき2つの内容も示します。つまり、このドキュメントが機能しているとみなす条件としてあなたが宣言したことと、読者が実際に求めたことです。これらを踏まえない助言は、ドキュメント全般については正しくても、あなたのサイトについては反証不能だからです。その後はあなたのエージェントが、あなたのトークンを使い、読み取り料金で作業を行います。ルートではなくルールブック全体が必要な場合でも、find_skill が長形式の方法を引き続き引き渡します。

意見を抜きに証拠を買う#

監査は1回の呼び出しで7つのことを行います。収集し、正規化し、解釈し、判定し、スコアを付け、順位付けし、推奨します。最初の2つを2回実行すれば同じ答えになり、誰でも手作業でやり直して確認できます。judge以降の答えはモデルのものです。以前は両方の部分が1回のエージェント実行としてまとめて課金されていたため、検証できる部分が、信頼するしかない部分と同じ価格で販売されていました。

5つのコレクターは、それだけで前半部分を担い、エージェント実行ではなくprobeとして課金されます。

処理経路にモデルは存在しないため、信じられないものは何もありません。そして、そのことは主張ではなくペイロードによって証明されます。すべての回答にはreproduceブロックが含まれます。各行について、正確なMCP呼び出しと、それに渡された引数が記録されています。自分で実行すれば、タイムスタンプ以外は同じレコードが返ります。監査が返すものにはそれができません。監査の回答はモデルを通過しているからです。

得られないのは判定です。所見も、スコアも、順位も、推奨もありません。ひそかにそのいずれかを含めるコレクターは、価格を大幅に下げたモデル実行になってしまいます。判定については、行の読み方をdocsbook_expertに尋ねてください。読み方と、その解釈を誤らせる要因を方法とともに回答します。

安いほうが正しい選択になるとき。 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（read-writeスコープで承認されたトークンが必要。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 万ページのサイトでも同じ金額が差し引かれます。金額を決めるのは、呼び出しを処理するためにサーバーが行う作業です。

⚡ エージェント分類内のツールごとの価格設定は、アクションファミリーとともに廃止されました。 135 個あった当時は、それぞれが宣言した作業 — 読み取る証拠の種類がいくつあるか、モデルとの往復が何回発生する可能性があるか、サイト外に出るかどうか — に基づいて価格が設定されていたため、範囲の狭い観測は深い下書きの一部の料金で済みました。この分類に残っているものは料金帯全体にまたがるため、料金帯単位で価格設定されます。

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

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

どのプロジェクトが支払うかは、呼び出し自体から判断されます。指定したワークスペースや、そのスコープが設定されているリポジトリに基づき、所有しているプロジェクトだけが対象になります。プロジェクトを指定しない呼び出しは、メーター対象外で処理されます。その後 AI 作業を行うツールでは、その作業についても料金が差し引かれます。2 つの料金は置き換わるのではなく、加算されます。

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

失敗した呼び出しも課金されます。作業自体は実行され、回答にもその旨が示されます。サーバーがまったく実行できなかった呼び出しには課金されません。

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

認証されていない、リポジトリをスコープとする公開ドキュメントサイトへのアクセスには、料金が一切かかりません。

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

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

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

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

トラブルシューティング / FAQ#

agents/MCP ツールはまだ動作していますか？ はい。2026-09-12 に、以前の資料で説明されていたスタンディングエージェントエンジン（自律的に実行されるスケジュール済みエージェントと、その内部でのみ実行されていた 135 個のアクションツールおよび 4 個の run_docs_* ランナー）は廃止されました。残っているエージェントは docsbook_expert の 1 つで、常時実行されるのではなく、1 回のラウンドトリップで助言を行います。このページに記載されているすべての接続とその他のツールは、上記の説明どおりに動作します。

クライアントにはまだ docsbook と表示され、docsbook_expert ではありません。接続が切れたのでしょうか？ いいえ。MCP クライアントは接続時に一度だけツール一覧を読み取り、そのセッションの残りの期間はそれらの名前を保持します。サーバーは古い名前を拒否せずに解決するため、何も壊れていません。現在の名前を確認するには、クライアントを再接続してください。

残高が空のため呼び出しが拒否されました。何が起きたのでしょうか？ 拒否メッセージには、プロジェクト名、呼び出しで消費されるもの、残っているものが示されます。再接続や再試行では解決しません。パネルからプロジェクトの残高を追加してください。検出用の呼び出し（get_info、find_skill、ワークスペースの一覧表示と作成）は使用量を計上されず、残高に関係なく引き続き機能します。

残高以外の理由で呼び出しが拒否された場合は、どこに問い合わせればよいですか？ サーバーは理由を示す構造化エラーを返します。読み取り専用トークンにスコープがない場合、Docsbook 自身の認証情報でご自身の GitHub アカウント内のリポジトリにアクセスできない場合の NO_GITHUB_ACCESS、または非公開サイトの場合などです。各トークンスコープで可能な操作と不可能な操作については、MCP サーバーのセキュリティを参照してください。

関連#

• MCPツールリファレンス — すべてのツールとそのパラメーター。
• チャットフック — MCP経由でLLMの前後に実行するフックを設定します。
• Docsスキル — find_skill を通じてSKILL.mdファイルを検出するか、docsbook_expert にその中を通るためのルートを尋ねます。
• Webhook — MCPからイベントハンドラーを登録し、その署名を検証します。
• 料金 — 従量課金の呼び出しが何を消費するかを、最新の請求定数から生成したものです。