> 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 GitBook は、AI ツールが組織内のコンテンツに対して操作できる MCP サーバーを公開しています。 Claude Code、Codex、Cursor などのツールやその他の MCP クライアントは、これを使ってサイトの作成と設定、変更リクエストの作成、コンテンツの下書き、ページの編集、ドキュメント構造の再編成を行えます。

公式プラグインをインストールしてください:

Claude プラグインをインストール ChatGPT プラグインをインストール Cursor プラグインをインストール

{% hint style="info" %} 公開済みのドキュメントサイト向けに読み取り専用の MCP サーバーが必要ですか？ GitBook が自動的に作成します — こちらをご覧ください [公開済みドキュメント向けの MCP サーバー](/docs/documentation/ja-gitbook-documentation/notameno-ai/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 プラグインをインストール: 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 " ``` {% endtab %} {% tab title="ChatGPT" icon="openai" %} ChatGPT 用の公式 GitBook プラグインをインストール: ChatGPT プラグインをインストール または、ターミナルからサーバーを追加します: ```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 プラグインをインストール: 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 ``` {% endtab %} {% endtabs %} ## GitBook の MCP を認証する GitBook MCP は、OAuth と個人用アクセス トークンの 2 つの認証方法をサポートしています。 {% tabs %} {% tab title="OAuth" %} クライアントを MCP サーバーの URL に向けてください。クライアントが認可サーバーを検出し、自身を登録し、ブラウザでのサインイン フローを自動的に開きます。 OAuth を使う場合は、ベアラートークンを手動で追加しないでください。クライアントはサインイン中に取得します。 {% endtab %} {% tab title="個人用アクセス トークン" %} ブラウザのフローを省略するには、トークンをベアラートークンとして送信してください: ```http Authorization: Bearer ``` 個人用アクセス トークンは、あなたの [開発者設定](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/notameno-ai/mcp-servers-for-published-docs.md) AI ツールに公開済みコンテンツへの読み取り専用アクセスを提供します。 * **GitBook MCP** GitBook API を通じて、AI ツールにあなたのコンテンツとワークフローへのアクセスを提供します。 公開済みドキュメント MCP は、ドキュメントの読者やエンドユーザーが公開済みドキュメントから情報を見つけられるようにしたいときに使います。 GitBook MCP は、チームのエージェントが自動化されたワークフローを通じてドキュメントを編集・管理できるようにしたいときに使います。 ## よくある質問
MCP クライアントを接続するとき、GitBook MCP はどのトランスポートをサポートしていますか？ GitBook MCP は streamable HTTP をサポートしています。 GitBook MCP は `stdio` または `SSE`. クライアントが追加フィールドを要求する場合、通常は空のままで構いません。
クライアントを GitBook MCP に接続するとき、ベアラートークンを追加する必要がありますか？ ベアラートークンを追加する必要があるのは、 [個人用アクセス トークン](https://app.gitbook.com/account/developer). OAuth を使う場合は、ベアラートークンを手動で追加しないでください。クライアントはサインイン フロー中にそれを取得します。
GitBook MCP サーバーをクライアントに追加しても何も起こらないのはなぜですか？ はい。それは一部の MCP クライアントでは想定内です。 サーバーを追加すると、設定が保存されるだけの場合がよくあります。クライアントによっては、最初に接続したとき、ツール一覧を取得したとき、または MCP パネルを開いたときにのみ認証を開始します。
GitBook MCP で Authenticate をクリックしても何も起こらないのはなぜですか？ 一部のクライアントでは、短い遅延の後にブラウザのサインイン フローが開きます。 不安定なネットワークや速度の遅いネットワークでは、その遅延が長くなることがあります。 約 1 分たってもブラウザ タブが開かない場合は、ネットワーク、ポップアップ設定、既定のブラウザを確認してください。
GitBook MCP の認証フローでは何が起こりますか？ 認証が機能すると、通常は次のようになります: 1. クライアントが MCP サーバーに接続します。 2. ブラウザでサインイン フローが開きます。 3. サインインしてアクセスを承認します。 4. クライアントにサーバーが接続済みとして表示されるか、MCP ツールが利用可能になります。
クライアントが GitBook MCP で正常に認証されたかどうかは、どうすればわかりますか？ 正確な संकेतはクライアントによって異なりますが、結果は通常わかりやすいです。 多くのクライアントでは認証プロンプトが消え、サーバーが接続済みとして表示されるか、アシスタントが MCP ツールを一覧表示・呼び出しできるようになります。 もし **Authenticate** ボタンが表示されたままでツールが何も出てこない場合、フローは完了していない可能性があります。
GitBook MCP の認証がまだ固まっているように見える場合、何を確認すべきですか？ 次の点を確認してください: * サーバー URL が MCP エンドポイントを指していることを確認します。 * クライアントが HTTP トランスポートを使用していることを確認します。 * 安定したネットワークで再試行します。 * クライアントが失敗状態をキャッシュしている場合は、サーバーを削除して再追加します。
--- # 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/docs-as-code/gitbook-mcp.md?ask=&goal= ``` `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.