GitBook MCP

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

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

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

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

公開済みのドキュメントサイト向けに読み取り専用の MCP サーバーが必要ですか？ GitBook が自動的に作成します — 詳しくは公開済みドキュメント向け MCP サーバーをご覧ください。

GitBook の MCP エンドポイント

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

https://mcp.gitbook.com/mcp

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

クライアントを接続する

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

ターミナルでサーバーを登録します：

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

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

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

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

ターミナルからサーバーを追加します：

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

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

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

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

サーバーを ~/.cursor/mcp.jsonに追加するか、プロジェクトの .cursor/mcp.json:

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

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

サーバーを .vscode/mcp.json をワークスペース内に配置します：

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

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

MCP 対応クライアントであれば、streamable HTTP 経由で接続できます。

以下に向けてください：

https://mcp.gitbook.com/mcp

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

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

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

Authorization: Bearer <YOUR_PAT>

GitBook の MCP を認証する

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

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

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

ブラウザーフローを省略するには、トークンをベアラートークンとして送信します：

Authorization: Bearer <YOUR_PAT>

個人用アクセストークンは、開発者設定.

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

GitBook の MCP の使い方

Create and configure a new docs site.

Open a change request and draft content.

Move, rename, or restructure pages across a site.

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

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

公開済みドキュメント向け MCP サーバー AI ツールに公開コンテンツへの読み取り専用アクセスを提供します。
GitBook MCP は、GitBook API を通じて AI ツールにコンテンツとワークフローへのアクセスを提供します。

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

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

FAQ

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

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

GitBook MCP は stdio または SSE.

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

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

ベアラートークンを追加する必要があるのは、個人用アクセストークン.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

次を確認してください：

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

最終更新 6 日前

役に立ちましたか？