Normatia

🇬🇧 English | 🇪🇸 Español

Normatia

スペインの建築基準法への適合を支援するオープンソースの開発者向けツールキットです。

メインサイト：normatia.com API ドキュメント：docs.normatia.com API ベース URL：api.normatia.com

Normatia とは？

Normatia は、スペインの AECO 分野（建築、エンジニアリング、建設、運用）向けの建築基準法適合プラットフォームです。このリポジトリには、オープンソースの開発者向けツールキットが含まれています。AI アシスタント向けの MCP サーバー、TypeScript SDK、API の使用例、再利用可能な AI スキルが用意されています。

MCP サーバー

Normatia は、AI アシスタントが特定のプロジェクトのコンテキストでスペインの建築規制にアクセスできるリモート MCP サーバーを提供します。インストールは不要です。

https://mcp.normatia.com/mcp

すべての情報はプロジェクトごとに管理されます

Normatia の規制対象範囲はプロジェクトごとに定義されます。normatia.com の各プロジェクトには、自治体、適用される規制（国、州、自治体）、アップロードしたドキュメント、建物に関する記録済みの情報、保存された計算が含まれています。

そのため、アシスタントが都市名や気候区分、適用される CTE の版を尋ねる必要はありません。これらの値がすでに解決された状態で回答が返されます。また、プロジェクトのない自治体には回答がありません。自治体の条例は市議会ごとに大きく異なるため、サーバーはその旨を伝え、プロジェクトの作成を案内します。

利用可能なツール

3 つのツールはすべて読み取り専用です。MCP インターフェースからプロジェクトに書き込むことはありません。

ツール	説明	コスト
ask(query, project_id?)	プロジェクトに適用される規制について、自然言語で質問します。出典を引用できる規制文を返す唯一のツールです。	1 クレジット
get_project_info(project_id?)	プロジェクトの全コンテキストを返します。場所、地域の技術データ、現行版が適用される規制、ファイル、生成済みドキュメント、メモリ、計算が含まれます。	無料
list_projects()	ユーザーがクエリできるプロジェクトと、それぞれのproject_id、場所、アクティブなプロジェクトを返します。	無料

ask は単発の検索ではなく、normatia.com のチャットと同じエージェントループを実行します。複数の検索を連鎖させ、プロジェクトのメモリや保存済みの計算を読み込み、アップロードされたドキュメントを参照し、検証済みの[N]マーカーですべての出典を引用します。呼び出しは同期処理で、より短い制限時間で実行されます。推論ラウンドは 6 回、検索は 6 回、タイムアウトは 120 秒です。そのため、クライアントのツール呼び出しタイムアウトは 150 秒以上に設定してください。

すべてのツールは省略可能なproject_idを受け取り、明示的な project_id → ユーザーのアクティブなプロジェクトの順に解決されます。別の自治体について質問するには、list_projects()を呼び出して該当する ID を渡してください。同じ会話内で複数のプロジェクトをクエリできます。また、ウェブサイト上のユーザーのアクティブなプロジェクトが変更されることはありません。

セットアップ

Claude

Normatia をカスタムコネクターとして claude.ai に接続します。Free（コネクターは 1 つまで）、Pro、Max、Team、Enterprise の各プランで利用できます。現在ベータ版です。

Free、Pro、Max プラン：

1. カスタマイズ > コネクター に移動します
2. 「+」をクリックし、「カスタムコネクターを追加」を選択します
3. サーバー URL を入力します：https://mcp.normatia.com/mcp
4. 認証方式として OAuth を選択します
5. 「追加」をクリックします

Team、Enterprise プラン（オーナー）：

1. 組織の設定 > コネクター に移動します
2. 「追加」をクリックし、「カスタム」にカーソルを合わせて「ウェブ」を選択します
3. サーバー URL を入力します：https://mcp.normatia.com/mcp
4. 認証方式として OAuth を選択します
5. 「追加」をクリックします

オーナーが追加すると、メンバーは カスタマイズ > コネクター から接続できます。

設定後、各会話で左下の「+」ボタンから「コネクター」を選択し、Normatia を有効にします。

ChatGPT

Normatia をカスタム MCP アプリとして ChatGPT に接続します。Free、Plus、Pro、Business、Enterprise/Edu の各プランで利用できます。現在ベータ版です。

1. 開発者モードを有効にします：「設定」→「アプリ」→「詳細設定」に移動し、開発者モードをオンにします
2. 「設定」→「アプリ」→「作成」に移動します
3. サーバー URL を入力します：https://mcp.normatia.com/mcp
4. 認証方式として OAuth を選択します
5. 作成をクリックします

作成後、任意の会話で「+」ボタンからアプリを有効にし、Normatia を選択します。

Business および Enterprise/Edu プランでは、メンバーがアプリを使用する前に、ワークスペース管理者が「ワークスペースの設定」→「アプリ」からアプリを設定して公開する必要があります。

前提条件

次のクライアントでは API キーが必要です。normatia.com/es/api で取得してください。キーの形式は sk-normatia-... です。

Claude Desktop

設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）に追加します：

