Arcjet - MCP Server

Arcjet - MCP サーバー

Arcjet は、コードとともに提供されるランタイムセキュリティプラットフォームです。Arcjet の AI セキュリティ構成要素を使って、利用上限を設定し、プロンプトインジェクションを阻止し、ボットを検知し、個人情報を保護できます。

Arcjet MCP サーバーは、AI コーディングアシスタントにセキュリティエンジニアのスキルを提供します。Arcjet MCP サーバーに接続すると、AI コーディングツールで次のことができます。

• 所属するチームを一覧表示します。
• チーム内のサイトを一覧表示します。
• チーム内にサイトを新規作成します。
• プロジェクトで使用するサイトキー（ARCJET_KEY）を取得します。
• オプションのフィルタリングを使って、サイトが受信したリクエストを一覧表示します。
• 判定の理由を説明し、リクエストが許可または拒否された理由を理解します。
• ヘッダー、実行されたルール、判定情報などのリクエストの詳細を取得します。
• 現在の請求期間におけるサイトのクォータ使用状況と上限を取得します。
• トラフィックの傾向、拒否率、上位のパス、上位の IP を分析します。
• 現在のトラフィックを前の期間と比較して異常を検知します。
• 地域、脅威インテリジェンス、リクエストアクティビティを使ってIP を調査します。
• ルールを本番環境に適用する前に、ドライランの影響を分析します。
• トラフィック、脅威、異常、推奨事項をまとめたセキュリティブリーフィングを取得します。
• サイトに設定されたリモートルールを一覧表示します。
• DRY_RUN または LIVE モードでリモートルールを作成します。コードを変更せずにルールを設定できます。
• ルール設定全体を置き換えてリモートルールを更新します。
• 評価を直ちに停止するためにリモートルールを削除します。
• 検証後にリモートルールを DRY_RUN から LIVE に昇格します。

MCP サーバーは次の場所で利用できます。

https://api.arcjet.com/mcp

OAuth ベースの認証を使用し、最新の MCP 認可 仕様および Streamable HTTP 仕様を実装しています。

対応クライアント

最新の MCP 仕様に対応し、 Streamable HTTP トランスポート およびOAuth 認可 をサポートするクライアントであれば利用できます。以下が含まれます。

• ChatGPT
• Claude Code
• Claude Desktop
• Cursor
• Copilot 搭載の VS Code
• Windsurf
• MCP 仕様を実装するその他多くのクライアント。

セットアップ

ChatGPT

1. ChatGPT で Settings に移動します。
2. Connectors に移動し、Add connection を選択します。
3. サーバー URL として https://api.arcjet.com/mcp を入力します。
4. 認証に OAuth を選択します。
5. Create をクリックします。

ChatGPT が OAuth フローを自動的に処理します。

Claude Code

claude mcp add arcjet --transport http https://api.arcjet.com/mcp

初回接続時に、Claude Code が OAuth 認証用のブラウザーを開きます。 認証後、/mcp コマンドを使って接続を確認できます。

Claude Desktop

リモート MCP 接続は、[Pro、Max、 Team、および Enterprise プラン](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)をご利用のユーザー向けに、Claude Desktop で利用できます。

1. サイドバーで Settings を開きます。
2. Connectors に移動し、Add custom connector を選択します。
3. コネクターを設定します。
   • Name: Arcjet
   • URL: https://api.arcjet.com/mcp

Cursor

プロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "arcjet": {
      "type": "streamable-http",
      "url": "https://api.arcjet.com/mcp"
    }
  }
}

サーバーを追加すると、Cursor に Needs login のプロンプトが表示されます。これをクリックして、Cursor が Arcjet アカウントにアクセスすることを認可します。

Copilot を使用した VS Code

プロジェクトまたはユーザー設定の .vscode/mcp.json に追加します。

{
  "servers": {
    "arcjet": {
      "type": "http",
      "url": "https://api.arcjet.com/mcp"
    }
  }
}

または、コマンドパレットから追加します。

1. コマンドパレットを開きます（Windows/Linux では Ctrl+Shift+P、macOS では Cmd+Shift+P）。
2. MCP: Add Server を実行します。
3. HTTP を選択します。
4. URL を入力します：https://api.arcjet.com/mcp
5. 名前を入力します：Arcjet
6. お好みに応じて Workspace または User を選択します。

初回使用時に、VS Code から OAuth による認証を求められます。

