Installation
Connectez un agent à CodBoard en quelques minutes : installez le plugin Claude Code, autorisez la connexion en un clic (OAuth — aucune clé à coller), puis laissez la commande /codboard:init relier votre dépôt. Rien n’est installé sur votre board externe — CodBoard le lit seulement.
Prérequis
- Un compte CodBoard et un projet — créez-en un sur codboard.com.
- Claude Code, la voie recommandée : le plugin embarque la connexion au serveur MCP hébergé et les skills du watcher.
- Node.js
≥ 22.13.1uniquement si vous self-hébergez le serveur MCP en local (voie MCP manuel ci-dessous). Le connecteur hébergé n’exige que le client Claude Code.
1 · Installer le plugin
Le plugin est publié depuis une marketplace dédiée (badjilounes). Ajoutez-la, puis installez codboard — ou versionnez-le pour toute l’équipe.
# ajouter la marketplace, puis installer le pluginclaude plugin marketplace add badjilounes/claude-code-pluginsclaude plugin install codboard@badjilounes
2 · Autoriser la connexion
Le plugin connecte votre agent au serveur MCP hébergé (mcp.codboard.com) par OAuth : vous autorisez la connexion dans le navigateur, il n’y a aucune clé à coller. Gérez la connexion et la durée de session depuis Paramètres → Connexion.
Dans Claude Code, lancez /mcp : codboard doit apparaître connecté, avec les skills du watcher chargées. C’est le signal que le connecteur est en place.
3 · Relier le dépôt
Une fois par dépôt, lancez la commande /codboard:init. Elle résout projet, dépôt et workflow via MCP, puis écrit le pointeur .codboard/config.json à la racine. Relisez-le et committez-le : chaque session — et chaque équipier — se synchronise alors au même projet.
{ "projectId": "86682336-…", "projectName": "CodBoard", "workspaceId": "7155fd70-…", "repositoryId": "560ef5a6-…", "repositoryName": "board", "workflowId": "feabd57b-…", "boardUrl": "https://codboard.com/projects/86682336-…/board"}
Ce fichier ne contient aucune clé — l’authentification passe par OAuth. Committez-le. Seul le journal de session .codboard/session-state.json reste ignoré par git.
4 · Vérifier
Demandez à l’agent d’appeler list_projects (confirme la connexion) puis get_workflow (confirme la liaison au projet). Une installation saine renvoie vos statuts, transitions et playbook.
› get_workflow✓ statuts : todo → in_progress → in_review → blocked → done✓ transitions : 7 (gardées) playbook : 3 règles cadence : on_task_finished
Si get_workflow répond sans statuts ni transitions, aucun workflow n’est encore configuré pour le projet — les portes Testing et Rapport restent dormantes. Ouvrez le Workflow pour en définir un.
Connecter un autre client MCP
Pour la CI, une machine sans interface, ou un autre client que Claude Code, pointez le client sur le serveur HTTP hébergé et authentifiez-vous avec une clé API. Générez-la dans Paramètres → Connexion — elle n’est affichée qu’une fois (format codboard_sk_…), puis exportez-la en CODBOARD_API_KEY.
# CLIclaude mcp add --transport http codboard https://mcp.codboard.com/mcp \ --header "x-api-key: ${CODBOARD_API_KEY}" // …ou .mcp.json — le champ "type" est obligatoire{ "mcpServers": { "codboard": { "type": "http", "url": "https://mcp.codboard.com/mcp", "headers": { "x-api-key": "${CODBOARD_API_KEY}" } } }}
CODBOARD_API_KEY est une clé machine, propre à un utilisateur. Stockez-la dans l’environnement de l’agent — ne la committez jamais, ne l’exposez ni au navigateur ni au frontend. Vous pouvez la révoquer à tout moment dans les paramètres.