> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md).

# 公開ドキュメント向け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`.

このエンドポイントは、公開サイト、公開済みコンテンツがすべて公開されている共有リンクサイト、および完全認証済みサイトで使用します。

完全認証済みサイトでは、MCP クライアントはツールにアクセスする前に、MCP のディスカバリーと OAuth フローを通じて認証します。詳細は次を参照してください。 [MCP 認可フロー](https://modelcontextprotocol.io/docs/tutorials/security/authorization#the-authorization-flow-step-by-step).

サイトが部分認証で、なおかつ公開コンテンツまたは共有リンクコンテンツを公開している場合は、 `/~gitbook/mcp/auth` の代わりに使用します。たとえば、 `https://gitbook.com/docs/~gitbook/mcp/auth`.

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

### AI ツールを接続する

{% stepper %}
{% step %}

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

公開済みの GitBook サイトの URL に、サイトに一致するエンドポイントを追加します。

* 使用する `/~gitbook/mcp` 公開サイト、公開済みコンテンツがすべて公開されている共有リンクサイト、または MCP のディスカバリーと OAuth を使用する完全認証済みサイトの場合。
* 使用する `/~gitbook/mcp/auth` サイトが部分認証で、なおかつ公開コンテンツまたは共有リンクコンテンツを公開している場合。
  {% endstep %}

{% step %}

#### AI ツールを設定する

MCP サーバーの URL を AI アシスタントの設定に追加します。各ツールで設定手順は少し異なるため、選んだツールのドキュメントを確認して、MCP サーバーの設定方法を見てください。
{% endstep %}

{% step %}

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

接続すると、AI アシスタントはドキュメント内を検索し、特定のページを取得し、あなたのコンテンツを使って質問に答えられます。アシスタントは公開済みドキュメントにリアルタイムでアクセスできます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**ページアクション** を有効にする必要があります。これをオフにすると、MCP サーバーは動作しません。 **サイトのカスタマイズ** → **ページアクション**をオフにすると、GitBook は `~gitbook/mcp` を無効化し、エンドポイントは `404`. **MCP サーバーに接続する** は、MCP リンクがページアクションメニューに表示されるかどうかのみを制御します。
{% endhint %}

{% stepper %}
{% step %}
**MCP サーバーの URL を見つける**

公開済みの GitBook サイトの URL を取得します。次に、次を追加します `/~gitbook/mcp`.
{% endstep %}

{% step %}
**AI ツールを設定する**

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

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

{% step %}
**ドキュメントの利用を始める**

接続すると、そのツールはドキュメントを検索し、ページを開き、あなたのコンテンツを使って質問に答えられます。
{% endstep %}
{% endstepper %}

### 要件

MCP サーバーは、サイトの表示設定に従います。次を使用してください `/~gitbook/mcp` 公開サイト、公開済みコンテンツがすべて公開されている共有リンクサイト、または MCP のディスカバリーと OAuth を使用する完全認証済みサイトの場合。次を使用してください `/~gitbook/mcp/auth` サイトが部分認証で、なおかつ公開コンテンツまたは共有リンクコンテンツを公開している場合。

次の **ページアクション** のセクションで [カスタマイズ](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/customization.md) 設定で、次を有効にできます **MCP サーバーに接続する** オプション。これにより、ドキュメントサイトの訪問者は、サイトの MCP サーバーへのリンクをすぐにコピーできるようになります。 [ページアクションメニュー](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/customization/extra-configuration.md#page-actions).

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

* サイトは公開済みである必要があります。MCP サーバーは公開済みコンテンツのみを公開します。
* **ページアクション** は次で有効になっている必要があります **サイトのカスタマイズ** → **ページアクション**.
* 使用するツールは HTTP 経由の MCP をサポートしている必要があります。
* サイトで認証済みアクセスを使用している場合、MCP サーバーは同じアクセスルールを使用します。
* サイトで共有リンクを使用している場合は、共有リンクサイトの URL を使用してから、次を追加します `/~gitbook/mcp`.
* GitBook は HTTP トランスポートのみをサポートしています。 `stdio` と `SSE` はサポートされていません。

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

次で [サイトのカスタマイズ](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/customization.md)、開く [ページアクション](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/customization/extra-configuration.md#page-actions)。次を確認してください **ページアクション** がオンになっていること。次に、 **MCP サーバーに接続する**.

もし **ページアクション** がオフになっていると、GitBook は `~gitbook/mcp` を無効化し、エンドポイントは `404`.

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

訪問者はその後、ページアクションメニューからサーバー URL をコピーできます。

### プライバシーとアクセス

正しい URL 形式を使用していることを確認してください。次を使用してください `/~gitbook/mcp` 公開サイト、公開済みコンテンツがすべて公開されている共有リンクサイト、または MCP のディスカバリーと OAuth を使用する完全認証済みサイトの場合。次を使用してください `/~gitbook/mcp/auth` 公開コンテンツまたは共有リンクコンテンツを含む部分認証サイトの場合。

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

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

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

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

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

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

* 公開済みサイトにアクセスできることを確認してください。
* URL の末尾が次で終わっていることを確認してください `/~gitbook/mcp`.
* サイトで認証を使用している場合は、次をサポートするクライアントを使用してください [MCP 認可仕様](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
* ツールが次を必要とする場合 `stdio` または `SSE`、GitBook では動作しません。

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

GitBook サイトで次を使用している場合  [認証済みアクセス](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access.md)、次にある MCP サーバーは `/~gitbook/mcp` 同じ認証を使用します。次をサポートする MCP クライアントは [MCP 認可仕様](https://modelcontextprotocol.io/docs/tutorials/security/authorization) — Claude と Claude Code を含む — OAuth と Dynamic Client Registration（DCR）を使用して自動的にサーバーへ接続できます。

代わりにサイトで共有リンクを使用している場合でも、MCP は引き続き機能します。共有リンクサイトの完全な URL を使用してから、次を追加します `/~gitbook/mcp`.

GitBook は、共有リンクのみのサイトや、MCP 認証で静的ヘッダーとして渡される visitor auth token を使用するサイトをサポートしていません。

サイトで次を使用している場合 [認証済みアクセス](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access.md)、MCP サーバーは同じアクセスルールを使用します。公開サイトは公開されたままです。保護されたサイトでは同じサインインが必要です。

Claude を含む対応 MCP クライアントは、次に従います [MCP 認可仕様](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization) に接続します。

{% stepper %}
{% step %}

#### OAuth サーバーを検出する

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

{% step %}

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

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

client ID を手動で作成する必要はありません。
{% endstep %}

{% step %}

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

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

ドキュメントサイトですでに使用しているのと同じプロバイダーでサインインします。
{% endstep %}

{% step %}

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

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

{% step %}

#### トークンを再利用する

クライアントは、そのトークンを有効期限が切れるまで後続の MCP リクエストに付けて送信します。
{% endstep %}
{% endstepper %}

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

* [Auth0](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-auth0.md)
* [Azure AD](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-azure-ad.md)
* [Okta](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-okta.md)
* [AWS Cognito](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-aws-cognito.md)
* [OIDC](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-oidc.md)
* [カスタムバックエンド](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/setting-up-a-custom-backend.md) Fallback URL が設定されているもの

{% hint style="warning" %}
MCP 認証は、リクエストヘッダー内の静的な visitor auth token のみに依存するサイトをサポートしていません。

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

これを設定するには、まず次から始めます [認証済みアクセス](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access.md) と [認証済みアクセスを有効にする](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/saitohenoakusesu/authenticated-access/enabling-authenticated-access.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.