Agent IA et API

Faillo se connecte à votre agent IA de code. L'agent lit le rapport de sécurité de votre site, corrige les failles dans le code, puis relance un scan pour vérifier que tout est réglé. Une API REST donne le même accès à vos propres outils.

Créer un compte gratuit

1. Créer une clé API

Dans Paramètres, rubrique « Agent IA », donnez un nom à la clé puis créez-la. Elle ne s'affiche qu'une fois : copiez-la tout de suite. Vous pouvez la supprimer à tout moment, l'agent perd alors l'accès.

2. Ajouter Faillo à votre agent IA

Faillo est un serveur MCP (Model Context Protocol) accessible en HTTP. Ajoutez cette configuration dans les réglages MCP de votre agent IA :

{
  "mcpServers": {
    "faillo": {
      "type": "http",
      "url": "https://faillo.akolads.com/mcp",
      "headers": {
        "Authorization": "Bearer fl_votre_cle"
      }
    }
  }
}

3. Demander la correction

Par exemple :

Corrige les failles de sécurité de mon-site.fr signalées par Faillo, puis relance un scan pour vérifier.

L'agent utilise ces outils :

OutilCe qu'il fait
lister_sitesListe les sites du compte Faillo avec leur dernière note de sécurité, le nombre de failles par gravité et les droits (rapport acheté, suivi mensuel).
rapport_securiteRapport du dernier scan d'un site, en Markdown avec les consignes de correction : chaque faille avec sa gravité, la preuve trouvée et le correctif (scan complet), ou la note et les catégories (scan gratuit).
lancer_scanRelance un scan du site pour vérifier les corrections, une fois celles-ci en ligne. Les scans sont limités (quotas de l'offre) : à n'utiliser qu'après avoir déployé des corrections.
signaler_correctionsEnvoie à Faillo le résultat du travail sur les failles du dernier scan complet : pour chaque faille (identifiant du rapport, ex. no-csp), son statut et ce qui a été fait. Signalez aussi les faux positifs et les correctifs impossibles à appliquer, avec la raison. N'y mettez ni code, ni mot de passe, ni clé.
etat_scanÉtat du dernier scan d'un site : en attente, en cours, terminé (avec la note et les failles par gravité) ou en échec.

Ce que l'agent peut voir et faire

API REST

Toutes les requêtes portent l'en-tête Authorization: Bearer fl_votre_cle. Le site se désigne par son adresse (mon-site.fr) ou son identifiant. Limite : 120 requêtes par minute.

RequêteRéponse
GET /api/v1/sitesVos sites, leur dernière note et leurs failles par gravité
GET /api/v1/sites/mon-site.fr/rapportLe rapport du dernier scan en JSON
GET /api/v1/sites/mon-site.fr/rapport.mdLe même rapport en Markdown, avec les consignes de correction pour une IA
POST /api/v1/sites/mon-site.fr/scansLance un scan de vérification (selon vos quotas)
GET /api/v1/sites/mon-site.fr/scanL'état du dernier scan
POST /api/v1/sites/mon-site.fr/retoursRetours sur les failles du dernier scan complet : {"retours": [{"id": "no-csp", "statut": "corrigee", "action": "...", "remarque": "..."}]}

Exemple :

curl -H "Authorization: Bearer fl_votre_cle" https://faillo.akolads.com/api/v1/sites/mon-site.fr/rapport.md

En cas d'erreur (clé invalide, site introuvable, quota atteint), la réponse contient un champ erreur qui explique quoi faire.

Sécurité

Seule une empreinte de votre clé est enregistrée : Faillo ne peut pas vous la renvoyer. Ne la placez jamais dans le code d'un site ni dans un dépôt partagé ; gardez-la dans les réglages de votre agent IA ou de vos outils.