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). Committez le fichier ci-dessous — c’est l’install qui dure. La commande CLI à côté n’installe que sur votre machine, et sert à essayer le plugin.
// .claude/settings.json — versionné ; chaque session et chaque équipier démarre avec le plugin// /codboard:init l’écrit pour vous, en fusion avec le fichier que vous avez déjà{ "extraKnownMarketplaces": { "badjilounes": { "source": { "source": "github", "repo": "badjilounes/claude-code-plugins" } } }, "enabledPlugins": { "codboard@badjilounes": true }}
claude plugin install écrit dans ~/.claude/, et Claude Code web démarre chaque session dans un conteneur neuf — le plugin n’y est donc pas, aucun hook ne tourne, et rien ne signale l’absence. Un dépôt peut porter .codboard/config.json et n’être gardé par rien.
Les deux clés sont nécessaires : sans extraKnownMarketplaces, codboard@badjilounes ne résout pas et l’entrée dans enabledPlugins ne fait rien.
Dépôt déjà relié, mais sans ces clés ? Il ne se rattrape pas tout seul — relancez /codboard:init, qui écrit les clés manquantes en fusion, sans rien écraser, puis committez.
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", "repositoryId": "560ef5a6-…", "repositoryName": "board", "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
Deux signes : /plugin liste codboard, et l’agent annonce le pointeur CodBoard au démarrage sans qu’on le lui demande — c’est le hook SessionStart qui parle. Les outils MCP, eux, répondent même sans plugin : ils ne prouvent donc rien à ce sujet.
Sans plugin, aucun hook ne tourne : rien ne bloque un jalon non synchronisé, et l’agent vous rendra la main sur un merge que votre autoMergeMode autorisait pourtant.
Si get_workflow répond sans statuts ni transitions, aucun workflow n’est encore configuré pour le projet — les portes Preuves 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.