Voor AI-agents

Laat je agent de score verhogen

Agnes vertelt je wat er mis is met je frontendcode. Koppel je AI-agent aan Agnes, dan kan hij het rapport lezen, uitzoeken welke verbeteringen de meeste punten opleveren en een plan schrijven voordat hij je code aanraakt.

Zo werkt het

  1. 1. Maak een token

    Ga in de Agnes-app naar Instellingen → API-tokens en maak een token. Die kan alleen lezen, en alleen de rapporten van jouw team.

    Open de instellingen van de app →

  2. 2. Koppel je agent

    Voeg de MCP-server van Agnes met de token toe aan je agent, met een van de instellingen hieronder.

  3. 3. Vraag om een plan

    Vraag je agent om te plannen hoe de score omhoog kan. Hij leest het laatste rapport, zet de verbeteringen op volgorde van de punten die ze opleveren en laat je eerst het plan zien.

    “Maak een plan om de Agnes-score van deze repository te verhogen.”

Koppel je agent

Agnes draait een MCP-server op het adres hieronder. Vervang <your token> door de token uit de app.

Claude Code

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

Cursor

In ~/.cursor/mcp.json

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

VS Code

In .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
    }
  ]
}

Andere clients

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

Voeg de skill toe (optioneel)

De skill geeft je agent de hele werkwijze: het project vinden, het rapport lezen, de verbeteringen rangschikken, elke bevinding in je code controleren en een plan schrijven dat je goedkeurt voordat er iets verandert. Hij werkt in Claude Code, Claude en andere agents die skills ondersteunen.

Download de skill (zip) SKILL.md

Of installeer hem voor Claude Code met één opdracht:

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

Wat je agent kan

list_projects
De projecten van je team, met hun laatste score.
get_report
De totaalscore, de score per categorie, de bevindingen per categorie en welke controles niet zijn uitgevoerd.
rank_fixes
De regels waarvan de bevindingen de meeste punten kosten, met hoeveel punten het oplossen van elk oplevert.
get_findings
De bevindingen zelf, 50 per pagina, per regel, categorie, ernst of map, met bestand, regelnummer en een link naar de regel.
get_scoring
Hoe bevindingen scores worden, zodat de agent zijn plan kan uitleggen.

Veilig ontworpen

  • Alleen lezen

    De tools lezen alleen rapporten. Je agent kan geen projecten, instellingen of iets anders in Agnes wijzigen.

  • Alleen jouw team

    Een token werkt voor het team waarin hij is gemaakt, zolang je lid bent van dat team.

  • Altijd in te trekken

    Trek een token in via Instellingen en hij werkt direct niet meer. De app laat zien wanneer elke token voor het laatst is gebruikt.

  • Eerst een plan

    De werkwijze vraagt je agent een plan te schrijven en op je goedkeuring te wachten voordat hij code wijzigt.