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

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

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

{% hint style="info" %}
**ページ操作** を有効にする必要があります。もし **サイトのカスタマイズ** → **ページ操作**をオフにすると、GitBook は `~gitbook/mcp` を無効にし、エンドポイントは `404`. **MCP サーバーに接続する** を表示するかどうかだけを制御します。
{% endhint %}

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

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

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

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

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

{% step %}
**ドキュメントを使い始める**

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

### 要件

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

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

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

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

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

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

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

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

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

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

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

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

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

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

* 公開サイトにアクセスできることを確認してください。
* URL の末尾が次になっていることを確認してください `/~gitbook/mcp`.
* サイトで認証が必要な場合は、MCP 認可をサポートするクライアントを使用してください。
* ツールが次を必要とする場合 `stdio` または `SSE`、GitBook では動作しません。

### 認証付きサイトで MCP を使う

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

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

**仕組み**

サポートされている MCP クライアントが、認証付きサイトの MCP サーバーに接続すると、次の処理が行われます：

1. MCP ハンドシェイクを通じて OAuth サーバーを検出する
2. OAuth クライアントを動的に登録する（手動のクライアント ID 設定は不要）
3. サインインするためにサイトの上流認証プロバイダーへリダイレクトする
4. 認証コードをアクセストークンと交換し、その後のすべてのリクエストのためにローカルに保存する

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

**要件**

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

* Auth0、Azure AD、Okta、AWS Cognito、またはネイティブ統合による OIDC
* Fallback URL が設定されたカスタムバックエンド

GitBook は、MCP 認証のために visitor auth token を静的ヘッダーとして渡すサイトはサポートしていません。


---

# Agent Instructions: 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.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.