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 Authorization 和 Streamable HTTP 规范。

支持的客户端

支持任何采用最新 MCP 规范，并支持 Streamable HTTP 传输 和 OAuth 授权 的客户端，包括：

• ChatGPT
• Claude Code
• Claude Desktop
• Cursor
• VS Code with Copilot
• Windsurf
• 以及许多其他实现了 MCP 规范的客户端。

设置

ChatGPT

1. 在 ChatGPT 中，前往 Settings。
2. 转到 Connectors，然后选择 Add connection。
3. 将 https://api.arcjet.com/mcp 设为服务 URL。
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

Claude Desktop 远程 MCP 连接适用于订阅[Pro、Max、Team 和 Enterprise 套餐](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)的用户。

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，通过一次调用全面了解站点的安全状况，包括流量趋势、威胁态势、异常情况、试运行准备情况、配额状态和优先级建议。
• 流量分析： 使用 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 添加一条 bot 规则，并将 mode: DRY_RUN 配置为拦截 自动化流量。流量经过一段时间后，你可以让助手调用 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。更多详情请参阅支持页面。