Pour les agents IA

Laissez votre agent améliorer le score

Agnes vous dit ce qui ne va pas dans votre code frontend. Connectez votre agent IA à Agnes : il peut lire le rapport, déterminer quelles corrections rapportent le plus de points et rédiger un plan avant de toucher à votre code.

Comment ça marche

  1. 1. Créez un jeton

    Dans l’application Agnes, allez dans Paramètres → Jetons d’API et créez un jeton. Il ne peut que lire, et uniquement les rapports de votre équipe.

    Ouvrir les paramètres de l’application →

  2. 2. Connectez votre agent

    Ajoutez le serveur MCP d’Agnes à votre agent avec le jeton, selon l’une des configurations ci-dessous.

  3. 3. Demandez un plan

    Demandez à votre agent de planifier comment améliorer le score. Il lit le dernier rapport, classe les corrections selon les points qu’elles rapportent et vous montre d’abord le plan.

    “Fais un plan pour améliorer le score Agnes de ce dépôt.”

Connectez votre agent

Agnes fait tourner un serveur MCP à l’adresse ci-dessous. Remplacez <your token> par le jeton de l’application.

Claude Code

claude mcp add --transport http agnes https://app.agnes.dev/api/mcp --header "Authorization: Bearer <your token>"

Cursor

Dans ~/.cursor/mcp.json

{
  "mcpServers": {
    "agnes": {
      "url": "https://app.agnes.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer <your token>"
      }
    }
  }
}

VS Code

Dans .vscode/mcp.json

{
  "servers": {
    "agnes": {
      "type": "http",
      "url": "https://app.agnes.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:agnes-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "agnes-token",
      "description": "Agnes API token",
      "password": true
    }
  ]
}

Autres clients

URL:    https://app.agnes.dev/api/mcp
Header: Authorization: Bearer <your token>
Transport: Streamable HTTP

Ajoutez le skill (facultatif)

Le skill donne à votre agent toute la démarche : trouver le projet, lire le rapport, classer les corrections, vérifier chaque constat dans votre code et rédiger un plan à approuver avant toute modification. Il fonctionne dans Claude Code, Claude et les autres agents qui prennent en charge les skills.

Télécharger le skill (zip) SKILL.md

Ou installez-le pour Claude Code en une commande :

mkdir -p ~/.claude/skills/agnes-improve-score && curl -fsSL https://agnes.dev/skills/agnes-improve-score/SKILL.md -o ~/.claude/skills/agnes-improve-score/SKILL.md

Ce que votre agent peut faire

list_projects
Les projets de votre équipe, avec leur dernier score.
get_report
Le score global, le score par catégorie, les constats par catégorie et les vérifications qui n’ont pas été exécutées.
rank_fixes
Les règles dont les constats coûtent le plus de points, avec le nombre de points que rapporterait la correction de chacune.
get_findings
Les constats eux-mêmes, 50 par page, par règle, catégorie, gravité ou dossier, avec le fichier, la ligne et un lien vers la règle.
get_scoring
Comment les constats deviennent des scores, pour que l’agent puisse expliquer son plan.

Sûr par conception

  • Lecture seule

    Les outils ne font que lire les rapports. Votre agent ne peut modifier ni les projets, ni les paramètres, ni rien d’autre dans Agnes.

  • Votre équipe uniquement

    Un jeton fonctionne pour l’équipe dans laquelle il a été créé, tant que vous en êtes membre.

  • Révocable à tout moment

    Révoquez un jeton dans les Paramètres et il cesse de fonctionner immédiatement. L’application indique quand chaque jeton a été utilisé pour la dernière fois.

  • Un plan avant tout changement

    La démarche demande à votre agent de rédiger un plan et d’attendre votre accord avant de modifier le code.