Norma by Quality Clouds

Quality Clouds 出品的 Norma：MCP 服务

Quality Clouds 出品的 Norma 会在 AI 编写代码时，根据你的规则检查代码，并记录检查结果。

Norma 会在编码 Agent 开始编写代码前，为其提供已检测到的技术栈对应规则，逐个文件进行检查，并记录结果。相同文件和相同规则每次都会得到相同的判定，因此你获得的是一份可以展示给他人的记录，而不是每次运行结果都不一样的意见。

• 远程服务（Streamable HTTP）：https://api.qualityclouds.ai/mcp
• 身份验证：OAuth。首次连接时通过浏览器登录。永久免费套餐。
• 需要关联代码库：live_check 只能检查已关联到 Norma 账户的代码库（GitHub 或 Bitbucket）。你的代码绝不会存储在 Norma 中
• 适用于 Cursor、Claude Code、Lovable、Replit 及任何兼容 MCP 的客户端
• 支持的技术栈：TypeScript、JavaScript、Python、PHP、Dart 和 Flutter、Node、React、Vite、Supabase、FastAPI、SQLAlchemy、Adobe Magento 等

功能

规则集针对特定技术栈，并会根据服务检测到的技术栈自动启用。扫描单个代码库即可启用涵盖六个功能领域的规则集：安全性、性能、可扩展性、可管理性、可维护性和架构。仅 Supabase 规则集就涵盖 12 条规则，包括禁止在服务器之外使用 service-role 密钥、禁止硬编码密钥或项目 URL、每次变更都必须检查错误、禁止在客户端解码 JWT，以及对边缘函数进行速率限制。

该服务提供五种工具：

工具	功能
get_rulesets	无需配置即可检测代码库的技术栈，并返回适用的规则集，每种语言或框架对应一个规则集
get_rules_for_ruleset	返回某个规则集中的规则：每条规则的 ID、名称、严重程度、影响领域、描述和修复指南
live_check	根据组织的规则对单个文件进行确定性检查。相同文件、相同规则，每次都会得到相同的判定。不会存储任何内容。仅适用于已关联到 Norma 账户的代码库
get_open_issues	返回关联代码库上次完整扫描中尚未解决的问题，并提供修复所需的上下文
register_applied_actions	在合规审计追踪中记录已执行的操作：已验证合规的规则、已修复的违规项（文件和行号）、生成过程中已避免的违规项，以及执行工作的模型

每次会话都会生成结构化记录，说明检查、修复和避免了哪些问题。代码库的生产就绪评分和完整检查结果可在你的工作区 norma.qualityclouds.com 中查看。

工作原理

首次检查前，请在 Norma 账户中关联代码库（请参阅下方的 5 分钟指南）。之后，连接到 Norma 的编码 Agent 会按以下顺序操作：

1. get_rulesets：开始任何编码任务时调用。
2. get_rules_for_ruleset：针对每个相关的规则集 ID 调用；绝不跳过。
3. Agent 在上下文中参考这些规则编写或修改代码。
4. live_check：每创建或修改一个文件后、继续处理下一个文件前调用。
5. register_applied_actions：任务完成后调用，并使用步骤 2 中的准确规则 ID。

如果要处理现有问题，而不是编写新代码，Agent 会调用 get_open_issues，并修复代码库上次完整扫描发现的违规项。

5 分钟快速上手（Claude Code）

1. 在 Norma 中关联你的代码仓库。前往 norma.qualityclouds.com 登录（免费开始，无需信用卡），然后通过 GitHub 或 Bitbucket 集成关联代码仓库。实时检查仅对已关联的代码仓库运行。你的代码绝不会存储在 Norma 账户中：关联代码仓库只是告知 Norma 某项检查对应哪个代码仓库，而 live_check 仅在检查期间将文件内容保存在内存中。

2. 添加服务：

claude mcp add --scope user --transport http norma https://api.qualityclouds.ai/mcp

3. 检查是否已连接：

claude mcp list

4. 首次使用时，浏览器会打开登录页面。
5. 在已关联代码仓库的本地克隆中打开会话，并让 Claude Code 根据你的编码标准审查文件。它会获取适用于你技术栈的规则，对文件进行实时检查，并将结果登记回你的工作区。

如果实时检查提示代码仓库未关联，请确认它已显示在 Norma 账户中，并确认克隆仓库中的 git remote get-url origin 指向同一个代码仓库。

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "norma": {
      "url": "https://api.qualityclouds.ai/mcp"
    }
  }
}

首次连接时，Cursor 会提示你通过浏览器登录。与 Claude Code 一样，请先在 Norma 账户中关联代码仓库（参见 5 分钟指南的第 1 步），然后打开该代码仓库的本地克隆。

Lovable

Lovable 支持将自定义 MCP 服务用作聊天连接器，因此 Norma 无需插件即可使用。在项目中打开连接器面板，并添加一个名为 Norma 的自定义 MCP 服务，服务 URL 为 https://api.qualityclouds.ai/mcp（HTTP 传输，OAuth：首次连接时浏览器会打开登录页面）。然后发送一条消息，Lovable 会将其作为项目的长期规则：

从现在开始，对于你创建或修改的每个文件，都要通过 Norma 检查，并修复它返回的问题。

有一步不可省略：在 Norma 账户中关联项目的 GitHub 代码仓库，然后在聊天中粘贴其公开 GitHub URL，以便 Lovable 告知 Norma 它正在处理哪个代码仓库。Lovable 自己的 git 远程地址是带令牌的 URL，不会发送给第三方；因此，如果没有公开 URL，实时检查就不会运行，也不会有任何内容进入你的审计跟踪。你的代码绝不会存储在 Norma 账户中。

完整指南（包括故障排除）：docs/LOVABLE.md。

链接

• 注册：norma.qualityclouds.com
• 产品：qualityclouds.ai/norma
• 社区、文档和支持：github.com/qualityclouds/community

由 Quality Clouds 打造，这是一个 AI 代码治理平台，自 2017 年以来已为 950 多个企业平台实例提供治理。