ドキュメント

AIコーディングツールからAppSafeを使う

AppSafeをClaude Code、Cursor、その他のMCPクライアントに接続するか、独自のスクリプトからREST APIを呼び出せます。エージェントは確認済みサイトをスキャンし、各指摘の修正プロンプトを読み、修正を適用して再チェックするまでを、1つのループで行えます。

API、MCPサーバー、レポートのエクスポートは、Pro、Agency、Teamプランに含まれています。

1. APIキーを作成する

ダッシュボード → アカウント → APIキーを開き、キーに名前を付けてコピーします。キーは一度しか表示されず、AppSafeはそのハッシュだけを保存します。キーは appsafe_ で始まり、ご自身のサイトでのみ使用できます。

2. MCPサーバーに接続する

サーバーは下記のURLでStreamable HTTPを使用し、APIキーをBearerトークンとして認証します。YOUR_KEY をご自身のキーに置き換えてください。

https://appsafe.dev/api/mcp

Claude Code

これを一度実行するか、プロジェクトの .mcp.json にJSONを追加します：

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

これを ~/.cursor/mcp.json、またはプロジェクトの .cursor/mcp.json に追加します：

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

その他のMCPクライアント：同じURLとAuthorizationヘッダーを使用してください。

ツール

ループ

  1. エージェントに、AppSafeでサイトをスキャンするよう依頼します。
  2. エージェントがMarkdownレポートを読み、重大度の高いものから順に各修正プロンプトを適用します。
  3. AppSafeは公開中のサイトをスキャンするため、変更はあなたがデプロイします。
  4. エージェントが各指摘を修正されるまで再チェックします。

プロンプトの例：「AppSafeでmyapp.comをスキャンして、重大と高の指摘を修正し、デプロイ後に再チェックして。」

REST API

ベースURL：https://appsafe.dev/api/v1。キーはAuthorizationヘッダーで Bearer YOUR_KEY として送信します。すべてのエンドポイントはOpenAPI仕様に記載されています。

エンドポイント内容
GET /sitesサイト一覧を取得
POST /scans確認済みサイトのフルスキャンを開始（siteId または url）
POST /sites/{id}/scans1つのサイトを再スキャン
GET /scans/{id}スキャンの状態、スコア、グレード、重大度別の件数
GET /scans/{id}/findings証拠、修正プロンプト、再チェック用 ref を含む指摘
GET /scans/{id}/report?format=markdownmarkdown、json、sarif 形式のレポート
POST /findings/recheckref を指定して1つの指摘を再チェック

例

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"

レポートのエクスポート

完了したスキャンはすべて、AIエージェント向けに書かれたMarkdown（各指摘の証拠、影響を受けるURL、修正プロンプト、確認方法）、またはコードスキャンツール向けのSARIF 2.1.0としてエクスポートできます。ダッシュボードのスキャンからダウンロードするか、レポートのエンドポイントを使用してください。

制限と安全性