Norma by Quality Clouds

Quality Clouds の Norma：MCP サーバー

Quality Clouds の Norma は、AI が作成したコードを記述中にルールと照合し、検出結果を記録します。

Norma は、コーディングエージェントがコードを書く前に、検出した技術スタックに適用されるルールを提供し、各ファイルをルールと照合して、結果を記録します。同じファイルと同じルールには、毎回同じ判定が返されます。そのため、実行のたびに変わる意見ではなく、誰かに提示できる記録が得られます。

• リモートサーバー（Streamable HTTP）：https://api.qualityclouds.ai/mcp
• 認証：OAuth。初回接続時にブラウザーでサインインします。恒久的な無料プランがあります。
• リンク済みリポジトリが必要です：live_check は、Norma アカウントにリンクされたリポジトリ（GitHub または Bitbucket）でのみ実行されます。コードがそこに保存されることはありません
• Cursor、Claude Code、Lovable、Replit、および MCP 互換のクライアントで動作します
• 対応技術スタック：TypeScript、JavaScript、Python、PHP、Dart および Flutter、Node、React、Vite、Supabase、FastAPI、SQLAlchemy、Adobe Magento など

機能

ルールセットは技術スタックごとに定義されており、サーバーが検出したスタックに応じて自動的に有効になります。リポジトリを一度スキャンするだけで、セキュリティ、パフォーマンス、スケーラビリティ、管理性、保守性、アーキテクチャの6つの機能領域にわたるルールセットが有効になります。Supabase のルールセットだけでも12個のルールを対象としており、サーバー以外でのサービスロールキーの使用禁止、キーやプロジェクト URL のハードコード禁止、すべての変更に対する必須のエラーチェック、クライアント側での JWT デコード禁止、エッジ関数のレート制限などが含まれます。

サーバーは5つのツールを公開します。

ツール	機能
get_rulesets	設定不要でリポジトリの技術スタックを検出し、言語またはフレームワークごとに適用可能なルールセットを返します
get_rules_for_ruleset	1つのルールセット内のルールを返します。各ルールの ID、名前、重大度、影響領域、説明、修正方法が含まれます
live_check	組織のルールに照らして1つのファイルを決定論的にチェックします。同じファイル、同じルールには、毎回同じ判定が返されます。何も保存されません。Norma アカウントにリンクされたリポジトリでのみ実行されます
get_open_issues	リンク済みリポジトリの直近の全体スキャンで見つかった未解決の問題を、修正に必要なコンテキストとともに返します
register_applied_actions	コンプライアンス監査証跡に実施内容を記録します。適合を確認したルール、修正した違反（ファイルと行）、生成中に防止した違反、および作業を行ったモデルが記録されます

各セッションでは、チェック、修正、防止した内容を構造化して記録します。リポジトリの Production-Ready Score と検出結果の全容は、norma.qualityclouds.com のワークスペースで確認できます。

動作の仕組み

最初のチェックを行う前に、Norma アカウントにリポジトリをリンクしてください（下記の5分ガイドを参照）。その後、Norma に接続されたコーディングエージェントは、次の手順に従います。

1. get_rulesets：コーディングタスクの開始時に実行します。
2. get_rules_for_ruleset：関連するルールセット ID ごとに実行します。省略しないでください。
3. エージェントは、これらのルールをコンテキストに含めてコードを作成または変更します。
4. live_check：次のファイルに移る前に、ファイルの作成または変更後に実行します。
5. register_applied_actions：タスクの完了後、手順2で取得した正確なルール ID を使って実行します。

新しいコードを書くのではなく、既存の問題に対応する場合、エージェントは 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 に依頼します。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、サーバー URL を https://api.qualityclouds.ai/mcp に設定して、カスタム MCP サーバーを追加します（HTTP トランスポート、OAuth：初回接続時にブラウザーが開いてサインインを求められます）。次に、メッセージを 1 つ送信すると、Lovable はそれをプロジェクトの継続的なルールとして保持します。

今後、作成または変更するすべてのファイルを Norma でチェックし、返された問題を修正してください。

必須の手順が 1 つあります。プロジェクトの GitHub リポジトリを Norma アカウントに連携し、チャットに GitHub の公開 URL を貼り付けて、Lovable が作業対象のリポジトリを Norma に伝えられるようにしてください。Lovable 自身の git リモートはトークン化された URL であり、第三者に送信されることはありません。そのため、公開 URL がないとライブチェックは実行されず、監査証跡にも何も記録されません。コードが Norma アカウントに保存されることはありません。

トラブルシューティングを含む完全なガイド：docs/LOVABLE.md。

リンク

• サインアップ：norma.qualityclouds.com
• 製品：qualityclouds.ai/norma
• コミュニティ、ドキュメント、サポート：github.com/qualityclouds/community

AI コードガバナンスプラットフォームである Quality Clouds が開発。2017 年以来、950 以上のエンタープライズプラットフォームインスタンスをガバナンスしています。