Dokümanlar

AppSafe'i AI kodlama aracından kullan

AppSafe'i Claude Code, Cursor veya başka herhangi bir MCP istemcisine bağla ya da REST API'yi kendi script'lerinden çağır. Ajanın doğrulanmış bir siteyi tarayabilir, her bulgunun düzeltme prompt'unu okuyabilir, düzeltmeyi uygulayıp yeniden kontrol edebilir; hepsi tek bir döngüde.

API, MCP sunucusu ve rapor dışa aktarımları Pro, Agency ve Team planlarına dahildir.

1. API anahtarı oluştur

Panel → Hesap → API anahtarları bölümüne git, anahtara bir ad ver ve kopyala. Anahtar yalnızca bir kez gösterilir ve AppSafe sadece hash değerini saklar. Anahtarlar appsafe_ ile başlar ve yalnızca kendi sitelerinde çalışır.

2. MCP sunucusunu bağla

Sunucu aşağıdaki URL'de Streamable HTTP kullanır ve API anahtarınla bearer token olarak kimlik doğrular. YOUR_KEY kısmını kendi anahtarınla değiştir.

https://appsafe.dev/api/mcp

Claude Code

Bunu bir kez çalıştır ya da JSON'u projendeki .mcp.json dosyasına ekle:

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

Bunu ~/.cursor/mcp.json dosyasına veya projendeki .cursor/mcp.json dosyasına ekle:

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

Diğer MCP istemcileri: aynı URL'yi ve Authorization header'ını kullan.

Araçlar

Döngü

  1. Ajanından siteni AppSafe ile taramasını iste.
  2. Markdown raporunu okur ve her düzeltme prompt'unu en ciddiden başlayarak uygular.
  3. Değişiklikleri sen deploy edersin, çünkü AppSafe canlı siteyi tarar.
  4. Ajan her bulguyu düzeltilene kadar yeniden kontrol eder.

Örnek prompt: “myapp.com'u AppSafe ile tara, kritik ve yüksek bulguları düzelt ve ben deploy ettikten sonra yeniden kontrol et.”

REST API

Base URL: https://appsafe.dev/api/v1. Anahtarını Authorization header'ında Bearer YOUR_KEY olarak gönder. OpenAPI spesifikasyonu tüm endpoint'leri açıklar.

EndpointNe yapar
GET /sitesSitelerini listele
POST /scansDoğrulanmış bir sitenin tam taramasını başlat (siteId veya url)
POST /sites/{id}/scansTek bir siteyi yeniden tara
GET /scans/{id}Tarama durumu, skor, not ve önem derecesi sayıları
GET /scans/{id}/findingsKanıt, düzeltme prompt'u ve yeniden kontrol ref'i ile bulgular
GET /scans/{id}/report?format=markdownmarkdown, json veya sarif formatında rapor
POST /findings/recheckTek bir bulguyu ref'i ile yeniden kontrol et

Örnek

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"

Rapor dışa aktarımları

Tamamlanan her tarama, AI ajanları için yazılmış Markdown (her bulgu için kanıt, etkilenen URL, düzeltme prompt'u ve nasıl doğrulanacağı) veya kod tarama araçları için SARIF 2.1.0 olarak dışa aktarılabilir. Bunları panelindeki taramadan indir ya da rapor endpoint'ini kullan.

Limitler ve güvenlik