プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Vizier Guard

作者:vassiliylakhoninバージョン 0.3.4i★ 0iパソコンで動く公式サイト ↗
レジストリ名io.github.vassiliylakhonin/vizier-guard

インストール方法

できること

Deterministic authorization and security guard for AI agent actions with signed receipts.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ サイバーセキュリティ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Vizier Guard をインストールして。https://mcp.popnx.com/i/vassiliylakhonin-vizier-guard.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Vizier Guard を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vizier-guard": { "command": "uvx", "args": [ "vizier-guard" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vizier Guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "vizier-guard": {
          "command": "uvx",
          "args": [
            "vizier-guard"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Vizier Guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Vizier Guard を使っていると言うか、回答に Vizier Guard のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Vizier Guard につなげません

Vizier Guard はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Vizier Guard につなげるアプリを使う

  • 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · サイバーセキュリティ の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Vizier Guard を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user vizier-guard -- uvx vizier-guard 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vizier Guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user vizier-guard -- uvx vizier-guard
  4. Claude Code で /mcp と入力

    Vizier Guard が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Vizier Guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Vizier Guard を使っていると言うか、回答に Vizier Guard のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Vizier Guard を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vizier-guard": { "command": "uvx", "args": [ "vizier-guard" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vizier Guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Vizier Guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Vizier Guard を使っていると言うか、回答に Vizier Guard のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Vizier Guard を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "vizier-guard": { "type": "stdio", "command": "uvx", "args": [ "vizier-guard" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vizier Guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Vizier Guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Vizier Guard を使っていると言うか、回答に Vizier Guard のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Vizier Guard を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user vizier-guard -- uvx vizier-guard

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vizier-guard": {
      "command": "uvx",
      "args": [
        "vizier-guard"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "vizier-guard": {
      "command": "uvx",
      "args": [
        "vizier-guard"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "vizier-guard": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vizier-guard"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
14/週
接続方法
パソコンで動く
最新バージョンi
0.3.4
レジストリ公開日i
2026年11月12日
コードの最終更新i
2026年11月19日
作者
vassiliylakhonin
パッケージ
pypi: vizier-guard
ウェブサイト
vizier.agendamcp.dpdns.org
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント vassiliylakhonin で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に vizier-guard@0.3.4 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/vassiliylakhonin-vizier-guard.svg)](https://mcp.popnx.com/en/servers/vassiliylakhonin-vizier-guard)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

サイバーセキュリティのほかのサーバーとの比較i

  • このカテゴリのほかの1120件のうち0%よりスターが多い
  • このカテゴリのほかの1120件のうち83%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1120件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Vizier Guardは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.3.4)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

GitHits

Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.

作者:githits-com成長中↓ 3807/週★ 138昨日更新

パソコンでもクラウドでも✓ 提供元 · githits.com

Snyk MCP

Easily find and fix security issues in your applications leveraging Snyk platform capabilities.

作者:snyk広く使われている↓ 76.2万/週★ 617 か月前更新

パソコンで動く✓ 提供元 · snyk.io

TokenSafe

Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.

作者:tokensafe-dev広く使われている↓ 6785/週★ 47今日更新

パソコンでもクラウドでも✓ 提供元 · tokensafe.dev
似たものと比べる
これ
Vizier Guard
GitHitsDependency Management MCP ServerSnyk MCPTokenSafeDraugr
動く場所パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるパソコンにインストールが必要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/35/53/43/35/53/3
ライセンスMITApache-2.0–Apache-2.0MITApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Vizier

Authorize AI agent actions before tools execute.

Vizier checks proposed tool calls against owner-signed, scoped, expiring permissions and deterministic policies. It returns ALLOW, BLOCK, or REVIEW, with rule results and a receipt bound to the request. Your trusted guard enforces the result before a deployment, repository write, database change, message, or payment API call.

Use the TypeScript or Python client, protect existing tools with the MCP proxy, or integrate through REST and A2A. No LLM is involved in the authorization decision.

Try the playground · Quick start · SDK example · MCP · API reference · Threat model

What can you control?

WorkflowWhat the integration can enforceStart here
Agent tool callsPermitted actions, exact targets, constraints, and grant expirySigned delegation
Existing MCP toolsAllowed tools and upstream routes, checked before forwardingMCP enforcement proxy
Cloudflare Worker deploymentsOne existing Worker and human approval of the exact uploaded versionLocal preparation demo
Sensitive operationsAn explicit human-review step bound to the proposed actionReview helpers

An API key identifies the integration. A signed grant carries the owner's permission. Keep the private signing key and protected tool credentials outside the agent's control.

Quick start

Try the browser playground, or run the reproducible first-BLOCK walkthrough. It starts a disposable local Worker, sends the same request through the TypeScript and Python clients, and proves that both clients reject a tampered receipt. No account, production API key, Cloudflare account, deployment, or payment is needed.

From a source checkout, with Node.js 24+ and Python 3.9+:

npm ci

python3 -m venv .venv .venv/bin/python -m pip install -e 'packages/python-sdk[receipts]' VIZIER_DEMO_PYTHON="$PWD/.venv/bin/python" npm run demo:first-block -- --signed

Expected: BLOCK (GRANT_REQUIRED) in both languages, verified request hashes and ES256 signatures, followed by rejection of tampered receipts. This checks current source. The published-package path runs the same signed checks against the released clients, npm 0.5.17 and PyPI vizier-guard 0.3.4.

Optional: prepare a deployment review

To prepare a deployment review locally with Node.js 24+:

mkdir vizier-demo

cd vizier-demo npm install @agenda-intelligence/vizier-sdk@0.5.17 @agenda-intelligence/vizier-gated-deploy@0.5.17 npx --no-install vizier-worker-deploy prepare \ --scope node_modules/@agenda-intelligence/vizier-gated-deploy/examples/scope.json \ --plan node_modules/@agenda-intelligence/vizier-gated-deploy/examples/plan.json

No API key or Cloudflare account is needed for `prepare`. After installation, this step runs locally without network calls. The bundled scope and plan use synthetic IDs.

You get JSON containing:

  • review: the exact Worker version and traffic percentage to review;
  • review_hash: a SHA-256 hash binding that review to its contents;
  • authority: the action and target scope the owner would need to sign.

This prepares a review; it does not authorize or deploy anything. For a real sandbox, follow the operator setup and recovery guide. The adapter's submit and execute modes require additional credentials; execution requires both a matching signed grant and approval of the exact review.

For general policy exploration, use the local REST scenarios. Anonymous evaluation can return BLOCK or REVIEW, never ALLOW.

How it works

flowchart LR

Owner[Owner-controlled signer] -->|Scoped, expiring grant| Guard[Trusted tool guard] Agent[Agent proposes action] --> Guard Guard -->|Exact action + grant| Vizier[Vizier policy service] Vizier -->|Decision + request-bound receipt| Guard Guard -->|Validated ALLOW| Tool[Protected tool] Guard -->|Explicit review submission| Human[Human review workflow]

  1. The owner signs an ES256 delegation for a principal, agent, permitted actions, constraints, and expiry.
  2. The guard submits the intended action and grant to /v1/verify.
  3. Vizier checks the signature, identities, expiry, exact authority binding, and deterministic policies.
  4. The guard validates the response and request binding before invoking the protected tool.
DecisionWhat the caller should do
ALLOWProceed only through the trusted executor, with the exact authorized action and required execution controls.
BLOCKStop. Inspect reason_codes and policy_results; fix the underlying request or permissions.
REVIEWStop execution. Submit a separate human review explicitly if the integration supports it.

A verification response does not execute the action or automatically open a review.

Start with signed delegation

Prerequisites: an operator-issued API key, a registered principal public key, and a matching owner-issued grant. Follow delegation setup first. An API key alone is insufficient in required-grant mode.

Install the TypeScript client (Node.js 24+):

npm install @agenda-intelligence/vizier-sdk@0.5.17

Supply VIZIER_API_KEY and VIZIER_GRANT_FILE to the trusted guard. For this example, the grant must bind platform-owner to release-agent and contain exactly the `authority` object below. Keep the private signer separate.

Save as authorize.mjs:

import { readFile } from "node:fs/promises";

import { Vizier } from "@agenda-intelligence/vizier-sdk";

const apiKey = process.env.VIZIER_API_KEY; const grantPath = process.env.VIZIER_GRANT_FILE; if (!apiKey || !grantPath) { throw new Error("Set VIZIER_API_KEY and VIZIER_GRANT_FILE in the trusted guard."); }

const vizier = new Vizier({ baseUrl: "https://vizier.agendamcp.dpdns.org", apiKey, }); const grant = (await readFile(grantPath, "utf8")).trim();

const result = await vizier.authorize({ agent: { id: "release-agent", owner: "platform-owner" }, principal: { id: "platform-owner" }, action: { type: "deploy_worker", target: "worker:example-worker", parameters: { commit: "reviewed-commit" }, }, authority: { allowed_actions: ["deploy_worker"], constraints: { allowed_targets: ["worker:example-worker"], allowed_sensitive_actions: ["deploy_worker"], }, }, context: { request_id: null, timestamp: null, source: "rest" }, grant, });

// authorize() throws unless the response establishes a request-bound ALLOW // with matching, unexpired principal-signed delegation. console.log("Authorized request:", result.receipt.id);

Run node authorize.mjs after configuring those prerequisites. A valid authorization prints a receipt ID; a refusal throws. This example performs only the authorization request. Use the deployment adapter for the separate, version-specific execution workflow.

authorize() validates the response contract, recomputes the request hash, and rejects BLOCK, REVIEW, expired grants, and mismatched delegation. It relies on the configured trusted service and HTTPS: the unsigned receipt object is not itself a signature. When the Worker has a receipt signing key and the request sends X-Vizier-Receipt: jws, enforcement responses also carry receipt_jws (ES256, verifiable against /.well-known/jwks.json). The published clients, npm 0.5.17 and PyPI vizier-guard 0.3.4, verify it against the JWKS when present; absence is tolerated by default, and opt-in requireReceiptJws (TypeScript) or require_receipt_jws=True (Python) makes a missing JWS an error. See the versioned walkthrough. Execution, request immutability, idempotency, and replay controls remain the integration's responsibility.

Connect through MCP

Call the hosted verification service

For a Streamable HTTP MCP client:

https://vizier.agendamcp.dpdns.org/mcp

Discovery needs no API key. Read the discovered tool schema and metadata before constructing a request. Anonymous verification is evaluation-only and cannot return ALLOW.

From a source checkout, inspect either supported connection profile with Node 24+ and no extra dependencies:

node examples/mcp-connect.ts --profile session

node examples/mcp-connect.ts --profile stateless

These commands perform read-only discovery. A rejected connection includes correction guidance; fix the request and explicitly retry the selected profile.

Configuration for a stdio-only MCP client

This pinned transport adapter connects to the hosted verification service anonymously:

{

"mcpServers": { "vizier": { "command": "npx", "args": [ "-y", "mcp-remote@0.15.1", "https://vizier.agendamcp.dpdns.org/mcp", "--transport", "http-only" ] } } }

It exposes evaluation, not permission to execute: anonymous calls can return BLOCK or REVIEW, never ALLOW.

Enforce authorization on your own MCP tools

The private MCP enforcement proxy sits between the agent and a supported HTTP MCP server. It filters tool discovery and checks configured calls before forwarding them. Configure the signed grant, allowed tools, upstream identity, and protected credentials using the proxy setup guide.

The hosted verification service does not intercept your other tools automatically. Remove the agent's direct upstream access so it cannot bypass the proxy.

Trust boundaries

  • Authorization scope: Vizier checks permissions and policy rules. It does not establish factual truth, legal clearance, payment settlement, or successful tool execution.
  • Receipts: /v1/verify receipts bind a decision to a request hash. The receipt object is unsigned; when a receipt signing key is configured and the caller sends X-Vizier-Receipt: jws, enforcement responses (not anonymous evaluation) add receipt_jws, a compact ES256 JWS over that exact receipt, verifiable with the published JWKS. The delegation grant is owner-signed. Action Covenants have separate signed formats and compatibility limits.
  • Execution: a guard protects only the path it controls. An agent or operator with direct tool credentials can bypass it. Grants are reusable until they expire unless the principal signs single_use: true; a single-use grant is spent at ALLOW, not when the action succeeds, enforcement of one fails closed (BLOCK) without the D1 binding, and revocation is operator-driven (see delegation grants).
  • Deployment review: claiming an approval and performing a cloud deployment are not atomic. Reconcile uncertain outcomes before retryi

冒頭だけを表示しています。続きはリポジトリで読めます