MCP-Server

Aktiviere mcp, um bei jedem Build eine vollständige, unabgeschnittene site/mcp-index.json (sowie site/mcp-manifest.json und eine mcp-nav.json pro Baum) zu schreiben, damit bxSites Cloud deine veröffentlichte Website über einen öffentlichen, schreibgeschützten MCP-Server für KI-Agenten bereitstellen kann - unabhängig von search/searchProvider.

MCP-Server

Schalte mcp: true in bxsites.yaml ein, und jeder build schreibt drei Dateien neben deinen gerenderten Seiten - eine vollständige, maschinenlesbare Kopie des Inhalts, der Navigation und der Baumstruktur deiner Website, die bxSites Cloud liest, um einen öffentlichen, schreibgeschützten MCP-Server für deine veröffentlichte Website bereitzustellen - dieselbe Idee wie GitBooks „MCP servers for published docs". Nach der Veröffentlichung können KI-Agenten und -Assistenten (Claude, ChatGPT und jeder andere MCP-fähige Client) den Inhalt deiner Website direkt durchsuchen, browsen und abrufen, statt gerendertes HTML zu scrapen:

• site/mcp-index.json - ein vollständiger Eintrag pro Seite, pro Baum
• site/mcp-nav.json - die eigene Navigationsstruktur dieses Baums, pro Baum
• site/mcp-manifest.json - ein websiteweiter Index aller Bäume (Hauptseite, Versionen, Sprachen) und wo die eigenen Dateien jedes Baums von oben zu finden sind

BxSites selbst erzeugt ausschließlich die auf dieser Seite beschriebenen Dateien - sie tatsächlich als MCP-Server über das Netzwerk auszuliefern, ist Aufgabe von bxSites Cloud, nicht etwas, das dieses Modul selbst übernimmt.

Aktivieren

mcp: true

{ "mcp": true }

mcp = true

false (Standard) überspringt den gesamten Schritt - es werden weder mcp-index.json, mcp-nav.json noch mcp-manifest.json geschrieben, und build verursacht über die reine Prüfung des Flags hinaus keine zusätzlichen Kosten.

Unabhängig von search

mcp hat nichts mit search/searchProvider zu tun - die beiden sind voneinander unabhängige Schalter:

• mcp-index.json wird unabhängig davon erzeugt, ob search true oder false ist, und unabhängig von searchProvider.provider ("local", "algolia", "pagefind" oder ein eigener).
• Das Aktivieren von mcp ändert nie etwas an der eigenen, besucherseitigen Suchbox deiner Website, und das Deaktivieren von search deaktiviert niemals mcp-index.json.

Deshalb kann mcp-index.json nicht einfach search-index.json wiederverwenden: Diese Datei wird nur für den "local"-Such-Provider gebaut (eine Algolia- oder Pagefind-gestützte Website erzeugt gar keine search-index.json, da beide ihren eigenen Index anderswo führen), und ihr body-Feld ist absichtlich abgeschnitten - search-index.json wird an den Browser jedes Besuchers für die Suchbox auf der Seite ausgeliefert, weshalb es wichtig ist, sie klein zu halten. Keine dieser Einschränkungen gilt für mcp-index.json: Sie wird serverseitig von bxSites Cloud abgerufen, nicht an Besucher ausgeliefert, und ein abgeschnittener Textkörper riskiert, dass ein KI-Agent eine unvollständige oder falsche Antwort gibt.

Das Format von mcp-index.json

Ein Eintrag pro nicht versteckter Seite (dieselbe Konvention „versteckte Seiten werden ausgeschlossen", die auch search-index.json/die Navigation verwenden), sowohl für reguläre Doku-Seiten als auch für Blog-Beiträge:

[
  {
    "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"
  }
]

Abgesehen von type/categories/updatedAt ist dies dieselbe Eintragsform wie bei search-index.json, mit einem Unterschied: dort wird body auf 400 Zeichen mit abschließender Ellipse gekürzt; hier ist es die vollständige Seite.

Das Format von mcp-manifest.json

Einmal pro Website-Build geschrieben (nicht einmal pro Baum), listet site/mcp-manifest.json jeden Baum auf, der eine eigene mcp-index.json/mcp-nav.json erhalten hat, damit der MCP-Server von bxSites Cloud versions- und sprachbewusste Tools anbieten kann, ohne die eigenen Verzeichniskonventionen von bx-sites erraten zu müssen:

[
  { "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 }
]

Das Format von mcp-nav.json

Neben der eigenen mcp-index.json jedes Baums geschrieben (Website- Wurzel, /next/, jeder /versions/<name>/-Baum, jeder Sprach-Unterbaum) ist mcp-nav.json die eigene Navigation dieses Baums - genau dieselbe verschachtelte { title, url, order, icon, children }-Struktur, aus der das Theme selbst die Seitenleiste rendert -, damit der MCP-Server von bxSites Cloud ein get_nav/Inhaltsverzeichnis-Tool anbieten kann, ohne eine zweite, eigene Navigationsform zu erfinden:

[
  {
    "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": [] }
    ]
  }
]

Ein Ordner-Gruppenknoten ohne eigene index.md (wie "Guides" oben) hat eine leere url - er ist keine Seite, sondern nur eine Überschrift für seine children.

Websites mit mehreren Versionen und Sprachen

Genau wie search-index.json werden mcp-index.json/mcp-nav.json einmal pro gerendertem Baum geschrieben - die Hauptseite, /next/ (wenn versions.default gesetzt ist), jeder /versions/<name>/-Baum und jeder Sprach-Unterbaum -, sodass jeder veröffentlichte Baum sein eigenes Dateipaar erhält, das nur die eigenen Seiten und die eigene Navigation dieses Baums abdeckt. mcp-manifest.json hingegen wird einmal pro Build geschrieben, nur an der Website-Wurzel, und listet jeden dieser Bäume auf.