GitBook MCP

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

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

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

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

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

公開済みのドキュメントサイト用の読み取り専用 MCP サーバーが必要ですか？ GitBook が自動で作成します — こちらを参照: 公開ドキュメント向けMCPサーバーで詳細を確認してください。

GitBook の MCP エンドポイント

MCP クライアントの接続先:

https://mcp.gitbook.com/mcp

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

クライアントを接続する

お好みのクライアントに GitBook MCP を追加してください:

Claude 用の公式 GitBook プラグインをインストール:

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

または、端末からサーバーを追加:

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>"

ChatGPT 用の公式 GitBook プラグインをインストール:

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

または、端末からサーバーを追加:

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 用の公式 GitBook プラグインをインストール:

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

または、サーバーを ~/.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 を使う場合、通常は追加の認証フィールドは必要ありません。

代わりに個人アクセストークンを使う場合は、次のように bearer token として送信してください:

Authorization: Bearer <YOUR_PAT>

GitBook の MCP を認証する

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

クライアントを MCP サーバーの URL に向けてください。クライアントは認証サーバーを検出し、自身を登録し、ブラウザのサインインフローを自動で開きます。

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

ブラウザのフローを省略するには、トークンを bearer token として送信します:

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 は、チームのエージェントが自動化されたワークフローを通じてドキュメントを編集・管理したいときに使います。

よくある質問

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

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

GitBook MCP は stdio または SSE.

クライアントが追加のフィールドを要求しても、通常は空のままで構いません。

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

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

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

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

はい。それは一部の MCP クライアントでは想定内です。

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

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

一部のクライアントは、少し遅れてブラウザのサインインフローを開きます。

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

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

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

認証が成功すると、通常は次のような流れになります:

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

クライアントが GitBook MCP への認証に成功したかどうかは、どう見分ければよいですか？

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

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

もし Authenticate ボタンが表示されたままで、ツールが出てこない場合、フローは完了していない可能性があります。

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

次の点を確認してください:

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

最終更新 1 か月前

役に立ちましたか？