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

公開されたすべての GitBook サイトには、自動的に Model Context Protocol（MCP）サーバーが含まれます。&#x20;

これにより、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 をブラウザで訪れるとエラーになります。代わりに、LLM や IDE など HTTP リクエストを行えるツールと共有してください。
{% endhint %}

### AI アシスタントを接続する

{% stepper %}
{% step %}

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

公開された GitBook サイトの URL を取得し、末尾に `/~gitbook/mcp` を追加します。
{% endstep %}

{% step %}

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

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

{% step %}

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

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

### 要件

MCP サーバーを機能させるには、GitBook サイトが公開されている必要があります。サーバーは公開コンテンツにのみアクセスを提供し、下書きや未公開の変更にはアクセスしません。

AI ツールは Model Context Protocol をサポートし、サイトへの HTTP リクエストを行える必要があります。MCP をサポートするほとんどの最新の AI アシスタントは GitBook のサーバーで動作します。

MCP サーバーはサイトの可視性設定を尊重します。サイトが公開されている場合、MCP サーバーも公開アクセス可能です。サイトが認証を必要とする場合、MCP サーバーも認証を必要とします。

MCP サーバーは HTTP トランスポートのみを使用します。stdio や SSE トランスポートを必要とするツールはサポートされません。

### 簡易 MCP リンクの有効化または無効化

で、 **ページアクション** あなたの [カスタマイズ](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/customization) 設定のセクションで、 **MCP サーバーに接続** オプションを有効にできます。これにより、ドキュメントサイトの訪問者がページアクションからサイトの MCP サーバーへのリンクを素早くコピーできるようになります。 [ページアクションメニュー](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/customization/extra-configuration#page-actions).

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

MCP サーバーは公開されたドキュメントへの読み取り専用アクセスのみを提供します。ユーザーデータ、分析情報、内部の GitBook 情報は公開しません。

MCP サーバーを通じて利用できるのは、最新の公開バージョンのコンテンツのみです。下書きコンテンツや未公開の変更は、公開されるまで非公開のままです。

### 一般的な問題

AI アシスタントが MCP サーバーに接続できない場合は、まず GitBook サイトが公開されアクセス可能であることを確認してください。ブラウザで訪れたときに URL が応答するはずです。

末尾に `/~gitbook/mcp` が付いている正しい URL 形式を使用していることを確認してください。URL は公開サイトを訪問したときに表示されるものと完全に一致する必要があります。

一部の AI ツールは特定のトランスポート方式を要求したり、特有の MCP 構成要件がある場合があります。MCP 設定手順については使用する AI ツールのドキュメントを確認してください。
