MCP Server

Tiramisu Docs enthält einen eingebauten MCP-Server (Model Context Protocol), der es KI-Assistenten wie Claude, Cursor und anderen MCP-kompatiblen Tools ermöglicht, Ihre Dokumentation programmatisch zu durchsuchen.

Der Server wird als HTTP-JSON-RPC-Endpunkt unter /mcp auf Ihrer bereitgestellten Docs-Website gehostet. Er wird als SvelteKit-Route ausgeliefert — kein CLI, kein separater Prozess, kein lokales Setup. Stellen Sie Ihre Website bereit und der MCP-Server ist live.

Server aktivieren

Setzen Sie mcp: true in Ihrer Konfiguration, um eine /mcp-POST-Route zu generieren und „Verbinden"-Buttons in Ihrer Docs-UI anzuzeigen:

import { defineConfig } from "@tiramisu-docs/kit";

export default defineConfig({
  mcp: true,
  // ...
});

Wenn aktiviert, bewirkt dies zwei Dinge:

• Generiert eine /mcp-POST-Route, die JSON-RPC-2.0-Anfragen von KI-Tools verarbeitet
• Zeigt Connect with MCP- und Connect to VSCode-Buttons auf Ihren Docs-Seiten an — die URL wird automatisch aus dem Origin Ihrer Website abgeleitet

Benutzerdefinierte Server-URL

Wenn Sie Ihren MCP-Server separat hosten oder die UI-Buttons auf einen anderen Endpunkt verweisen lassen möchten, übergeben Sie stattdessen einen URL-String:

export default defineConfig({
  mcp: "https://docs.example.com/mcp",
  // ...
});

Wenn ein String angegeben wird:

• Die UI-Buttons verweisen auf die angegebene URL
• Es wird keine /mcp-Route generiert — Sie sind für das Hosting des Servers unter dieser URL verantwortlich

KI-Tools verbinden

Sobald Ihre Website mit mcp: true bereitgestellt ist, können sich KI-Tools über die gehostete URL verbinden.

Claude Code

Fügen Sie Folgendes zu Ihrer .mcp.json-Datei im Projektstamm hinzu:

{
  "mcpServers": {
    "my-docs": {
      "type": "streamableHttp",
      "url": "https://docs.example.com/mcp"
    }
  }
}

Ersetzen Sie docs.example.com durch Ihre tatsächliche Docs-Domain.

Cursor

Fügen Sie in den MCP-Einstellungen von Cursor einen neuen Server hinzu und fügen Sie Ihre Docs-MCP-URL ein (z.B. https://docs.example.com/mcp). Cursor unterstützt HTTP-MCP-Endpunkte nativ.

VSCode

Ihre Docs-Website zeigt im Open-Dropdown einen Connect to VSCode-Button an. Durch Klicken wird der vscode:mcp/install-Protokoll-Handler verwendet, um den Server automatisch zu registrieren — keine manuelle Konfiguration erforderlich.

Verfügbare Tools

Der Server stellt KI-Assistenten fünf Tools zur Verfügung:

So funktioniert es

Der MCP-Server ist eine Standard-SvelteKit-POST-Route unter /mcp. Er spricht JSON-RPC 2.0 über HTTP — jede Anfrage ist ein einzelner POST mit einem JSON-Body, und die Antwort ist JSON.

Die Dokumentationsdaten stammen aus dem Modul virtual:tiramisu-docs zur Build-Zeit. Der Server durchsucht das Dateisystem zur Laufzeit nicht, was bedeutet, dass er auf jedem Deployment-Ziel funktioniert: Serverless Functions, Edge Runtimes, statische Adapter mit Prerendering oder traditionelle Node.js-Server. Wo auch immer SvelteKit läuft, läuft der MCP-Server.