Verimand MCP Authority Server

Verimand MCP Authority Server

MCP は機能を公開します。VAGP は権限を統制します。

Verimand MCP Authority Server は、MCP 互換クライアントに、検証可能な VAGP 権限へのエージェントネイティブなアクセスを提供します。信頼済みの登録エージェントが現在あるアクションの権限を持つかどうかの確認、信頼済み権限状態の調査、VAGP 実行許可の検証を行うための、stdio の小規模なツール群を公開します。

ツールを利用できること自体が権限を付与するわけではありません。このサーバーは、保護対象ツールの実行を強制するゲートウェイではありません。

パッケージ情報

• npm パッケージ：@verimand/mcp-authority-server
• MCP Registry サーバー名：dev.verimand/mcp-authority-server
• 現在のバージョン：0.1.0
• ランタイム：Node.js 22 以降
• MCP SDK／ランタイム：MCP 2026-07-28 仕様を実装する @modelcontextprotocol/server 2.0.0（stdio のレガシー互換性あり）

ツール

• verimand.resolve は、信頼済みの登録エージェントがアクションを実行する権限を持つかどうかを解決し、権限が確認された場合に限り VAGP 実行許可を返します。
• verimand.explain は、決定論的な権限判断または許可から導出されたデータを説明します。情報提供のみを目的とします。
• verimand.get_authority は、エージェント／アクションに関連する範囲限定の権限を返します。
• verimand.get_mandate は、サーバー側で信頼されている委任情報のメタデータを取得します。
• verimand.get_agent_dna は、サーバー側で信頼されている Agent DNA の状態とフィンガープリント情報を返します。
• verimand.verify_permit は、現在の権限証拠に照らして VAGP 実行許可を検証します。

インストールと起動

ローカルの MCP クライアントでは、公開済みのサーバーを次のように起動できます。

npx -y @verimand/[email protected]

この公開リポジトリから実行する場合：

npm ci
node dist/stdio.js

プロセスは stdio 経由で MCP を通信します。stdout は MCP プロトコルメッセージ専用です。診断情報は stderr に出力されます。

MCP クライアントの設定例

{
  "mcpServers": {
    "verimand-authority": {
      "command": "npx",
      "args": ["-y", "@verimand/[email protected]"]
    }
  }
}

エージェントが制御する MCP ツール引数に、シークレット、委任情報、Agent DNA、失効状態、信頼済みコンテキストを含めないでください。本番環境の Verimand 接続情報は、MCP クライアントを使用するエージェントではなく、オペレーターが管理するサーバー環境から提供する必要があります。

初回の権限解決の例

{
  "name": "verimand.resolve",
  "arguments": {
    "agentId": "agent:demo-support",
    "action": "ticket.read",
    "resourceId": "ticket:123",
    "requestId": "req-demo-1"
  }
}

期待される構造化コンテンツには、決定論的な権限 decision、理由コード、選択された委任情報／パスのデータが含まれ、VAGP が AUTHORITY_CONFIRMED と解決した場合に限り許可が含まれます。

セキュリティと信頼境界

MCP からの入力はすべて信頼できません。サーバーが受け入れるのは、小規模で閉じたツール引数のみであり、それらをサーバー側の信頼済み VAGP 状態に対応付けます。MCP 呼び出し元は、信頼済み ID、Agent DNA、委任情報、アテステーション、失効状態、信頼済みコンテキストを自ら宣言できません。

MCP サーバーは、権限に関するセマンティクスを VAGP 0.3 の権限サービスに委ねます。保護対象のビジネスアクションを実行するものではなく、強制実行ゲートウェイに代わるものでもありません。保護対象ツールの実行は、このパッケージの対象外です。

VAGP との関係

VAGP 0.3 は公開権限プロトコルです：https://github.com/verimand/vagp。この MCP サーバーは、MCP 経由で権限の調査と許可の検証を行う Verimand のインターフェースです。

配布状況

バージョン 0.1.0 は npm と MCP Registry で一般公開されています。この MCP サーバーに必要な Verimand VAGP 権限ランタイムは dist/stdio.js にバンドルされており、インストール済みパッケージは、公開されていない @verimand/* ワークスペースパッケージにランタイム依存しません。最初の npm リリースは provenance を付与せずにブートストラップ公開されました。今後のリリースでは、GitHub OIDC の信頼済み段階的公開を行う設定になっています。ただし、これによって 0.1.0 に provenance が遡及的に追加されることはありません。

開発時の検証

クリーンなクローンから、Node.js 22 以降を使用する場合：

npm ci
npm run build
npm test
npm run smoke:stdio

公開リポジトリには監査済みのバンドル済み配布物が含まれており、非公開の TypeScript ビルドソースは含まれていません。ここでの npm run build は、コミット済みバンドルの構文と存在を確認します。ソースからバンドルを再ビルドするものではありません。node:test スイートは stdio 経由でバンドルを起動し、公開されている 6 つのツールすべてを実行し、上限付きの許可とフェイルクローズのケースを確認して、再起動も検証します。npm の tarball に含まれるのは、公開済みの 6 つの配布ファイルに限られます。

サポートとセキュリティに関する報告

セキュリティ上の問題は [email protected] までご報告ください。