> For the complete documentation index, see [llms.txt](https://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.com/docs/documentation/ja-gitbook-documentation/getting-started/ai-documentation/gitbook-mcp.md).

# GitBook MCP

GitBook は、AI ツールが組織内のコンテンツを操作できる MCP サーバーを公開しています。

Claude Code、Codex、Cursor などのツールやその他の MCP クライアントは、これを使ってサイトの作成と設定、変更リクエストの作成、コンテンツの下書き、ページの編集、ドキュメントの再構成を行えます。

AI コーディングアシスタントを GitBook の MCP に接続するには、サーバー URL、認証方法、対応する MCP クライアントが必要です。以下の各セクションで順に説明します。

{% hint style="info" %}
公開済みのドキュメントサイト向けに読み取り専用の MCP サーバーが必要ですか？ GitBook が自動的に作成します — 詳しくは [公開済みドキュメント向け MCP サーバー](/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md) をご覧ください。
{% endhint %}

## GitBook の MCP エンドポイント

MCP クライアントを以下に向けてください：

```http
https://mcp.gitbook.com/mcp
```

{% hint style="info" %}
この URL をブラウザーで開くとエラーが返ります。HTTP リクエストを送信できる MCP クライアントで使用してください。
{% endhint %}

## クライアントを接続する

お好みのクライアントに GitBook MCP を追加します：

{% tabs %}
{% tab title="Claude Code" icon="claude" %}
ターミナルでサーバーを登録します：

```bash
claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp
```

その後、Claude Code を次のように起動します `claude` そして `/mcp` を実行して、ブラウザーでのサインインを完了します。

個人用アクセス トークンを使いたい場合は、認可ヘッダーとして渡します：

```bash
claude mcp add --transport http gitbook https://mcp.gitbook.com/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"
```

{% endtab %}

{% tab title="Codex" icon="openai" %}
ターミナルからサーバーを追加します：

```bash
codex mcp add gitbook --url https://mcp.gitbook.com/mcp
```

その後、ブラウザーでサインインします。

代わりに個人用アクセス トークンを使う場合は、次を `~/.codex/config.toml`:

```toml
[mcp_servers.gitbook]
url = "https://mcp.gitbook.com/mcp"
bearer_token_env_var = "GITBOOK_MCP_TOKEN"
enabled = true
```

{% endtab %}

{% tab title="Cursor" icon="cursor" %}
サーバーを `~/.cursor/mcp.json`に追加するか、プロジェクトの `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gitbook": {
      "url": "https://mcp.gitbook.com/mcp"
    }
  }
}
```

その後、Cursor の案内に従ってサインインします。
{% endtab %}

{% tab title="VS Code" icon="vscode" %}
サーバーを `.vscode/mcp.json` をワークスペース内に配置します：

```json
{
  "servers": {
    "gitbook": {
      "type": "http",
      "url": "https://mcp.gitbook.com/mcp"
    }
  }
}
```

その後、MCP ビューから起動してサインインします。
{% endtab %}

{% tab title="その他" %}
MCP 対応クライアントであれば、streamable HTTP 経由で接続できます。

以下に向けてください：

```
https://mcp.gitbook.com/mcp
```

GitBook は streamable HTTP のみに対応しています。 `stdio` と `SSE` はサポートされていません。

OAuth を使う場合、通常は追加の認証フィールドは不要です。

代わりに個人用アクセス トークンを使う場合は、ベアラートークンとして送信します：

```http
Authorization: Bearer <YOUR_PAT>
```

{% endtab %}
{% endtabs %}

## GitBook の MCP を認証する

GitBook MCP は、OAuth と個人用アクセス トークンの 2 つの認証方法をサポートしています。

{% tabs %}
{% tab title="OAuth" %}
クライアントを MCP サーバーの URL に向けます。クライアントが認可サーバーを検出し、自身を登録して、ブラウザーのサインインフローを自動的に開きます。

OAuth を使う場合、ベアラートークンを手動で追加しないでください。サインイン時にクライアントが取得します。
{% endtab %}

{% tab title="個人用アクセス トークン" %}
ブラウザーフローを省略するには、トークンをベアラートークンとして送信します：

```http
Authorization: Bearer <YOUR_PAT>
```

個人用アクセス トークンは、 [開発者設定](https://app.gitbook.com/account/developer).

で作成できます。これは、スクリプト化されたセットアップや、クライアントがすでにシークレットをローカルで管理している場合に使います。
{% endtab %}
{% endtabs %}

## GitBook の MCP の使い方

{% prompt description="Create and configure a new docs site." %}

```markdown
GitBook MCP ツールを使って、新しいドキュメントサイトの下書きを作成してください。

1. 何かを作成する前に、まず私の組織を一覧表示し、どれを使うか確認してください。
2. サイトの目的と、私が持っているコンテンツ（フォルダー、リポジトリ、または説明だけ）を尋ねてください。ソースを指定した場合は、内容が正しいか確認できるよう、見つけた内容をそのまま返してください。
3. サイト名、スペース、ページ構成の簡単な計画を見せて、私の承認を待ってください。
4. サイトを作成し、コンテンツを追加して公開してください。その後、公開 URL を取得して正常に動作することを確認し、私に共有してください。
```

{% endprompt %}

{% prompt description="Open a change request and draft content." %}

```markdown
GitBook MCP ツールを使って、変更リクエスト内でドキュメント用の新しいコンテンツの下書きを作成してください。ライブの内容は編集しないでください。

1. 私の組織とサイトを一覧表示し、作業するスペースを確認してください。
2. コンテンツで何を扱うべきかを聞いたうえで、変更リクエストを開き、その中でページの下書きを作成してください。
3. 既存ページのトーンと構成に合わせてください。まずいくつか読み取ってください。
4. 完了したら、私が GitBook で確認してマージできるよう、変更リクエストのプレビュー リンクを共有してください。
```

{% endprompt %}

{% prompt description="Move, rename, or restructure pages across a site." %}

```markdown
GitBook MCP ツールを使って、ドキュメントサイトの再構成を手伝ってください。

1. 私の組織とサイトを一覧表示し、対象を確認したら、現在の構成を取得して表示してください。
2. 何を変更したいかを尋ね、その後、変更後の新しい構成を簡単な変更前/変更後のツリーとして提案してください。承認するまで何も移動しないでください。
3. 可能な限り URL と内部リンクを維持しながら変更を適用してください。壊れるものがあれば示してください。
4. 最終構成と、確認用の変更リクエストまたはライブ結果を表示してください。
```

{% endprompt %}

## GitBook MCP と公開済みドキュメント MCP の違い

GitBook には 2 つの MCP パターンがあります：

* [**公開済みドキュメント向け MCP サーバー**](/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md) AI ツールに公開コンテンツへの読み取り専用アクセスを提供します。
* **GitBook MCP** は、GitBook API を通じて AI ツールにコンテンツとワークフローへのアクセスを提供します。

公開済みドキュメント MCP は、ドキュメントの閲覧者やエンドユーザーが公開済みドキュメントから情報を見つけられるようにしたい場合に使います。&#x20;

GitBook MCP は、チームのエージェントが自動化されたワークフローを通じてドキュメントを編集・管理したい場合に使います。

## FAQ

<details>

<summary>MCP クライアントを接続する際、GitBook MCP はどのトランスポートをサポートしていますか？</summary>

GitBook MCP は streamable HTTP をサポートしています。

GitBook MCP は `stdio` または `SSE`.

をサポートしていません。クライアントが追加フィールドを求める場合は、通常は空欄のままで構いません。

</details>

<details>

<summary>GitBook MCP にクライアントを接続するとき、ベアラートークンを追加する必要はありますか？</summary>

ベアラートークンを追加する必要があるのは、 [個人用アクセス トークン](https://app.gitbook.com/account/developer).

で認証する場合だけです。OAuth を使う場合は、ベアラートークンを手動で追加しないでください。サインインフロー中にクライアントが取得します。

</details>

<details>

<summary>GitBook MCP サーバーをクライアントに追加したのに何も起こらないのはなぜですか？</summary>

はい。一部の MCP クライアントではそれが想定どおりです。

サーバーを追加すると、設定を保存するだけの場合がよくあります。初回接続時、ツール一覧の取得時、または MCP パネルを開いたときにのみ認証を開始するクライアントもあります。

</details>

<details>

<summary>GitBook MCP の認証をクリックしても何も起こらないのはなぜですか？</summary>

一部のクライアントでは、短い遅延の後にブラウザーのサインインフローが開きます。

その遅延は、ネットワークが遅いか不安定な場合に長くなることがあります。

約 1 分たってもブラウザーのタブが開かない場合は、ネットワーク、ポップアップ設定、既定のブラウザーを確認してください。

</details>

<details>

<summary>GitBook MCP の認証フローでは何が起こりますか？</summary>

認証が機能すると、通常は次のような流れになります：

1. クライアントが MCP サーバーに接続します。
2. ブラウザーでサインインフローが開きます。
3. サインインしてアクセスを承認します。
4. クライアントにサーバーが接続済みとして表示されるか、MCP ツールが利用可能になります。

</details>

<details>

<summary>GitBook MCP でクライアントの認証が成功したかどうかはどう確認できますか？</summary>

正確なサインはクライアントによって異なりますが、結果は通常わかりやすいです。

ほとんどのクライアントでは、認証プロンプトが消え、サーバーが接続済みとして表示されるか、アシスタントが MCP ツールを一覧表示・呼び出しできるようになります。

もし **認証** ボタンが表示されたままで、ツールが何も表示されない場合、フローは完了していない可能性が高いです。

</details>

<details>

<summary>GitBook MCP の認証がまだ固まっているように見える場合、何を確認すればよいですか？</summary>

次を確認してください：

* サーバー URL が MCP エンドポイントを指していることを確認します。
* クライアントが HTTP トランスポートを使用していることを確認します。
* 安定したネットワークで再試行します。
* クライアントが失敗状態をキャッシュしている場合は、サーバーを削除して再追加します。

</details>


---

# 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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/ai-documentation/gitbook-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.