Docs

Utilisez AppSafe depuis votre outil de codage IA

Connectez AppSafe à Claude Code, Cursor ou tout autre client MCP, ou appelez la REST API depuis vos propres scripts. Votre agent peut scanner un site vérifié, lire le prompt de correction de chaque problème, appliquer la correction et la revérifier, le tout dans une seule boucle.

L’API, le serveur MCP et les exports de rapports sont inclus dans les plans Pro, Agency et Team.

1. Créez une clé API

Allez dans Tableau de bord → Compte → Clés API, nommez une clé et copiez-la. Elle n’est affichée qu’une seule fois, et AppSafe n’en stocke qu’un hash. Les clés commencent par appsafe_ et ne fonctionnent que sur vos propres sites.

2. Connectez le serveur MCP

Le serveur utilise Streamable HTTP à l’URL ci-dessous et s’authentifie avec votre clé API en tant que bearer token. Remplacez YOUR_KEY par votre clé.

https://appsafe.dev/api/mcp

Claude Code

Exécutez ceci une fois, ou ajoutez le JSON à .mcp.json dans votre projet :

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

Ajoutez ceci à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans votre projet :

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

Autres clients MCP : utilisez la même URL et le même en-tête Authorization.

Outils

La boucle

  1. Demandez à votre agent de scanner votre site avec AppSafe.
  2. Il lit le rapport Markdown et applique chaque prompt de correction, en commençant par les plus graves.
  3. Vous déployez les modifications, car AppSafe scanne le site en production.
  4. L’agent revérifie chaque problème jusqu’à ce qu’il soit corrigé.

Exemple de prompt : « Scanne myapp.com avec AppSafe, corrige les problèmes critiques et élevés, puis revérifie-les après mon déploiement. »

REST API

URL de base : https://appsafe.dev/api/v1. Envoyez votre clé dans l’en-tête Authorization sous la forme Bearer YOUR_KEY. La spécification OpenAPI décrit chaque endpoint.

EndpointRôle
GET /sitesLister vos sites
POST /scansLancer un scan complet d’un site vérifié (siteId ou url)
POST /sites/{id}/scansRescanner un site
GET /scans/{id}Statut du scan, score, note et nombre de problèmes par gravité
GET /scans/{id}/findingsProblèmes avec preuves, prompt de correction et ref de revérification
GET /scans/{id}/report?format=markdownRapport en markdown, json ou sarif
POST /findings/recheckRevérifier un problème via sa ref

Exemple

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"

Exports de rapports

Chaque scan terminé peut être exporté en Markdown rédigé pour les agents IA (preuve, URL concernée, prompt de correction et méthode de vérification pour chaque problème) ou en SARIF 2.1.0 pour les outils d’analyse de code. Téléchargez-les depuis le scan dans votre tableau de bord, ou utilisez l’endpoint de rapport.

Limites et sécurité