Whiteboard MCP Server

Serveur MCP (Model Context Protocol) pour intégrer les notes Whiteboard avec Claude Code.

Installation

1. Générer une API key

1. Aller sur https://whiteboard.kepochan.com/api-keys
2. Créer une nouvelle clé avec les scopes souhaités (notes:read, notes:write, etc.)
3. Copier la clé générée (format wb_xxxxx)

2. Ajouter le serveur MCP à Claude Code

Global (tous les projets) :

claude mcp add whiteboard -s user npx whiteboard-mcp-server@latest -e WHITEBOARD_API_KEY=wb_votre_cle

Local (projet courant uniquement) :

claude mcp add whiteboard npx whiteboard-mcp-server@latest -e WHITEBOARD_API_KEY=wb_votre_cle

3. Redémarrer Claude Code

Quitter et relancer Claude Code pour activer le serveur MCP.

Vérifier l'installation

claude mcp list

Vous devriez voir :

whiteboard: npx whiteboard-mcp-server@latest - ✓ Connected

Mettre à jour

rm -rf ~/.npm/_npx

Puis relancer Claude Code.

Outils disponibles

| Outil | Description | Scopes requis | |-------|-------------|---------------| | list_notes | Lister les notes accessibles | notes:read | | read_note | Lire le contenu d'une note | notes:read | | create_note | Créer une nouvelle note | notes:write | | update_note | Modifier une note existante | notes:write | | delete_note | Supprimer une note | notes:write | | get_note_comments | Récupérer les commentaires | comments:read | | resolve_comment_thread | Résoudre un thread | comments:write |

Ressources MCP

• note://[slug] - Contenu d'une note (lecture directe)

Variables d'environnement

| Variable | Description | Défaut | |----------|-------------|--------| | WHITEBOARD_API_KEY | Clé API (requis) | - | | WHITEBOARD_API_URL | URL de l'API | https://whiteboard-api.kepochan.com | | WHITEBOARD_URL | URL du frontend | https://whiteboard.kepochan.com |

Exemples d'utilisation

Dans Claude Code, vous pouvez maintenant dire :

• "Liste mes notes"
• "Lis la note ma-note"
• "Modifie la note projet-x avec ce nouveau contenu : ..."
• "Crée une note nouvelle-idee avec le contenu suivant : ..."
• "Quels sont les commentaires sur la note documentation ?"
• "Résous le thread de commentaire XYZ sur la note spec"

Développement

# Mode développement (avec hot reload)
npm run dev

# Typecheck uniquement
npm run typecheck

# Build
npm run build