Para agentes de IA

Deja que tu agente suba la puntuación

Agnes te dice qué falla en tu código frontend. Conecta tu agente de IA a Agnes y podrá leer el informe, averiguar qué correcciones dan más puntos y escribir un plan antes de tocar tu código.

Cómo funciona

  1. 1. Crea un token

    En la app de Agnes, ve a Ajustes → Tokens de API y crea un token. Solo puede leer, y solo los informes de tu equipo.

    Abrir los ajustes de la app →

  2. 2. Conecta tu agente

    Añade el servidor MCP de Agnes a tu agente con el token, con una de las configuraciones de abajo.

  3. 3. Pide un plan

    Pide a tu agente que planifique cómo subir la puntuación. Lee el último informe, ordena las correcciones por los puntos que dan y te muestra primero el plan.

    “Haz un plan para subir la puntuación de Agnes de este repositorio.”

Conecta tu agente

Agnes tiene un servidor MCP en la dirección de abajo. Sustituye <your token> por el token de la app.

Claude Code

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

Cursor

En ~/.cursor/mcp.json

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

VS Code

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

Otros clientes

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

Añade la skill (opcional)

La skill le da a tu agente todo el proceso: encontrar el proyecto, leer el informe, ordenar las correcciones, comprobar cada hallazgo en tu código y escribir un plan para que lo apruebes antes de cualquier cambio. Funciona en Claude Code, Claude y otros agentes que admiten skills.

Descargar la skill (zip) SKILL.md

O instálala para Claude Code con un solo comando:

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

Qué puede hacer tu agente

list_projects
Los proyectos de tu equipo, con su última puntuación.
get_report
La puntuación global, la puntuación por categoría, los hallazgos por categoría y qué comprobaciones no se ejecutaron.
rank_fixes
Las reglas cuyos hallazgos cuestan más puntos, con cuántos puntos daría corregir cada una.
get_findings
Los hallazgos en sí, 50 por página, por regla, categoría, gravedad o carpeta, con archivo, línea y un enlace a la regla.
get_scoring
Cómo los hallazgos se convierten en puntuaciones, para que el agente pueda explicar su plan.

Seguro por diseño

  • Solo lectura

    Las herramientas solo leen informes. Tu agente no puede cambiar proyectos, ajustes ni nada más en Agnes.

  • Solo tu equipo

    Un token funciona para el equipo en el que se creó, mientras seas miembro de él.

  • Revocable en cualquier momento

    Revoca un token en Ajustes y deja de funcionar al momento. La app muestra cuándo se usó cada token por última vez.

  • Primero un plan

    El proceso pide a tu agente que escriba un plan y espere tu aprobación antes de cambiar el código.