2.0.3

ドキュメント管理

管理画面の概要

データベースアクセス、MCP 認証情報、ID、認可、監査、セキュリティポリシー、ランタイム運用を管理するためのコントロールプレーンです。

管理画面は、hs-sql-agent の運用者向けコントロールプレーンです。運用者は MCP クライアントがアクセスできる範囲と SQL の統制方法をここで定義し、MCP クライアントは別途認証された /mcp エンドポイントを使用します。

データベース管理 プロバイダー接続を登録し、接続確認を行い、MCP キーをどのデータベースに紐付けられるかを管理します。

MCP キー MCP 認証情報の発行、ローテーション、失効、スコープ設定、クライアント設定の生成を行います。

セマンティックメタデータ スキーマ探索に、人が理解しやすい名前、説明、同義語、リレーション、メトリクスを追加します。

カスタムツール ランタイムポリシーを迂回せず、統制された SQL 操作を名前付き MCP ツールとして公開します。

セキュリティ 認証、認可、テーブル／ツールのスコープ、fail-closed の SQL ポリシー、監査境界を確認します。

運用デプロイ、共有状態、オブザーバビリティ、保持期間、各種制限、本番ランタイムの動作を設定します。

ID、ガバナンス、運用

メンバーとロール 管理ユーザーの作成、ロール割り当て、セッション失効、ロールのライフサイクル管理を安全に行います。

権限管理 API のコントローラーが適用する permission path と action のモデルを説明します。

監査ランタイムおよびセキュリティ監査レコードの検索、集計、エクスポート、保持を行います。

セキュリティポリシー クエリ、DML、キー単位のレート制限、SQL 同時実行制御を管理します。

運用状態 実行メトリクス、DB ヘルス、キー利用状況、外向き配信の状態を確認します。

Admin HTTP API 同梱 UI が利用する、ソースに基づく 2.0.2 のコントローラールートと認可サーフェスを確認します。

推奨する運用フロー

01 データベースを登録

02 MCP キーを発行

03 ツール／テーブル範囲を設定

04 メタデータを補強

05 クライアントを接続

06 監視・監査

エージェントに公開するデータベース接続を登録し、接続できることを確認します。
そのデータベースに紐付けた MCP キーを発行し、クライアントに必要なツール／テーブルだけを許可します。
物理スキーマ名だけではエージェントが安定して探索できない場合は、セマンティックメタデータを追加します。
クライアント設定を生成し、公開 Streamable HTTP /mcp エンドポイントへ接続します。
監査と運用状態の画面でランタイムの挙動を確認し、必要に応じてポリシーを絞り込みます。

MCP キーのライフサイクル

キーを発行、ローテーション、または複製すると、UI は対応するクライアント形式向けの Streamable HTTP 設定を直接生成できます。平文のシークレットが表示されるのはそのライフサイクルダイアログ内だけで、後から再表示するためには保存されません。

ダイアログを閉じる前に、生成された設定をコピーしてください。

組み込み UI と内蔵 ID 管理は任意です

ASP.NET Core のホストは、同梱の管理 UI を配信せずに HsSqlAgent Admin API だけを公開できます。モジュール型の統合では UseHsSqlAgentAdminApi() を使用し、ホスト側で MapControllers() を呼び出します。同梱 UI が必要な場合にだけ UseHsSqlAgentAdminUi() を追加してください。

また、ホストは AddHsSqlAgentHostAuthorization(...) を使用し、HsSqlAgent のメンバー、ロール、JWT、SMTP、OIDC を導入せずに既存のログイン／権限システムを維持できます。MCP は AddHsSqlAgentMcp(...) / UseHsSqlAgentMcp() で独立して選択・マッピングします。

2.0.2 の構成モデル全体については ASP.NET Core 連携を参照してください。