公開ドキュメント向けMCPサーバー
GitBookで公開されたドキュメントは、自動的にMCPサーバーを生成し、外部ツールと接続できます
公開されたすべての GitBook サイトには、Model Context Protocol (MCP) サーバーが自動的に含まれます。
AI ツールはこれを使って、公開済みのドキュメントを直接読み取れます。これは Claude、Claude Code、Cursor、Codex、VS Code、その他の MCP クライアントで動作します。
適切なエンドポイントを選択する
MCP サーバーは、公開サイトの URL に次のいずれかのエンドポイントを付けた場所にあります。
公開、共有リンクによって共有されており、すべての公開コンテンツが表示される、または完全に認証済み
{docs-site-url}/~gitbook/mcp
https://gitbook.com/docs/~gitbook/mcp
部分的に認証済みで、一部の公開コンテンツまたは共有リンクのコンテンツが引き続き表示される
{docs-site-url}/~gitbook/mcp/auth
https://gitbook.com/docs/~gitbook/mcp/auth
完全に認証済みのサイトでは、クライアントは MCP のディスカバリーと OAuth を通じてサインインします。詳細は、 MCP 認可フロー.
AI ツールを接続する
MCP サーバーの URL を見つける
公開済みのドキュメント URL から始めます。次に、 適切なエンドポイントを選択する.
たとえば、ドキュメントサイトが https://gitbook.com/docsの場合、MCP サーバーの URL は https://gitbook.com/docs/~gitbook/mcp.
に置き換えてください。
のプロンプトのいずれかを実行してください。 試してみる。ツールがドキュメントを検索し、そこから回答できるなら、接続は成功です。
これらの手順は、Web 版 Claude と Claude Desktop で使えます。
開く 設定 → コネクタ.
クリックして カスタムコネクタを追加。その後、次のように MCP サーバーの URL を貼り付けます。 {docs-site-url}/~gitbook/mcp.
例:
https://gitbook.com/docs/~gitbook/mcpClaude にリモートコネクタが表示されない場合、現在のプランまたは展開ではまだサポートされていない可能性があります。
次のコマンドをターミナルで実行してください。
claude mcp add --transport http my-docs https://gitbook.com/docs/~gitbook/mcp置換 my-docs を、任意のサーバー名に置き換えてください。
サイトが認証済みの公開エンドポイントを使用している場合は、URL の末尾を次に置き換えてください。 /~gitbook/mcp/auth.
開く 設定 → MCP.
クリックして 新しい MCP サーバーを追加。その後、 {docs-site-url}/~gitbook/mcp.
にもこのファイルを追加できます。 .cursor/mcp.json:
{
"mcpServers": {
"my-docs": {
"url": "https://gitbook.com/docs/~gitbook/mcp"
}
}
}置換 my-docs 必要であれば、ここを独自のサーバー名に置き換えてください。
を使用するか、サーバーを codex mcp add コマンドで追加するか、あるいはサーバーを config.toml.
コマンド例:
設定例:
置換 my-docs 必要であれば、ここを独自のサーバー名に置き換えてください。
あなたの mcp.json ファイル。次に、HTTP トランスポートのサーバーエントリを追加します。
置換 my-docs 必要であれば、ここを独自のサーバー名に置き換えてください。
試してみる
次のプロンプトのいずれかをアシスタントに貼り付けてください。
my-docs MCP サーバーを使って、認証済みアクセスをどのように設定しますか？カスタムドメインに関する情報をドキュメント全体から検索し、手順を要約してください。my-docs MCP サーバーが公開しているツールを一覧表示してください。その後、それらを使ってページアクションについてのページを見つけてください。
エージェント型ツールを使う場合は、次のセットアッププロンプトも指定できます。
要件
MCP サーバーを使うには:
サイトは公開されている必要があります。MCP サーバーが公開するのは公開済みコンテンツのみです。
ページアクション は サイトのカスタマイズ → ページアクション.
に含まれている必要があります。
サイトが共有リンクを使用している場合は、共有リンク用のサイト URL を使用し、次に 適切なエンドポイントを選択する.
GitBook は HTTP トランスポートのみをサポートしています。
stdio、SSEはサポートされていません。
次の場所で ページアクション セクションから表示および管理できます。 カスタマイズ 設定で、 MCP サーバーに接続する オプションを有効にできます。これにより、訪問者は ページアクションメニュー.
サイトに MCP リンクを追加する
では サイトのカスタマイズ、 ページアクションがオンになっていることを確認してください。次に ページアクション をオンにします。 MCP サーバーに接続する.
これにより、ページアクションメニューにコピー可能な MCP リンクが追加されます。ツールが使用するエンドポイントは変わりません。
プライバシーとアクセス
のエンドポイントを使用してください。 適切なエンドポイントを選択する.
MCP サーバーは、公開済みのドキュメントへの読み取り専用アクセスを提供します。
非表示のページは MCP 経由でも利用可能なままです。ページを非表示にしても、公開済みの目次から削除されるだけです。
アカウントデータ、分析データ、または内部の GitBook データを公開することはありません。
最新の公開バージョンのみを提供します。下書きや未公開の変更は非公開のままです。
トラブルシューティング
ツールが接続できない場合:
公開済みサイトにアクセスできることを確認してください。
URL が 適切なエンドポイントを選択する.
を使用していることを確認してください。 MCP 認可仕様.
サイトが認証を使用している場合は、
stdioまたはSSEをサポートするクライアントを使用してください。
認証済みサイトで MCP を使う
GitBook サイトが 認証済みアクセスを使用している場合、 /~gitbook/mcp の MCP サーバーは MCP 認可仕様 と同じ認証を使用します。Claude や Claude Code を含む、
共有リンクの代わりにサイトが共有リンクを使用している場合は、完全な共有リンク用サイト URL を使用し、次に 適切なエンドポイントを選択する.
GitBook は、共有リンクのみのサイト、または MCP 認証のために静的ヘッダーで渡される訪問者認証トークンを使用するサイトをサポートしていません。
Claude を含む、サポートされている MCP クライアントは、 MCP 認可仕様 に従って接続します。
このフローは、次の認証済みアクセスバックエンドで動作します。
カスタムバックエンド 設定済みのフォールバック URL を使用する
MCP 認証は、リクエストヘッダー内の静的な訪問者認証トークンのみに依存するサイトをサポートしていません。
代わりに、上記の認証済みアクセスバックエンドのいずれかを使用してください。
これを設定するには、まず 認証アクセス 、 認証済みアクセスを有効にする.
最終更新
役に立ちましたか？