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. Les quatre zones de configuration — workflow, automatisation, rapport, testing — sont détaillées dans leurs propres rubriques.
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é. |
workflowId | oui | UUID du workflow appliqué au projet. |
boardUrl | oui | Lien vers le board, pour l’ouvrir depuis l’agent. |
projectName | confort | Nom lisible du projet. |
repositoryName | confort | Nom lisible du dépôt. |
workspaceId | confort | UUID du workspace propriétaire. |
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 60+ outils. 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 la config qui fait foi : statuts, transitions, playbook, automatisation, testing, rapport. |
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). |
add_test_step | Ajoute une étape de plan de test, avec captures/vidéo optionnelles. |
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.