{
	"mcpServers": {
		"normatia": {
			"type": "streamable-http",
			"url": "https://mcp.normatia.com/mcp",
			"headers": {
				"Authorization": "Bearer sk-normatia-..."
			}
		}
	}
}

Claude Code

claude mcp add normatia --transport streamable-http https://mcp.normatia.com/mcp \
	-h "Authorization: Bearer sk-normatia-..."

VS Code / GitHub Copilot

ワークスペースの .vscode/mcp.json に追加します：

{
	"servers": {
		"normatia": {
			"type": "streamable-http",
			"url": "https://mcp.normatia.com/mcp",
			"headers": {
				"Authorization": "Bearer sk-normatia-..."
			}
		}
	}
}

または、グローバルにアクセスできるようにユーザー設定（JSON）に追加します：

{
	"mcp": {
		"servers": {
			"normatia": {
				"type": "streamable-http",
				"url": "https://mcp.normatia.com/mcp",
				"headers": {
					"Authorization": "Bearer sk-normatia-..."
				}
			}
		}
	}
}

Cursor

Cursor の MCP 設定（~/.cursor/mcp.json）に追加します：

{
	"mcpServers": {
		"normatia": {
			"type": "streamable-http",
			"url": "https://mcp.normatia.com/mcp",
			"headers": {
				"Authorization": "Bearer sk-normatia-..."
			}
		}
	}
}

Windsurf

Windsurf の MCP 設定に追加します：

{
	"mcpServers": {
		"normatia": {
			"type": "streamable-http",
			"url": "https://mcp.normatia.com/mcp",
			"headers": {
				"Authorization": "Bearer sk-normatia-..."
			}
		}
	}
}

Zed

Zed の設定（~/.config/zed/settings.json）に追加します：

{
	"context_servers": {
		"normatia": {
			"transport": "streamable-http",
			"url": "https://mcp.normatia.com/mcp",
			"headers": {
				"Authorization": "Bearer sk-normatia-..."
			}
		}
	}
}

任意の MCP クライアント

MCP 対応クライアントで次の接続情報を使用します：

設定	値
トランスポート	streamable-http
URL	https://mcp.normatia.com/mcp
認証ヘッダー	Authorization: Bearer sk-normatia-...

30 以上の MCP クライアントの詳しいセットアップ手順については、docs.normatia.com/mcp をご覧ください。

プロンプトの例

接続後、AI アシスタントで次のプロンプトを試してみてください：

• 「プロジェクトで有効な規制と、それぞれの版を教えてください」
• 「プロジェクトで使用できる窓の U 値の上限はいくつですか？」
• 「添付の建具表を確認し、数値が要件に適合しているか教えてください」
• 「セビリアのプロジェクトでは、市の条例で最低限必要な有効高さはいくつですか？」
• 「マドリードのプロジェクトのアクセシビリティ要件を、ビルバオのプロジェクトと比較してください」
• 「すでに保存した計算を踏まえて、ガレージの換気について法規では何と定められていますか？」

TypeScript SDK

npm install normatia

import { NormatiaClient } from 'normatia';

const client = new NormatiaClient({ apiKey: 'sk-normatia-...' });
const location = await client.getLocation('ES-41091');
console.log(location.tech_data.climate_zone); // "B4"

詳しいドキュメントについては、packages/sdk-typescript/README.md をご覧ください。

例

ディレクトリ	説明
examples/curl	主要な API エンドポイントすべての cURL の例
examples/python	httpx を使用した Python の例
examples/typescript	SDK を使用した TypeScript の例

AI スキル

skills ディレクトリには、Normatia を利用する AI エージェント向けの再利用可能なシステムプロンプトが含まれています。

• 建築基準 — スペインの規制（CTE、RITE、LOE）に関する専門的なナビゲーション
• コンプライアンス — 構造化されたコンプライアンス検証ワークフロー
• 位置情報対応 — 地理情報を考慮した規制ガイダンス

API の概要

エンドポイント	メソッド	説明
/api/v1/location/search	GET	地理的な場所を検索
/api/v1/location/{geo_id}	GET	場所の詳細と気候データを取得
/api/v1/codes/search	GET	建築基準を検索
/api/v1/codes/{slug}	GET	基準の詳細を取得
/api/v1/codes/{slug}/versions	GET	基準のバージョンを一覧表示
/api/v1/codes/{slug}/versions/{version}	GET	バージョンの詳細とセクションを取得
/api/v1/projects	GET	ユーザーがクエリできるプロジェクトを一覧表示
/api/v1/project/info	GET	プロジェクトの全コンテキスト
/api/v2/ask	POST	プロジェクトに関するエージェント型の規制関連 Q&A
/api/v1/verify	POST	コンプライアンス検証

POST /api/v1/ask（旧式の単発 RAG エンドポイント）は凍結され、公開スキーマから非表示になっています。既存のインテグレーションでは引き続き動作しますが、新規のインテグレーションでは /api/v2/ask を使用してください。

ドキュメント

API リファレンスとインテグレーションガイドの全文は、docs.normatia.com をご覧ください。

コントリビューション

コントリビューションを歓迎します。Issue またはプルリクエストを作成する前に、CONTRIBUTING.md をお読みください。

ライセンス

MIT — LICENSE をご覧ください。