Whiteboard MCP Server

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

Installation

$3

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)

$3

Global (tous les projets) :
``bash
claude mcp add whiteboard -s user npx whiteboard-mcp-server@latest -e WHITEBOARD_API_KEY=wb_votre_cle
`

Local (projet courant uniquement) :
`bash
claude mcp add whiteboard npx whiteboard-mcp-server@latest -e WHITEBOARD_API_KEY=wb_votre_cle
`

$3

Quitter et relancer Claude Code pour activer le serveur MCP.

$3

`bash
claude mcp list
`

Vous devriez voir :
`
whiteboard: npx whiteboard-mcp-server@latest - ✓ Connected
`

$3

`bash
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

`bash


Mode développement (avec hot reload)

npm run dev

Typecheck uniquement

npm run typecheck

Build

npm run build
``