Windsurf

mcp_config.json ファイルに追加します。

{
  "mcpServers": {
    "arcjet": {
      "serverUrl": "https://api.arcjet.com/mcp"
    }
  }
}

詳しくは、Windsurf MCP のドキュメントをご覧ください。

利用可能なツール

接続すると、AI アシスタントで以下のツールを利用できます。

• list-teams — 認証済みユーザーが所属するチームを一覧表示します。
• list-sites — 指定したチーム内のサイトを一覧表示します。
• create-site — 指定したチーム内に新しいサイトを作成します。
• get-site-key — 特定のサイトの SDK キー（ARCJET_KEY）を返します。
• list-requests — サイトの最近のリクエストを一覧表示します。結論（ALLOW、DENY、ERROR）によるフィルタリングとページネーションに対応しています。
• get-request-details — ヘッダー、実行されたルール、判定情報など、特定のリクエストの詳細をすべて返します。
• explain-decision — Arcjet が特定のリクエストを許可または拒否した理由を説明します。自然言語による概要、ルールごとの詳細、推奨される次の手順を返します。
• get-site-quota — 現在の請求期間におけるサイトのクォータ使用量と上限を返します。
• analyze-traffic — 指定期間のリクエストトラフィックを分析します。リクエスト総数、拒否数、拒否率、アクセス数の多いパスと IP、拒否理由の上位項目、前期間との傾向比較を返します。
• get-anomalies — 現在のトラフィックを前期間と比較して、通常とは異なるセキュリティパターンを検出します。トラフィックの急増、地理的な変化、新たな脅威活動、新たなボットのシグネチャ、リスクの上昇、不審な IP のパターンを特定します。
• investigate-ip — サイトに関連付けて IP アドレスを調査します。位置情報、脅威インテリジェンス（ネットワークの種類、脅威活動、エンティティ分類、リスクレベル）、およびその IP の最近のリクエスト活動（結論の内訳、拒否理由、対象となったパス、日ごとのタイムライン）を返します。
• get-dry-run-impact — ドライラン中のルールを本番に昇格した場合の影響を分析します。各ルールタイプで、現在許可されているリクエストのうちブロックされるものの件数、最も影響を受ける IP、誤検知の推定値を表示します。
• get-security-briefing — 包括的なセキュリティ概要を返します。有効なルールの概要、トラフィック分析、脅威インテリジェンス、異常検出、ドライランからの昇格準備状況、クォータ状況、優先順位付きの実行可能な推奨事項が含まれます。毎日の確認を想定しています。
• list-rules — サイトに設定されたすべてのリモートルールを、ID、タイプ、モード、設定の概要とともに一覧表示します。
• create-rule — サイトに新しいリモートルールを作成します。レート制限、ボット、シールド、フィルターの各ルールタイプに対応しています。
• update-rule — 既存のリモートルール設定を置き換えます。すべてのフィールドを指定する必要があります（完全置換）。
• delete-rule — リモートルールを削除し、評価を直ちに停止します。
• promote-rule — 検証後、リモートルールを DRY_RUN モードから LIVE モードに昇格します。

リモートルール

リモートルールは MCP サーバーまたは Arcjet ダッシュボードで管理されるため、コードの変更や再デプロイは不要です。サイトへのすべてのリクエストにグローバルに適用されます。リモートルールとしてサポートされるルールタイプは rate_limit、bot、shield、filter のみです。解析済みのリクエスト本文の内容が必要なルール（email、sensitive_info、prompt_injection）には SDK が必要です。

リモートルールの最も一般的な用途は、進行中の攻撃への対応です。たとえば、特定の国、VPN、または IP アドレスから不審なトラフィックがあることに気付いた場合、新しいコードをデプロイせずにフィルタールールを作成して、すぐにブロックできます。

1. list-requests を使って不審なトラフィックを調査し、パターン（特定の国、IP 範囲、VPN の使用など）を特定します。
2. create-rule を使って DRY_RUN モードでフィルタールールを追加し、想定したトラフィックに一致することを確認します。たとえば、特定の国をブロックする場合は ip.src.country == "XX"（ISO 3166-1 alpha-2 の国コード。例：US、CN、RU）、VPN トラフィックをブロックする場合は ip.src.vpn、IP 範囲をブロックする場合は ip.src in { 1.2.3.0/24 } を指定します。
3. もう一度 list-requests を使って、正当なユーザーをブロックせずに、ルールが想定したトラフィックに一致していることを確認します。
4. promote-rule を使ってルールを DRY_RUN から LIVE に切り替え、攻撃トラフィックを直ちにブロックします。
5. 攻撃が収まったら、delete-rule を使ってブロックを解除します。

