> 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/docs-as-code/gitbook-mcp.md).

# GitBook MCP

AI コーディングアシスタントを GitBook に接続し、GitBook の API を通じてサイトの作成、変更リクエストの作成、コンテンツの編集ができるようにします

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

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

<p align="center">公式プラグインをインストールしてください:</p>

<p align="center"><a href="https://claude.ai/directory/connectors/gitbook-mcp" class="button secondary" data-icon="claude">Claude プラグインをインストール</a> <a href="https://chatgpt.com/apps/gitbook/asdk_app_6a576f075ec4819196c203b7049542be" class="button secondary" data-icon="openai">ChatGPT プラグインをインストール</a> <a href="https://cursor.com/marketplace/gitbook" class="button secondary" data-icon="cursor">Cursor プラグインをインストール</a></p>

{% hint style="info" %}
公開済みドキュメントサイト用の読み取り専用MCPサーバーが必要ですか？GitBookが自動的に作成します。詳しくは、 [公開済みドキュメント用のMCPサーバー](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/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" icon="claude" %}
Claude 用の公式 GitBook プラグインをインストールしてください:

<a href="https://claude.ai/directory/connectors/gitbook-mcp" class="button secondary" data-icon="claude">Claude プラグインをインストール</a>

または、ターミナルからサーバーを追加してください:

```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="ChatGPT" icon="openai" %}
ChatGPT 用の公式 GitBook プラグインをインストールしてください:

<a href="https://chatgpt.com/apps/gitbook/asdk_app_6a576f075ec4819196c203b7049542be" class="button secondary" data-icon="openai">ChatGPT プラグインをインストール</a>

または、ターミナルからサーバーを追加してください:

```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 用の公式 GitBook プラグインをインストールしてください:

<a href="https://cursor.com/marketplace/gitbook" class="button secondary" data-icon="cursor">Cursor プラグインをインストール</a>

またはサーバーを `~/.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 対応クライアントなら、ストリーミング可能な HTTP 経由で接続できます。

接続先を次に設定してください:

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

GitBook はストリーム可能な 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 を使う

GitBookを初めて設定しますか？エージェントの参照先を [GitBookを設定する](https://gitbook.com/docs/documentation/ja-gitbook-documentation/setup.md) に変更してください。

{% 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. 何を変更したいか聞いてから、新しい構成を before/after のシンプルなツリーで提案してください。承認されるまで何も移動しないでください。
3. 可能な限り URL と内部リンクを維持しつつ変更を適用してください。壊れるものがあれば示してください。
4. 最終構成と、確認用の変更リクエストまたはライブ結果を表示してください。
```

{% endprompt %}

## 使用量の上限

現時点では、Freeプランを含め、GitBook MCPにはプランに基づく使用量の上限はありません。GitBook MCPはお使いのトークンを使ってGitBook APIを呼び出すため、APIのレート制限が適用されます。トークンごとに1時間あたり5,000リクエストです。読み取りと書き込みの呼び出しは同じようにカウントされます。

* 1回のMCPツール呼び出しで複数のAPIリクエストが発生することがあるため、ツール呼び出しがちょうど5,000回までというわけではありません。
* メンバーの招待は、1分あたり2件までに制限されています。
* 上限を超えると、呼び出しは「レート制限を超過しました」というエラーで失敗します。このエラーには、再試行までに待つ秒数が示されます。

実行できる操作は、引き続きプランによって決まります。プランに含まれていない機能を必要とする呼び出しを行うと、アプリの場合と同様に、GitBookはアップグレード用リンクを表示してリクエストを拒否します。

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

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

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

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

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

## FAQ

<details>

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

GitBook MCP はストリーミング可能な 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 の Authenticate をクリックしたあと、なぜ何も起こらないのですか？</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/docs-as-code/gitbook-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
