Documentación

Usa AppSafe desde tu herramienta de programación con IA

Conecta AppSafe a Claude Code, Cursor o cualquier otro cliente MCP, o llama a la REST API desde tus propios scripts. Tu agente puede escanear un sitio verificado, leer el prompt de corrección de cada hallazgo, aplicar la corrección y volver a comprobarlo, todo en un mismo ciclo.

La API, el servidor MCP y las exportaciones de informes están incluidos en los planes Pro, Agency y Team.

1. Crea una clave de API

Ve a Panel → Cuenta → Claves de API, ponle nombre a una clave y cópiala. Solo se muestra una vez y AppSafe guarda únicamente un hash. Las claves empiezan por appsafe_ y solo funcionan en tus propios sitios.

2. Conecta el servidor MCP

El servidor usa Streamable HTTP en la URL de abajo y se autentica con tu clave de API como token bearer. Sustituye YOUR_KEY por tu clave.

https://appsafe.dev/api/mcp

Claude Code

Ejecuta esto una vez, o añade el JSON a .mcp.json en tu proyecto:

claude mcp add --transport http appsafe https://appsafe.dev/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"
{
  "mcpServers": {
    "appsafe": {
      "type": "http",
      "url": "https://appsafe.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Cursor

Añade esto a ~/.cursor/mcp.json, o a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "appsafe": {
      "url": "https://appsafe.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Otros clientes MCP: usa la misma URL y el mismo encabezado Authorization.

Herramientas

El ciclo

  1. Pide a tu agente que escanee tu sitio con AppSafe.
  2. Lee el informe en Markdown y aplica cada prompt de corrección, empezando por los más graves.
  3. Tú despliegas los cambios, porque AppSafe escanea el sitio en producción.
  4. El agente vuelve a comprobar cada hallazgo hasta que esté corregido.

Prompt de ejemplo: «Escanea myapp.com con AppSafe, corrige los hallazgos críticos y altos, y vuelve a comprobarlos cuando despliegue.»

REST API

URL base: https://appsafe.dev/api/v1. Envía tu clave en el encabezado Authorization como Bearer YOUR_KEY. La especificación OpenAPI describe todos los endpoints.

EndpointQué hace
GET /sitesLista tus sitios
POST /scansInicia un escaneo completo de un sitio verificado (siteId o url)
POST /sites/{id}/scansVuelve a escanear un sitio
GET /scans/{id}Estado del escaneo, puntuación, calificación y recuento por severidad
GET /scans/{id}/findingsHallazgos con evidencia, prompt de corrección y ref para volver a comprobar
GET /scans/{id}/report?format=markdownInforme en markdown, json o sarif
POST /findings/recheckVuelve a comprobar un hallazgo por su ref

Ejemplo

curl -X POST https://appsafe.dev/api/v1/scans \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://myapp.com"}'

curl "https://appsafe.dev/api/v1/scans/SCAN_ID/report?format=markdown" \
  -H "Authorization: Bearer YOUR_KEY"

Exportación de informes

Cada escaneo completado puede exportarse en Markdown escrito para agentes de IA (evidencia, URL afectada, prompt de corrección y cómo verificar cada hallazgo) o en SARIF 2.1.0 para herramientas de análisis de código. Descárgalos desde el escaneo en tu panel o usa el endpoint de informes.

Límites y seguridad