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 |

Outils tickets

| Outil | Description | Scopes requis | |-------|-------------|---------------| | list_tickets | Lister/filtrer les tickets du workspace actif (DSL : status=, priority>=, assignee=me, tag=, ...) | tickets:read | | read_ticket | Lire le détail complet d'un ticket par son UUID | tickets:read | | create_ticket | Créer un ticket | tickets:write | | update_ticket | Modifier un ticket existant | tickets:write | | bulk_update_tickets | Appliquer un même patch à plusieurs tickets en un appel (assignee, priorité, statut, verticale, tags) | tickets:write | | delete_ticket | Supprimer un ticket | tickets:write | | list_ticket_comments | Lister les commentaires d'un ticket | tickets:read | | create_ticket_comment | Ajouter un commentaire à un ticket | tickets:write | | update_ticket_comment | Modifier un de ses propres commentaires | tickets:write | | delete_ticket_comment | Supprimer un de ses propres commentaires | tickets:write | | list_ticket_relations | Lister les relations d'un ticket (parent/enfant/liée) | tickets:read | | add_ticket_relation | Lier deux tickets entre eux | tickets:write | | remove_ticket_relation | Supprimer une relation entre deux tickets | tickets:write | | list_workspace_members | Lister les membres du workspace (pour résoudre un assignee vers son UUID) | aucun (authentification requise) |

bulk_update_tickets prend une liste ids (UUIDs et/ou numéros courts type 1390, 100 max) et un patch unique appliqué à tous. Le traitement est best-effort : chaque ticket est traité indépendamment et la réponse liste les succès et les échecs, sans rollback. Les tags ont deux modes exclusifs : tags remplace la liste, addTags ajoute aux tags existants (un label déjà présent garde sa couleur). Non modifiables en masse car propres à chaque ticket : title, description, position.

create_ticket et update_ticket acceptent aussi estimateDays (estimation en jours ouvrés, lun-ven). Si une date de début ou d'échéance est fournie en même temps, la date manquante est calculée automatiquement par le backend à partir de l'estimation.

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