- Accueil
- Intégrations
- AI CodeOps pour Claude Code
AI CodeOps pour Claude Code
Connectez Claude Code au serveur MCP d'AI CodeOps : confiez des tâches à des sessions sous barrières, vérifiez la barrière de livraison avant une fusion et lisez les constats, depuis votre terminal.
Claude Code est un agent de codage que vous exécutez dans votre terminal. AI CodeOps est une plateforme dans le navigateur où des agents IA planifient, écrivent, testent et relisent un changement, et où ce changement ne devient une pull request qu'une fois ses barrières qualité franchies et l'approbation d'une personne obtenue. Reliez les deux par le serveur MCP d'AI CodeOps, et Claude Code peut confier une tâche à une session AI CodeOps sous barrières, la suivre, lire ses constats et demander si une pull request peut être livrée.
Ce qu'AI CodeOps soumet à ses barrières, et ce qu'il laisse de côté
Soyez au clair là-dessus avant de configurer quoi que ce soit. AI CodeOps soumet à ses barrières les changements réalisés dans ses propres sessions. Une pull request que Claude Code ouvre de lui-même, depuis votre terminal ou depuis Claude Code GitHub Actions, est une pull request ordinaire : AI CodeOps ne la relit pas, et la vérification de livraison la refuse avec « No workflow runs found for … », parce qu'aucune session AI CodeOps ne l'a produite.
Il y a donc deux façons de faire passer le travail de Claude Code par les barrières :
- Confier la tâche. Depuis Claude Code, appelez
start_sessionavec la tâche. Une session AI CodeOps écrit le changement, exécute vos tests, le fait relire par plusieurs agents et n'ouvre la pull request que lorsque la barrière est franchie. - Vérifier avant de fusionner. Interrogez
check_release_gateà propos d'une pull request, ou lancez la même vérification dans la CI, afin que rien ne soit fusionné sans un verdict favorable.
Connecter Claude Code
- Dans AI CodeOps, créez une clé API de l'espace de travail sous Configure → API Keys. Elle commence par
sk-et n'est affichée qu'une fois. Pour permettre à Claude Code de lancer des sessions, choisissez Scope sur la clé et cochez Start sessions from the MCP server (/mcp). Cochez aussi Evidence packs from the MCP server (/mcp) si vous voulez les dossiers de preuves. Consultez clés API. - Ajoutez le serveur. La documentation MCP de Claude Code donne cette forme pour un serveur HTTP distant avec un en-tête :
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \ --header "Authorization: Bearer sk-..." - Exécutez
/mcpdans Claude Code.aicodeopsapparaît comme connecté, avec neuf outils.
Par défaut, le serveur est ajouté pour vous, dans le projet en cours uniquement. Pour le partager avec votre équipe, ajoutez --scope project : Claude Code écrit le serveur dans .mcp.json à la racine du dépôt. Claude Code développe les variables d'environnement dans ce fichier, de sorte que la clé reste hors du contrôle de version :
{
"mcpServers": {
"aicodeops": {
"type": "http",
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
}
}
}
Ce que Claude Code peut faire
| Outil | Ce qu'il fait |
|---|---|
list_projects | Liste les projets de l'espace de travail et leurs dépôts. |
start_session | Lance une session sur un projet avec une tâche, par défaut le workflow plan-build-review-test. |
get_session | Le statut d'une session, ses étapes, la pull request qu'elle a ouverte et son changement. |
check_release_gate | Indique si une pull request ou un commit peut être livré, avec les motifs. |
list_findings | Les constats de sécurité et de qualité, filtrés par gravité ou par catégorie. |
get_evidence_pack | Le dossier de preuves signé d'un changement. |
list_builds | Les builds récents : ce qui a lancé chacun, sa branche et son commit, et comment il s'est terminé. |
get_build | Un build : l'étape où il a échoué et la fin de sa sortie. |
list_saved_builds | Les builds que l'espace de travail conserve, et ce qui lance chacun. |
Chaque outil agit au nom du créateur de la clé, en passant par les mêmes contrôles que la console : son rôle, le budget de l'espace de travail et la limite de travaux en cours de l'agent. Une session lancée depuis Claude Code ouvre sa pull request comme n'importe quelle autre : les approbations et la barrière de livraison s'appliquent donc toujours. La référence complète se trouve dans le guide du serveur MCP.
Ce que vous pouvez demander à Claude Code une fois connecté :
List my AI CodeOps projects, then start a session on the api project to add rate limiting to the login route.
Check on that session until it finishes, and tell me what the reviewers found.
Ask the AI CodeOps release gate whether https://github.com/acme/api/pull/42 may ship, and list the reasons.
Soumettre les fusions à la barrière dans la CI
La vérification de livraison est aussi une API HTTP : la CI peut donc poser la même question avant une fusion. Ce job GitHub Actions échoue lorsque la barrière refuse la pull request :
name: AI CodeOps release gate
on: pull_request
jobs:
gate:
runs-on: ubuntu-latest
steps:
- name: Ask the release gate
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $AICODEOPS_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\"}" > gate.json
jq -r '.summary' gate.json
jq -e '.allowed == true' gate.json
Le point de terminaison répond 200 avec allowed à true ou false, un résumé et des motifs. Vous pouvez ajouter un seuil de couverture, des workflows requis, des licences interdites et un déploiement en staging requis ; les champs sont décrits sur la page de l'API. Gardez à l'esprit ce que cela signifie en tant que vérification requise : une pull request qu'aucune session AI CodeOps n'a produite est refusée, y compris celle que Claude Code a ouverte de lui-même.
Limites
- 120 requêtes MCP par minute depuis une même adresse ; la vérification en CI en autorise 60 par minute et par espace de travail.
- Le serveur MCP est sans état et n'envoie aucune notification : Claude Code interroge donc régulièrement
get_sessionpour suivre une session. - Clés API de l'espace de travail uniquement. La connexion par OAuth n'est pas encore prise en charge.
Pour commencer
- Créez un compte gratuit : AI CodeOps est en bêta ouverte et fonctionne dans votre navigateur.
- Connectez votre hébergeur Git et créez un projet, à l'aide du guide de démarrage rapide.
- Créez une clé API et ajoutez le serveur à Claude Code comme ci-dessus.
Vous utilisez un autre agent de codage ? Consultez AI CodeOps pour Codex, Cursor ou GitHub Copilot. Pour l'autre sens, où les sessions AI CodeOps appellent vos serveurs MCP, consultez AI CodeOps et MCP.
Questions fréquentes
AI CodeOps relit-il les pull requests ouvertes par Claude Code ?
Non. AI CodeOps soumet à ses barrières les changements réalisés par ses propres sessions. Une pull request que Claude Code ouvre de lui-même n'est pas relue, et la vérification de livraison la refuse parce qu'aucune session ne l'a produite. Pour soumettre le travail aux barrières, confiez la tâche à une session AI CodeOps depuis Claude Code.
Comment Claude Code s'authentifie-t-il auprès d'AI CodeOps ?
Avec une clé API de l'espace de travail envoyée dans un en-tête Bearer. La clé agit au nom du membre qui l'a créée, avec le rôle et le budget de ce membre. La connexion par OAuth n'est pas encore prise en charge.
Claude Code peut-il lancer des sessions sans me demander ?
Seulement avec une clé dont le périmètre inclut Start sessions from the MCP server. Une clé sans périmètre peut utiliser les sept outils de lecture, et rien de plus.
Puis-je partager la configuration avec mon équipe ?
Oui. Ajoutez le serveur avec --scope project et Claude Code l'écrit dans .mcp.json à la racine du dépôt. Gardez la clé elle-même dans une variable d'environnement, pas dans le fichier.