Serveur MCP

Tiramisu Docs inclut un serveur MCP (Model Context Protocol) intégré qui permet aux assistants IA comme Claude, Cursor et d'autres outils compatibles MCP de parcourir votre documentation de manière programmatique.

Le serveur est hébergé en tant que point d'accès HTTP JSON-RPC à /mcp sur votre site de documentation déployé. Il est livré sous forme de route SvelteKit — pas de CLI, pas de processus séparé, pas de configuration locale. Déployez votre site et le serveur MCP est en ligne.

Activer le serveur

Définissez mcp: true dans votre configuration pour générer une route POST /mcp et afficher les boutons « Connecter » dans l'interface de vos docs :

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

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

Lorsqu'il est activé, cela fait deux choses :

• Génère une route POST /mcp qui gère les requêtes JSON-RPC 2.0 provenant des outils IA
• Affiche les boutons Connecter avec MCP et Connecter à VSCode sur vos pages de documentation — l'URL est dérivée automatiquement de l'origine de votre site

URL personnalisée du serveur

Si vous hébergez votre serveur MCP séparément ou souhaitez que les boutons de l'interface pointent vers un autre point d'accès, passez une chaîne URL à la place :

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

Lorsqu'une chaîne est fournie :

• Les boutons de l'interface pointent vers l'URL donnée
• Aucune route /mcp n'est générée — vous êtes responsable de l'hébergement du serveur à cette URL

Connecter les outils IA

Une fois votre site déployé avec mcp: true, les outils IA peuvent se connecter en utilisant l'URL hébergée.

Claude Code

Ajoutez dans votre fichier .mcp.json à la racine du projet :

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

Remplacez docs.example.com par votre domaine de documentation réel.

Cursor

Dans les paramètres MCP de Cursor, ajoutez un nouveau serveur et collez l'URL MCP de votre documentation (par ex. https://docs.example.com/mcp). Cursor prend en charge nativement les points d'accès MCP HTTP.

VSCode

Votre site de documentation affiche un bouton Connecter à VSCode dans le menu déroulant Open. En cliquant dessus, le gestionnaire de protocole vscode:mcp/install enregistre automatiquement le serveur — aucune configuration manuelle nécessaire.

Outils disponibles

Le serveur expose cinq outils aux assistants IA :

Comment ça fonctionne

Le serveur MCP est une route POST SvelteKit standard à /mcp. Il communique en JSON-RPC 2.0 via HTTP — chaque requête est un POST unique avec un corps JSON, et la réponse est en JSON.

Les données de documentation proviennent du module virtual:tiramisu-docs au moment du build. Le serveur ne scanne pas le système de fichiers à l'exécution, ce qui signifie qu'il fonctionne sur n'importe quelle cible de déploiement : fonctions serverless, runtimes edge, adaptateurs statiques avec prérendu ou serveurs Node.js traditionnels. Partout où SvelteKit s'exécute, le serveur MCP s'exécute.