Aller au contenu

🔌 Connexion MCP (Model Context Protocol)

Le support du Model Context Protocol (MCP) permet à des clients IA externes (Claude Desktop, Claude Code, Cursor, Codex, OpenCode, Hermes) d'intéragir directement avec une instance Instatic.


🔄 Principe d'Inversion

  • L'onglet Providers dans Instatic permet à Instatic d'appeler des modèles LLM distants.
  • L'onglet MCP transforme Instatic en serveur MCP standardisé : les clients IA externes découvrent les outils disponibles, lisent la structure des pages et pilotent l'éditeur en direct.
sequenceDiagram
    participant Client as Client IA Externe (Claude / Cursor)
    participant MCP as Serveur MCP Instatic (/_instatic/mcp)
    participant Bridge as Pont Éditeur Live (Zustand Store)
    participant DB as Base de Données / Publisher

    Client->>MCP: Requête MCP (ex: site_apply_css / insert_html)
    alt Outil Sans Tête (Headless: lecture, publication)
        MCP->>DB: Exécute la lecture ou la publication atomique
        DB-->>MCP: Données / Statut de publication
    else Outil Visuel (Édition directe)
        MCP->>Bridge: Relais vers l'espace de travail ouvert
        Bridge->>Bridge: Mutation en direct du canevas
        Bridge-->>MCP: Validation & Patch appliqué
    end
    MCP-->>Client: Réponse JSON-RPC MCP

📑 Sommaire de la section

  1. Protocole Wire MCP — Spécification stable 2026-07-28, headers Mcp-Method, architecture sans état et compatibilité 2025.
  2. Mode OAuth PKCE Hébergé — Connecteurs personnalisés Claude Desktop / Cloud, enregistrement dynamique RFC 9728 et rotation de tokens.
  3. Jetons d'Accès Personnels (PAT) — Configuration pour Claude Code, Cursor, Codex et ponts stdio locaux.
  4. Pont Éditeur en Direct (Live Workspace Bridge) — Synchronisation temps réel entre requêtes d'agents et le canevas ouvert du concepteur.