---
tags: [note, MCP]
type: "note"
nature: documentation # Options : portrait, lieu, info, concept, script, process, tuto, none
ressource: true
univers: PERSO
projects:
  - "[[03_PROJETS/VPS-IA]]"
date: "[[01_JOURNAL/2026/2026-10-10]]"
priority: 10
description: "Mode d'emploi des deux MCP Excalidraw : maaker génère, sentinel édite, fichiers .excalidraw dans SB."
---
# Utilisation des MCP Excalidraw (OpenCode)

## Principe

L'IA dispose de **2 MCP Excalidraw** (voir [[04_NOTES/VPS-IA_Installation-Excalidraw-MCP|Installation des MCP Excalidraw]]) :

- **`excalidraw-maaker`** : génération de diagrammes depuis une description (layout auto), travaille sur des fichiers `.excalidraw`.
- **`excalidraw`** (sentinel) : canvas live + édition fine d'éléments, base SQLite.

**Règle de la vérité unique** : les fichiers `.excalidraw` stockés dans SilverBullet sont la référence.

## Comment demander

Il suffit de **décrire ce que tu veux** — l'IA charge le skill `excalidraw` et choisit le MCP adapté. Tu peux aussi nommer l'outil explicitement si tu veux forcer un comportement.

## Exemple 1 — Générer un schéma (maaker)

> « Génère un schéma d'architecture : Frontend (React, Next.js), Backend (API Server, Auth Service) et Database (PostgreSQL, Redis). Enregistre-le dans SB sous `03_PROJETS/MonProjet/schema.excalidraw`. »

→ `create_architecture_diagram` → fichier `.excalidraw` local → poussé dans SB via `/.fs` → visualisable avec le plug Excalidraw SilverBullet.

## Exemple 2 — Dessin live (sentinel)

> « Dessine un schéma serveur → API → base de données sur le canvas Excalidraw. »

→ garder le canvas ouvert (`https://excalidraw-mcp.datagrandest.net/`) → `batch_create_elements` / `create_element` → éléments visibles en temps réel.

## Exemple 3 — Modifier un schéma existant dans SB

> « Lis le schéma `03_PROJETS/MonProjet/schema.excalidraw` et ajoute un nœud "Cache" connecté à l'API Server. »

→ `read_diagram` (maaker) puis `modify_diagram` → résultat repoussé dans SB.

## Pourquoi 2 MCP ?

- **Génération propre** (layout auto, branches, centrage, liaisons) → **maaker**.
- **Retouche fine / dessin live** (déplacer, recolorer, voir en direct) → **sentinel**.
- **Parallélisme** : maaker travaille sur plusieurs fichiers indépendamment ; sentinel = 1 projet actif à la fois (ou instances séparées).

## Astuce skill

Le skill `excalidraw` (dans `80_CONFIG/IA_SKILLS`) contient les outils, le workflow et les erreurs fréquentes — il se charge automatiquement quand tu parles de schéma, ou tu peux le demander explicitement.
