公開ドキュメント向けの MCP サーバー

公開された各 GitBook サイトには、外部ツールに接続できる MCP サーバーが含まれています

公開済みの GitBook サイトには、Model Context Protocol（MCP）サーバーが含まれています。

AI ツールはそれを使って、公開済みのドキュメントを直接読み取れます。これは Claude Desktop、Cursor、VS Code 拡張機能などのツールで利用できます。

MCP サーバーは、公開済みサイトの URL に次を追加した場所にあります /~gitbook/mcp.

たとえば、GitBook のドキュメントは次の場所にあります https://gitbook.com/docs。その MCP サーバーは https://gitbook.com/docs/~gitbook/mcp.

この URL をブラウザで開くと、エラーが表示されます。AI アシスタントや IDE など、HTTP リクエストを送信できるツールで使用してください。

AI ツールを接続する

ページ操作 MCP サーバーを機能させるには有効にする必要があります。オフにすると サイトのカスタマイズ → ページ操作、GitBook は ~gitbook/mcp を無効にし、エンドポイントは 404. MCP サーバーに接続する ページ操作メニューに MCP リンクが表示されるかどうかのみを制御します。

1

MCP サーバーの URL を見つける

公開済みの GitBook サイト URL を使います。次に /~gitbook/mcp.

2

AI ツールを設定する

ツールの MCP 設定を開きます。次にサーバー URL を入力します。

ツールごとにセットアップ方法は異なります。正確な手順はツールのドキュメントを確認してください。

3

ドキュメントの利用を始める

接続すると、ツールはドキュメントの検索、ページの表示、コンテンツに基づく質問への回答ができるようになります。

要件

MCP サーバーを使用するには：

• サイトは公開されている必要があります。MCP サーバーは公開済みコンテンツのみを公開します。

• ページ操作 で有効になっている必要があります サイトのカスタマイズ → ページ操作.

• ツールは HTTP 経由の MCP をサポートしている必要があります。

• サイトで認証済みアクセスが使用されている場合、MCP サーバーは同じアクセスルールを使用します。

• サイトで共有リンクを使用している場合は、共有リンクのサイト URL を使用し、その後に /~gitbook/mcp.

• GitBook は HTTP トランスポートのみをサポートしています。 stdio および SSE はサポートされていません。

サイトに MCP リンクを追加する

で サイトのカスタマイズ、を開きます ページ操作。確認してください ページ操作 がオンになっていることを確認してから、 MCP サーバーに接続する.

もし ページ操作 がオフの場合、GitBook は ~gitbook/mcp を無効にし、エンドポイントは 404.

MCP サーバーに接続する は、GitBook がページ操作メニューに MCP サーバーリンクを表示するかどうかのみを制御します。

その後、訪問者はページ操作メニューからサーバー URL をコピーできます。

プライバシーとアクセス

MCP サーバーは、公開済みのドキュメントへの読み取り専用アクセスを提供します。

非表示ページは MCP 経由でも引き続き利用できます。ページを非表示にしても、公開済みの目次から削除されるだけです。

アカウントデータ、分析データ、または GitBook の内部データが公開されることはありません。

提供されるのは最新の公開版のみです。下書きや未公開の変更は非公開のままです。

トラブルシューティング

ツールが接続できない場合:

• 公開済みサイトにアクセスできることを確認してください。

• URL が次で終わっていることを確認してください /~gitbook/mcp.

• サイトで認証が使用されている場合は、次をサポートするクライアントを使用してください MCP 認証仕様.

• ツールが必要とする場合 stdio または SSE、GitBook では動作しません。

認証済みサイトで MCP を使用する

GitBook サイトが 認証済みアクセスを使用している場合、 /~gitbook/mcp の MCP サーバーは同じ認証を使用します。MCP クライアントのうち MCP 認証仕様 — Claude と Claude Code を含む — は、OAuth と Dynamic Client Registration（DCR）を使用してサーバーに自動接続できます。

代わりにサイトが共有リンクを使用している場合でも、MCP は動作します。完全な共有リンクのサイト URL を使用し、その後に /~gitbook/mcp.

GitBook は、共有リンクのみのサイトや、ビジター認証トークンを静的ヘッダーとして渡すサイトを MCP 認証ではサポートしていません。

サイトが 認証済みアクセスを使用している場合、MCP サーバーは同じアクセスルールを使用します。公開サイトは公開のままです。保護されたサイトでは同じサインインが必要です。

Claude を含むサポートされている MCP クライアントは、接続のために MCP 認証仕様 に従います。

1

OAuth サーバーを検出する

MCP ハンドシェイク中、クライアントはサイトの OAuth サーバーを検出します。

2

DCR でクライアントを登録する

クライアントは Dynamic Client Registration を使用して OAuth クライアントを登録します。

クライアント ID を手動で作成する必要はありません。

3

サイトの認証プロバイダーでサインインする

クライアントはサイトの認証プロバイダーへリダイレクトします。

ドキュメントサイトで既に使っているのと同じプロバイダーでサインインします。

4

コードをトークンと交換する

サインイン後、クライアントは認可コードをアクセストークンに交換します。

5

トークンを再利用する

クライアントは、そのトークンを有効期限が切れるまで後続の MCP リクエストに付与します。

このフローは次の認証済みアクセスバックエンドで機能します：

• Auth0

• Azure AD

• Okta

• AWS Cognito

• OIDC

• カスタムバックエンド 設定されたフォールバック URL 付き

MCP 認証は、リクエストヘッダー内の静的なビジター認証トークンのみに依存するサイトをサポートしていません。

代わりに、上記のいずれかの認証済みアクセスバックエンドを使用してください。

これを設定するには、まず 認証済みアクセス および 認証済みアクセスを有効にする.