Doku

Nutze AppSafe aus deinem KI-Coding-Tool

Verbinde AppSafe mit Claude Code, Cursor oder einem anderen MCP-Client, oder rufe die REST API aus deinen eigenen Skripten auf. Dein Agent kann eine verifizierte Website scannen, den Fix-Prompt jedes Befunds lesen, den Fix anwenden und erneut prüfen – alles in einer Schleife.

Die API, der MCP-Server und Berichtsexporte sind in den Tarifen Pro, Agency und Team enthalten.

1. API-Schlüssel erstellen

Gehe zu Dashboard → Konto → API-Schlüssel, gib einem Schlüssel einen Namen und kopiere ihn. Er wird nur einmal angezeigt, und AppSafe speichert nur einen Hash. Schlüssel beginnen mit appsafe_ und funktionieren nur für deine eigenen Websites.

2. MCP-Server verbinden

Der Server nutzt Streamable HTTP unter der unten stehenden URL und authentifiziert sich mit deinem API-Schlüssel als Bearer-Token. Ersetze YOUR_KEY durch deinen Schlüssel.

https://appsafe.dev/api/mcp

Claude Code

Führe dies einmal aus oder füge das JSON in .mcp.json in deinem Projekt ein:

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

Füge dies in ~/.cursor/mcp.json oder in .cursor/mcp.json in deinem Projekt ein:

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

Andere MCP-Clients: Verwende dieselbe URL und denselben Authorization-Header.

Tools

Die Schleife

  1. Bitte deinen Agent, deine Website mit AppSafe zu scannen.
  2. Er liest den Markdown-Bericht und wendet jeden Fix-Prompt an, die schwerwiegendsten zuerst.
  3. Du deployst die Änderungen, denn AppSafe scannt die Live-Website.
  4. Der Agent prüft jeden Befund erneut, bis er behoben ist.

Beispiel-Prompt: „Scanne myapp.com mit AppSafe, behebe die kritischen und hohen Befunde und prüfe sie erneut, nachdem ich deployt habe.“

REST API

Basis-URL: https://appsafe.dev/api/v1. Sende deinen Schlüssel im Authorization-Header als Bearer YOUR_KEY. Die OpenAPI-Spezifikation beschreibt jeden Endpunkt.

EndpunktFunktion
GET /sitesDeine Websites auflisten
POST /scansVollständigen Scan einer verifizierten Website starten (siteId oder url)
POST /sites/{id}/scansEine Website erneut scannen
GET /scans/{id}Scan-Status, Score, Note und Anzahl der Befunde nach Schweregrad
GET /scans/{id}/findingsBefunde mit Nachweis, Fix-Prompt und ref für den Recheck
GET /scans/{id}/report?format=markdownBericht als markdown, json oder sarif
POST /findings/recheckEinen Befund anhand seiner ref erneut prüfen

Beispiel

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"

Berichtsexporte

Jeder abgeschlossene Scan lässt sich als Markdown für KI-Agents exportieren (Nachweis, betroffene URL, Fix-Prompt und wie du jeden Befund überprüfst) oder als SARIF 2.1.0 für Code-Scanning-Tools. Lade sie beim jeweiligen Scan in deinem Dashboard herunter oder nutze den Berichts-Endpunkt.

Limits und Sicherheit