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

{% 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 がページアクションメニューに 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 authorization spec](https://modelcontextprotocol.io/docs/tutorials/security/authorization) 」をサポートする MCP クライアント（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 認証のために静的ヘッダーとして渡される訪問者認証トークンを使用するサイトをサポートしていません。


---

# 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.