セキュリティ監視

分析ツールを使って、継続的なセキュリティ状況の把握に役立てましょう。

• 毎日のブリーフィング： 定期的に get-security-briefing を呼び出すと、トラフィックの傾向、脅威の状況、異常、ドライランからの移行準備状況、クォータの状態、優先度順の推奨事項など、サイトのセキュリティ状況を包括的に把握できます。すべてを 1 回の呼び出しで確認できます。
• トラフィック分析： analyze-traffic を使って、リクエストのパターン、拒否率、アクセス数の多いパス、アクセス元の多い IP を把握します。Arcjet ダッシュボードの分析と同じデータを確認できます。
• 異常の検出： get-anomalies を使って、現在のトラフィックと前の期間を比較し、トラフィックの急増、地域的な変化、新たな脅威の活動、不審な IP の挙動など、通常と異なるパターンを検出します。
• IP の調査： 不審な IP を特定したら（analyze-traffic または list-requests から）、investigate-ip を使って、位置情報、脅威インテリジェンス、サイト上でのその IP のすべてのリクエスト活動など、詳細な情報を取得します。
• ドライランの検証： ルールを DRY_RUN から LIVE に切り替える前に、get-dry-run-impact を使って、現在許可されているリクエストのうち何件がブロックされるか、最も影響を受ける IP はどれか、誤検知のリスクがどの程度かを正確に確認します。

使用例

不審なトラフィックを調査してブロックする

「サイトで拒否されたリクエストが急増しています。何が起きているのか調査して、発信元をブロックするのを手伝ってもらえますか？」

アシスタントは analyze-traffic を呼び出して急増を特定し、続いて DENY でフィルタリングした list-requests を使って、最も問題のある IP を洗い出します。次に investigate-ip を使って各 IP の脅威インテリジェンスを取得し、フィルタールールを提案します。create-rule を使ってルールを DRY_RUN モードで作成するため、promote-rule を呼び出して本番環境で有効にする前に、一致状況を確認できます。

毎日のセキュリティブリーフィングを取得する

「本番サイトのセキュリティブリーフィングをお願いします。」

アシスタントは list-teams と list-sites を呼び出して本番サイトを特定し、続いて get-security-briefing を呼び出します。アクティブなルール、前の期間と比較したトラフィックの傾向、異常の検出、脅威インテリジェンスの注目点、ドライランからの移行準備状況、クォータの状態、すぐに実行できる優先度順の推奨事項をまとめた概要が返されます。

再デプロイせずにボット対策を設定する

「マーケティングサイトにボット対策を追加してください。実際のユーザーをブロックしていないか確認できるよう、まずはドライランモードで開始してください。」

アシスタントは list-teams と list-sites を呼び出してサイトを見つけ、次に create-rule を呼び出して、自動化されたトラフィックをブロックするように mode: DRY_RUN を設定した bot ルールを追加します。トラフィックが流れた後、アシスタントに get-dry-run-impact を呼び出すよう依頼すると、ブロックされるはずだったリクエスト数と誤検知のリスクを確認できます。その後、問題がないと判断したら promote-rule を呼び出して、ルールを LIVE に切り替えます。

認証

MCP サーバーは認証に OAuth を使用します。対応しているクライアントから初めて接続すると、Arcjet アカウントへのサインインにリダイレクトされます。認証が完了すると、AI アシスタントがアカウントのリソースに安全にアクセスできるようになります。

セキュリティ

• エンドポイントを確認する — https://api.arcjet.com/mcp に接続していることを必ず確認してください。
• ツールの呼び出しを確認する — AI クライアントで確認プロンプトを有効にし、実行前にアクションを確認できるようにしてください。
• 信頼できるクライアントのみを使用する — 信頼できる AI クライアントからのみ接続してください。接続すると、AI ツールに Arcjet アカウントと同じアクセス権が付与されます。

プライバシーとサポート

• プライバシーポリシー： arcjet.com/privacy
• サポート： [email protected] またはDiscord に参加してください。詳しくはサポートページをご覧ください。