# 公開ドキュメント用の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 をブラウザーで開くとエラーになります。代わりに、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 サーバーに接続** オプションを有効にできます。これにより、ドキュメントサイトの訪問者は、 [ページアクションメニュー](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 ツールのドキュメントを確認してください。