MCPサーバー

mcp を有効にすると、build のたびに完全で切り詰められていない site/mcp-index.json(および site/mcp-manifest.json とツリーごとの mcp-nav.json)を書き出し、bxSites Cloud が公開・読み取り専用の MCP サーバーを通じて AI エージェントにサイトを公開できるようになります - search/searchProvider とは独立しています。

MCPサーバー

bxsites.yaml で mcp: true を有効にすると、build のたびにレンダリング されたページと並んで3つのファイルが書き出されます - サイトのコンテンツ、 ナビゲーション、ツリー構造の完全かつ機械可読なコピーであり、 bxSites Cloud が公開したサイト向けに公開・ 読み取り専用の MCP サーバーを提供する ために読み込みます。これは GitBook の「公開ドキュメント向け MCP サーバー」 と同じ発想です。公開後は、AI エージェントやアシスタント(Claude、 ChatGPT、その他 MCP 対応のクライアント)が、レンダリングされた HTML を スクレイピングする代わりに、サイトのコンテンツを直接検索・閲覧・取得 できるようになります。

• site/mcp-index.json - ツリーごとに、ページ単位の全文エントリを1つ
• site/mcp-nav.json - ツリーごとに、そのツリー自身のナビゲーション構造
• site/mcp-manifest.json - すべてのツリー(メインサイト、バージョン、 ロケール)と、それぞれの上記ファイルの所在を示す、サイト全体の インデックス1つ

bxSites 自体は、このページで説明するファイルを生成するだけです - それをネットワーク越しに実際に MCP サーバーとして提供するのは bxSites Cloud の仕事であり、このモジュール自体が行うものではありません。

有効にする

mcp: true

{ "mcp": true }

mcp = true

false(デフォルト)はこのステップ全体をスキップします - mcp-index.json、 mcp-nav.json、mcp-manifest.json のいずれも書き出されず、build は フラグの確認以上の追加コストを負いません。

search からは独立

mcp は search/searchProvider とは無関係です - 両者は 互いに独立したスイッチです。

• mcp-index.json は search が true か false かに関わらず、また searchProvider.provider("local"、"algolia"、"pagefind"、 または独自のもの)に関わらず生成されます。
• mcp を有効にしても、サイト自体の訪問者向け検索ボックスには一切影響 せず、search を無効にしても mcp-index.json が無効になることは 決してありません。

このため、mcp-index.json は search-index.json を単純に再利用する ことはできません。search-index.json は "local" 検索プロバイダー の場合にのみビルドされ(Algolia や Pagefind を使うサイトはそれぞれ 独自のインデックスを別の場所に持つため、search-index.json はまったく 生成されません)、また body フィールドは意図的に切り詰められています

• search-index.json はページ内検索ボックスのためにすべての訪問者の ブラウザに送られるため、サイズを小さく保つことが重要だからです。 mcp-index.json にはこれらの制約はいずれも当てはまりません。これは bxSites Cloud によってサーバー側で取得されるものであり、訪問者には 送られませんし、本文が切り詰められていると AI エージェントが不完全 または誤った回答をしてしまう恐れがあります。

mcp-index.json のフォーマット

非表示でない各ページにつき1エントリ(search-index.json やナビゲー ションが使う「非表示ページは除外する」という同じ規約に従います)。 通常のドキュメントページとブログ記事の両方が対象です。

[
  {
    "title": "Getting Started",
    "url": "getting-started/index.html",
    "tags": ["guides"],
    "headings": ["Getting Started", "Installation", "Next steps"],
    "body": "Getting Started Installation Run bxSites new to scaffold a project... Next steps ...",
    "type": "page",
    "categories": [],
    "updatedAt": "2026-08-18T10:15:00.000Z"
  },
  {
    "title": "Announcing bxSites 2.0",
    "url": "blog/announcing-bxsites-2/index.html",
    "tags": ["release"],
    "headings": ["Announcing bxSites 2.0"],
    "body": "Announcing bxSites 2.0 Today we're shipping...",
    "type": "post",
    "categories": ["Releases"],
    "updatedAt": "2026-08-15"
  }
]

type/categories/updatedAt を除けば、これは search-index.json と 同じエントリ形式です。唯一の違いは body で、search-index.json では 400 文字で末尾に省略記号を付けて切り詰められますが、ここではページ 全体になります。

mcp-manifest.json のフォーマット

サイトのビルドごとに一度だけ(ツリーごとではなく)書き出される site/mcp-manifest.json は、独自の mcp-index.json/mcp-nav.json を 持つすべてのツリーを一覧化します。これにより、bxSites Cloud の MCP サーバーは bx-sites 自身のディレクトリ規約を推測することなく、 バージョンとロケールを意識したツールを提供できます。

[
  { "path": "", "label": "1.0.x", "version": "1.0.x", "locale": "en", "default": true },
  { "path": "next", "label": "Next", "version": null, "locale": "en", "default": false },
  { "path": "versions/0.9", "label": "0.9", "version": "0.9", "locale": "en", "default": false },
  { "path": "es", "label": "Español", "version": "1.0.x", "locale": "es", "default": false }
]

mcp-nav.json のフォーマット

各ツリー自身の mcp-index.json(サイトルート、/next/、各 /versions/<name>/ ツリー、各ロケールサブツリー)と並んで書き出される mcp-nav.json は、そのツリー自身のナビゲーションです - テーマ自身が サイドバーをレンダリングするために使うのと全く同じ、ネストされた { title, url, order, icon, children } 構造です。これにより、bxSites Cloud の MCP サーバーは独自の第二のナビゲーション形式を発明することなく get_nav/目次ツールを提供できます。

[
  {
    "title": "Getting Started",
    "url": "getting-started/index.html",
    "order": 1,
    "icon": "phosphor-duotone:rocket-launch",
    "children": []
  },
  {
    "title": "Guides",
    "url": "",
    "order": 2,
    "icon": "",
    "children": [
      { "title": "Search", "url": "guides/search/index.html", "order": 1, "icon": "", "children": [] }
    ]
  }
]

"Guides" のように自身の index.md を持たないフォルダーグループ ノードは url が空です - これはページではなく、単に children の 見出しです。

マルチバージョン・多言語サイト

search-index.json と同様に、mcp-index.json/mcp-nav.json もレンダ リングされるツリーごとに一度書き出されます - メインサイト、 (versions.default が設定されている場合の)/next/、各 /versions/<name>/ ツリー、各ロケールサブツリーです。したがって、 公開される各ツリーはそのツリー自身のページとナビゲーションのみを カバーする、独自のファイルのペアを持ちます。一方 mcp-manifest.json は、ビルドごとに一度だけ、サイトルートにのみ書き出され、これら すべてのツリーを一覧化します。