公開ドキュメント向け 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 ツールを接続する

1

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

公開された GitBook サイトの URL を取得します。次に、以下を追加します /~gitbook/mcp.

2

AI ツールを設定する

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

設定方法はツールごとに異なります。正確な手順については、お使いのツールのドキュメントを確認してください。

3

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

接続されると、ツールはドキュメントを検索したり、ページを開いたり、コンテンツに基づいて質問に答えたりできます。

要件

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

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

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

• サイトで認証を使用している場合、MCP サーバーも同じアクセスルールを使用する必要があります。

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

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

「 サイトのカスタマイズ」で、「 ページアクション 」セクションを開きます。次に、「 MCP サーバーで接続.

」をオンにします。すると、訪問者はページアクションメニューからサーバー URL をコピーできます。

プライバシーとアクセス

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 クライアントが、認証付きサイトの MCP サーバーに接続すると、次のことを行います：

1. MCP ハンドシェイクを通じて OAuth サーバーを検出する

2. OAuth クライアントを動的に登録する（クライアント ID を手動で設定する必要はありません）

3. サイトの上流認証プロバイダーへリダイレクトしてサインインする

4. 認可コードをアクセス トークンと交換し、それ以降のすべてのリクエストのためにローカルに保存する

GitBook は初回接続時に認証を求めます。その後、クライアントはトークンの有効期限が切れるまでそれを再利用します。

要件

このフローを機能させるには、サイトが GitBook でサポートされている次の認証バックエンドのいずれかを使用している必要があります：

• ネイティブ統合経由の Auth0、Azure AD、Okta、AWS Cognito、または OIDC

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

GitBook は、共有リンク専用サイトや、MCP 認証のために静的ヘッダーとして渡される訪問者認証トークンを使用するサイトをサポートしていません。