Référence
Les valeurs exactes auxquelles l’agent obéit : le pointeur de dépôt, les variables d’environnement, et les outils MCP du cycle de vie. La configuration se lit en trois endroits — le workflow (statuts, transitions et leurs preuves), le projet (rapport, file de travail, veille) et le dépôt (politique de merge, technologie) — chacun détaillé dans sa rubrique.
Le fichier `.codboard/config.json`
Écrit par /codboard:init à la racine du dépôt, versionné, sans secret (l’authentification passe par OAuth). Il relie le dépôt à un projet CodBoard.
| Champ | Requis | Description |
|---|---|---|
projectId | oui | UUID du projet CodBoard. |
repositoryId | oui | UUID du dépôt rattaché — ce contre quoi l’agent écrit ses tâches. |
boardUrl | confort | Lien vers le board, pour l’ouvrir depuis l’agent. |
projectName | confort | Nom lisible du projet. |
repositoryName | confort | Nom lisible du dépôt. |
Aucune clé, et aucun champ `sync` : la « synchronisation forte » est le mécanisme des hooks du plugin, pas une valeur du fichier. Seul le journal .codboard/session-state.json reste ignoré par git.
Variables d’environnement
| Variable | Rôle |
|---|---|
CODBOARD_API_KEY | Clé machine par utilisateur (format codboard_sk_…) pour la voie MCP manuelle ou la CI. Envoyée en header x-api-key. Inutile avec le connecteur OAuth. |
MCP_PUBLIC_URL | Point d’entrée du serveur MCP hébergé — https://mcp.codboard.com/mcp en production. Utile surtout si vous self-hébergez le serveur. |
Outils MCP du cycle de vie
Le serveur expose soixante-dix outils, annoncés à votre client sous Read-only tools et Write/delete tools. Voici le cœur du cycle de vie — ceux qu’un agent-watcher enchaîne, de la lecture du workflow au rapport.
| Outil | Rôle |
|---|---|
get_workflow | Lit le workflow qui gouverne un ticket : statuts, transitions avec les preuves qu’elles exigent, playbook. |
create_request | Ouvre une request rattachée à un ticket (référencé par URL). |
create_task | Crée une task livrable sous une request. |
start_execution | Démarre le travail de l’agent ; passe la request en in_progress. |
set_task_branch | Attache la branche git suivie pour la task. |
change_task_status | Fait avancer la task dans les statuts du workflow. |
set_task_pull_request | Attache la PR et son état (draft / open / merged / closed). |
attach_change_request | Attache la PR comme artefact change_request (garde in_review). |
set_task_technologies | Déclare ce que le changement touche — obligatoire sur un dépôt monorepo avant qu’une preuve puisse être jugée. |
add_test_step | Ajoute une étape de plan de test avec sa preuve : capture, vidéo ou contenu enregistré. |
create_media_upload | Héberge une capture ou vidéo et renvoie une URL publique. |
record_work_note | Note ultra-courte started/finished — nourrit le rapport. |
upsert_report | Crée ou met à jour le rapport daté du jour. |
complete_execution | Clôt l’exécution ; passe la request en completed. |
Tous les outils du cycle de vie sont disponibles sur le serveur hébergé (HTTP) comme en local (stdio). Seuls quelques outils à accès machine (ex. capture de preuves git locales) sont réservés au transport stdio.