pp-vercel-admin について
pp-vercel-admin は、Printing Press CLI で Vercel を管理するスキルです。デプロイ、ドメイン、請求、アクセスグループなどの管理に対応します。
主な機能
- 01デプロイとドメインの管理
- 02アクセスグループの作成と編集
- 03請求情報の確認と管理
- 04エッジとネットワークの設定
活用シーン
- 01チームのデプロイ状況の確認
- 02ドメインや DNS 設定の更新
- 03チームのアクセスグループ管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mvanhorn/ printing-press-library --skill pp-vercel-adminインストール後、Claude Code で/pp-vercel-adminを入力して読み込まれたか確認します。
詳細
Vercel Admin — Printing Press CLI
前提条件:CLI をインストールする
このスキルは vercel-admin-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、まずインストールしてください。
- Printing Press インストーラーを使用してインストールします。macOS/Linux では
$HOME/.local/bin、Windows では%LOCALAPPDATA%\Programs\PrintingPress\binがバイナリのデフォルトのインストール先です。npx -y @mvanhorn/printing-press-library install vercel-admin --cli-only - 確認します:
vercel-admin-pp-cli --version - 報告されたインストール先のディレクトリが、このスキルを実行するエージェント/ランタイムの
$PATHに含まれていることを確認します。
npx によるインストールに失敗した場合(Node がない、オフラインなど)は、Go を直接インストールする方法に切り替えてください(Go 1.26.6 以降が必要です)。この方法では $GOPATH/bin(デフォルトは $HOME/go/bin)にインストールされるため、代わりにこのディレクトリを $PATH に追加してください。
go install github.com/mvanhorn/printing-press-library/library/cloud/vercel-admin/cmd/vercel-admin-pp-cli@latest
インストール後に --version が「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認に成功するまで、このスキルのコマンドを実行しないでください。
Vercel は、優れた開発者体験とエンドユーザーのパフォーマンスへの徹底したこだわりを両立させています。Vercel のプラットフォームにより、フロントエンドチームは最高の仕事ができます。
コマンドリファレンス
access-groups — アクセスグループを管理します
vercel-admin-pp-cli access-groups create— アクセスグループを作成しますvercel-admin-pp-cli access-groups delete— アクセスグループを削除しますvercel-admin-pp-cli access-groups list— チーム、プロジェクト、またはメンバーのアクセスグループを一覧表示しますvercel-admin-pp-cli access-groups read— アクセスグループを読み取りますvercel-admin-pp-cli access-groups update— アクセスグループのメタデータを更新します
aliases — エイリアスを管理します
vercel-admin-pp-cli aliases delete-alias— 指定した ID のエイリアスを削除します。vercel-admin-pp-cli aliases get-alias— 指定したホスト名またはエイリアス ID のエイリアスを取得します。vercel-admin-pp-cli aliases list— 認証済みユーザーまたはチームのエイリアス一覧を取得します。
artifacts — アーティファクトを管理します
vercel-admin-pp-cli artifacts download— リクエストパスで指定されたhashによって識別されるキャッシュアーティファクトをダウンロードします。vercel-admin-pp-cli artifacts exists— 指定したhashのキャッシュアーティファクトが存在することを確認します。vercel-admin-pp-cli artifacts query— アーティファクトの配列に関する情報を照会します。vercel-admin-pp-cli artifacts record-events— アーティファクトのキャッシュ使用イベントを記録します。このリクエストの本文は、キャッシュ使用イベントの配列です。vercel-admin-pp-cli artifacts status— このプリンシパルのリモートキャッシュのステータスを確認します。vercel-admin-pp-cli artifacts upload— パスで指定されたhashによって識別されるキャッシュアーティファクトをアップロードします。
billing — 請求を管理します
vercel-admin-pp-cli billing buy-credits— 登録済みのデフォルトの支払い方法を使用して、Vercel チームのクレジットを購入します。vercel-admin-pp-cli billing list-charges— FOCUS v1 形式の請求額データを返します。vercel-admin-pp-cli billing list-contract-commitments— 指定した Vercel チームについて、契約期間ごとのコミットメント割り当てを FOCUS v1.3 JSONL 形式で返します。
bulk-redirects — 一括リダイレクトを管理します
vercel-admin-pp-cli bulk-redirects delete-redirects— プロジェクトの一括リダイレクトの最新バージョンから、指定したリダイレクトを削除します。vercel-admin-pp-cli bulk-redirects edit-redirect— ソースパスで識別される単一のリダイレクトを編集します。vercel-admin-pp-cli bulk-redirects get-redirects— プロジェクトの一括リダイレクトのバージョン履歴を取得しますvercel-admin-pp-cli bulk-redirects get-versions— プロジェクトの一括リダイレクトのバージョン履歴を取得しますvercel-admin-pp-cli bulk-redirects restore-redirects— ステージングバージョンの指定したリダイレクトを、本番バージョンの値に戻します。vercel-admin-pp-cli bulk-redirects stage-redirects— プロジェクトに新しいリダイレクトをステージングし、新しいバージョンを返します。vercel-admin-pp-cli bulk-redirects update-version— ステージングを本番に昇格するか、以前の本番バージョンを復元してバージョンを更新します
certs — 証明書を管理します
vercel-admin-pp-cli certs get-by-id— ID で証明書を取得しますvercel-admin-pp-cli certs issue— 新しい証明書を発行しますvercel-admin-pp-cli certs remove— 証明書を削除しますvercel-admin-pp-cli certs upload— 証明書をアップロードします
connect — Connect を管理します
vercel-admin-pp-cli connect create-connector— 種類固有の設定からコネクターを作成し、作成時にプロジェクトへリンクすることもできます。vercel-admin-pp-cli connect create-connector-authorization-request— コネクターの認可リクエストを作成し、フローの完了に必要な URL と検証情報を返します。vercel-admin-pp-cli connect create-network— Secure Compute ネットワークを作成できます。vercel-admin-pp-cli connect delete-network— Secure Compute ネットワークを削除できます。vercel-admin-pp-cli connect get-connector-token— パスパラメーターで識別され、リクエスト元にスコープされたコネクターのアクセストークンを取得します。vercel-admin-pp-cli connect list-networks— Secure Compute ネットワークの一覧を取得できます。vercel-admin-pp-cli connect read-network— Secure Compute ネットワークを読み取ることができます。vercel-admin-pp-cli connect update-network— Secure Compute ネットワークを更新できます。
deployments — デプロイメントを管理します
vercel-admin-pp-cli deployments create— 必須データと指定されたデータをすべて含む新しいデプロイメントを作成します。vercel-admin-pp-cli deployments delete— この API を使用すると、デプロイメントを削除できますvercel-admin-pp-cli deployments get— 認証済みのユーザーまたはチームのデプロイメント一覧を取得します。vercel-admin-pp-cli deployments get-idorurl— ID(idプロパティ)またはホスト名(urlプロパティ)を指定して、デプロイメントの情報を取得します。
domains — ドメインを管理します
vercel-admin-pp-cli domains create-or-transfer— 認証ユーザーの Vercel に新しいエイペックスドメイン名を追加するためのエンドポイントです。vercel-admin-pp-cli domains delete— Vercel に登録済みのドメイン名を削除します。vercel-admin-pp-cli domains get— 認証済みのユーザーまたはチームに登録されているドメインの一覧を取得します。vercel-admin-pp-cli domains get-domain— アカウントまたはチーム内の単一ドメインの情報を取得します。vercel-admin-pp-cli domains patch— エイペックスドメインを更新または移動します。注:このエンドポイントは、自動更新やネームサーバーの更新には使用されなくなりました。vercel-admin-pp-cli domains update-record— ドメイン名の既存の DNS レコードを更新します。
drains — Drain を管理します
-
vercel-admin-pp-cli drains create— 指定した設定で新しい Drain を作成します。 -
vercel-admin-pp-cli drains delete— URL に Drain ID を指定して、特定の Drain を削除します。 -
vercel-admin-pp-cli drains get— 認証済みチームの Drain 一覧を取得できます。 -
vercel-admin-pp-cli drains get-id— URL に Drain ID を指定して、特定の Drain の情報を取得します。 -
vercel-admin-pp-cli drains test— サンプルイベントを使用して、Drain の配信設定を検証します。 -
vercel-admin-pp-cli drains update— 既存の Drain の設定を更新します。 edge-cache — エッジキャッシュを管理 -
vercel-admin-pp-cli edge-cache dangerously-delete-by-src-images— ソース画像を削除済みとしてマークします -
vercel-admin-pp-cli edge-cache dangerously-delete-by-tags— キャッシュタグを削除済みとしてマークします -
vercel-admin-pp-cli edge-cache invalidate-by-src-images— ソース画像を古い状態としてマークします -
vercel-admin-pp-cli edge-cache invalidate-by-tags— キャッシュタグを古い状態としてマークします
edge-config — エッジ設定を管理
vercel-admin-pp-cli edge-config create— Edge Config を作成します。vercel-admin-pp-cli edge-config delete— ID を指定して Edge Config を削除します。vercel-admin-pp-cli edge-config get— すべての Edge Config を返します。vercel-admin-pp-cli edge-config get-edgeconfig— Edge Config を返します。vercel-admin-pp-cli edge-config update— Edge Config を更新します。
env — 環境変数を管理
vercel-admin-pp-cli env create-shared-variable— チームの共有環境変数を作成します。vercel-admin-pp-cli env delete-shared-variable— 指定したチームの共有環境変数を1つまたは複数削除します。vercel-admin-pp-cli env get-shared-var— ID を指定して共有環境変数の復号済みの値を取得します。vercel-admin-pp-cli env list-shared-variable— オプションのフィルターを適用して、チームの共有環境変数をすべて一覧表示します。vercel-admin-pp-cli env update-shared-variable— 指定したチームの共有環境変数を更新します。
events — イベントを管理
vercel-admin-pp-cli events list-types— ユーザー向けイベントタイプの一覧と説明を返します。vercel-admin-pp-cli events list-user— Vercel 上でユーザーが生成した「イベント」の一覧を取得します。
files — ファイルを管理
vercel-admin-pp-cli files— デプロイを作成する前に、そのデプロイに必要なファイルをアップロードする必要があります。
installations — インストールを管理
vercel-admin-pp-cli installations <integrationConfigurationId>— インテグレーションのインストールを更新します。
integrations — インテグレーションを管理
vercel-admin-pp-cli integrations connect-resource-to-project— インテグレーションのリソースを Vercel プロジェクトに接続します。vercel-admin-pp-cli integrations create-log-drain— インテグレーションのログドレインを作成します。vercel-admin-pp-cli integrations delete-configuration— パラメーターで指定されたidの設定を削除します。vercel-admin-pp-cli integrations delete-log-drain— 指定されたidのインテグレーションログドレインを削除します。vercel-admin-pp-cli integrations exchange-sso-token— 認証プロセス中に、Vercel はユーザーをプロバイダーの [redirectLoginUrl](https://vercel にリダイレクトします。vercel-admin-pp-cli integrations get-billing-plans— インテグレーションと製品の課金プラン一覧を取得します。vercel-admin-pp-cli integrations get-configuration— 指定された ID の設定が存在する場合、その設定を取得します。vercel-admin-pp-cli integrations get-configuration-products— インテグレーション設定で利用可能な製品を返します。vercel-admin-pp-cli integrations get-configurations— 認証済みインテグレーションのすべての設定を取得します。vercel-admin-pp-cli integrations get-log-drains— 認証済みユーザーまたはチームに定義されているインテグレーションログドレインの一覧を取得します。vercel-admin-pp-cli integrations git-namespaces— サポート対象プロバイダーの Git 名前空間を一覧表示します。サポート対象プロバイダーはgithub、gitlab、bitbucketです。vercel-admin-pp-cli integrations search-repo— サポート対象プロバイダーの名前空間idにリンクされた Git リポジトリを一覧表示します。
log-drains — ログドレインを管理
-
vercel-admin-pp-cli log-drains create-configurable— 設定可能なログドレインを作成します。 -
vercel-admin-pp-cli log-drains delete-configurable— 設定可能なログドレインを削除します。 -
vercel-admin-pp-cli log-drains get-all— アカウントが所有するすべてのログドレインの一覧を取得します。 -
vercel-admin-pp-cli log-drains get-configurable— 設定可能なログドレインを取得します。 microfrontends — マイクロフロントエンドを管理 -
vercel-admin-pp-cli microfrontends create-group-with-applications— マイクロフロントエンドグループを作成し、1 回のリクエストで複数のプロジェクトを追加します。 -
vercel-admin-pp-cli microfrontends get-config-for-project— ID または名前で指定したプロジェクトのマイクロフロントエンド設定を取得します。 -
vercel-admin-pp-cli microfrontends get-groups— チームのマイクロフロントエンドグループ ID を取得します。 -
vercel-admin-pp-cli microfrontends get-in-group— 指定したグループ ID のマイクロフロントエンドを取得します。
observability — オブザーバビリティを管理
vercel-admin-pp-cli observability get-configuration-projects— チームで Observability Plus が無効に設定されているプロジェクトの一覧を取得します。vercel-admin-pp-cli observability update-configuration-project— 1 つのプロジェクトで Observability Plus を無効にするかどうかを更新します。
projects — プロジェクトを管理
vercel-admin-pp-cli projects accept-transfer-request— 別のチームが開始したプロジェクトの移管リクエストを承認します。vercel-admin-pp-cli projects create— 指定した設定で新しいプロジェクトを作成します。vercel-admin-pp-cli projects delete— URL にプロジェクトのidまたはnameを指定して、特定のプロジェクトを削除します。vercel-admin-pp-cli projects get— 認証済みユーザーまたはチームのプロジェクト一覧を取得します。vercel-admin-pp-cli projects get-idorname— URL にプロジェクトのidまたはnameを指定して、特定のプロジェクトの情報を取得します。vercel-admin-pp-cli projects update— プロジェクトのnameまたはidを使って、そのフィールドを更新します。
registrar — レジストラを管理
vercel-admin-pp-cli registrar buy-domains— 複数のドメインを一度に購入しますvercel-admin-pp-cli registrar buy-single-domain— ドメインを購入しますvercel-admin-pp-cli registrar get-bulk-availability— 複数のドメインの利用可否を取得します。vercel-admin-pp-cli registrar get-contact-info-schema— 一部の TLD では、追加の連絡先情報が必要です。vercel-admin-pp-cli registrar get-domain-auth-code— ドメインの認証コードを取得します。Vercel から別のレジストラへドメインを移管する際に必要です。vercel-admin-pp-cli registrar get-domain-availability— 特定のドメインの利用可否を取得します。vercel-admin-pp-cli registrar get-domain-price— 特定のドメインの価格情報を取得しますvercel-admin-pp-cli registrar get-domain-transfer-in— ドメインの移管状況を取得しますvercel-admin-pp-cli registrar get-order— ID を指定してドメイン注文の情報を取得しますvercel-admin-pp-cli registrar get-supported-tlds— Vercel がサポートする TLD の一覧を取得しますvercel-admin-pp-cli registrar get-tld— 特定の TLD のメタデータを取得します。vercel-admin-pp-cli registrar get-tld-price— 特定の TLD の価格情報を取得します。指定した TLD の基本価格のみを反映します。vercel-admin-pp-cli registrar renew-domain— ドメインを更新しますvercel-admin-pp-cli registrar transfer-in-domain— 別のレジストラからドメインを移管しますvercel-admin-pp-cli registrar update-domain-auto-renew— ドメインの自動更新設定を更新しますvercel-admin-pp-cli registrar update-domain-nameservers— ドメインのネームサーバーを更新します。空の配列を渡すと、Vercel のデフォルトのネームサーバーが使用されます。
sandboxes — サンドボックスを管理
vercel-admin-pp-cli sandboxes create— 名前付きサンドボックス環境を作成します。vercel-admin-pp-cli sandboxes create-session-directory— セッションのファイルシステムに新しいディレクトリを作成します。vercel-admin-pp-cli sandboxes create-session-snapshot— 実行中のセッションのファイルシステムの特定時点のスナップショットを作成します。vercel-admin-pp-cli sandboxes delete-drive— プロジェクトと名前を指定してドライブを削除します。アタッチされているドライブは削除できません。vercel-admin-pp-cli sandboxes delete-sandbox— 名前を指定してサンドボックスを削除します。サンドボックスが実行中の場合は、先に停止されます。vercel-admin-pp-cli sandboxes delete-session-snapshot— スナップショットを完全に削除し、関連するストレージを解放します。この操作は取り消せません。vercel-admin-pp-cli sandboxes extend-session-timeout— 実行中のセッションの最大実行時間を延長します。セッションはアクティブで、コマンドを受け付けられる状態である必要があります。vercel-admin-pp-cli sandboxes get-named-sandbox— 名前付きサンドボックスを名前で取得します。現在のサンドボックスとルートも含まれます。vercel-admin-pp-cli sandboxes get-or-create-drive— プロジェクトと名前を指定して既存のドライブを取得するか、存在しない場合は作成します。ドライブはプライベートベータ版です。vercel-admin-pp-cli sandboxes get-session— 現在のステータスやリソース設定など、特定のセッションの詳細情報を取得しますvercel-admin-pp-cli sandboxes get-session-command— セッションで実行されたコマンドの現在のステータスと詳細を取得します。vercel-admin-pp-cli sandboxes get-session-command-logs— 改行区切りのJSON(ND-JSON)を使用して、コマンドの出力をリアルタイムでストリーミングします。vercel-admin-pp-cli sandboxes get-session-snapshot— 作成日時、サイズ、有効期限など、特定のスナップショットの詳細情報を取得しますvercel-admin-pp-cli sandboxes kill-session-command— セッション内で実行中のコマンドを終了するシグナルを送信します。vercel-admin-pp-cli sandboxes list— 特定のプロジェクトに属する名前付きサンドボックスのページネーション付きリストを取得します。vercel-admin-pp-cli sandboxes list-drives— 特定のプロジェクトに属するドライブのページネーション付きリストを取得します。ドライブはプライベートベータ版です。vercel-admin-pp-cli sandboxes list-session-commands— 現在のステータスや終了コードなど、セッションで実行されたすべてのコマンドのリストを取得しますvercel-admin-pp-cli sandboxes list-session-snapshots— 特定のプロジェクトのスナップショットのページネーション付きリストを取得します。vercel-admin-pp-cli sandboxes list-sessions— 特定のサンドボックスに属するセッションのページネーション付きリストを取得します。vercel-admin-pp-cli sandboxes read-session-file— セッションのファイルシステムからファイルの内容をダウンロードします。vercel-admin-pp-cli sandboxes run-session-command— 実行中のセッション内でシェルコマンドを実行します。vercel-admin-pp-cli sandboxes stop-session— 実行中のセッションを停止し、割り当てられたリソースを解放します。vercel-admin-pp-cli sandboxes update-sandbox— サンドボックスの設定を更新します。指定されたフィールドのみが変更され、省略されたフィールドは変更されません。vercel-admin-pp-cli sandboxes update-session-network-policy— 実行中のセッションのネットワークアクセスポリシーを置き換えます。vercel-admin-pp-cli sandboxes write-session-files— ファイルをセッションのファイルシステムにアップロードして展開します。ファイルはgzip圧縮されたtarball(`.tar.
セキュリティ — セキュリティを管理します
vercel-admin-pp-cli security add-bypass-ip— 新しいシステムバイパスルールを作成しますvercel-admin-pp-cli security get-active-attack-status— 過去 N 日間(デフォルト:1 日)のアクティブな攻撃データを取得しますvercel-admin-pp-cli security get-bypass-ip— 指定したプロジェクトに設定されているシステムバイパスルールを取得しますvercel-admin-pp-cli security get-firewall-config— プロジェクトの指定したファイアウォール設定を取得します。デプロイ済みの configVersion はactiveになりますvercel-admin-pp-cli security get-firewall-events— プロジェクトのファイアウォールアクションを取得しますvercel-admin-pp-cli security put-firewall-config— 指定されたルールと設定にファイアウォール設定を変更します。既存のファイアウォール設定がない場合は作成し、ある場合は上書きしますvercel-admin-pp-cli security remove-bypass-ip— システムバイパスルールを削除しますvercel-admin-pp-cli security update-attack-challenge-mode— プロジェクトで Attack Challenge モードが有効かどうかを判定する設定を更新しますvercel-admin-pp-cli security update-firewall-config— プロジェクトの既存のファイアウォール設定を変更する更新を処理します
storage — ストレージを管理
vercel-admin-pp-cli storage— 請求プランを自動的に処理して、インテグレーションストアを作成します。
teams — チームを管理
vercel-admin-pp-cli teams create— アカウントに新しいチームを作成します。vercel-admin-pp-cli teams delete— アカウントのチームを削除します。削除するチームのidを指定して、DELETEリクエストを送信する必要があります。vercel-admin-pp-cli teams get— 認証済みユーザーがメンバーになっているすべてのチームのページ分割された一覧を取得します。vercel-admin-pp-cli teams get-teamid—teamIdパラメーターで指定したチームの情報を取得します。vercel-admin-pp-cli teams patch—teamIdパラメーターで指定したチームの情報を更新します。
user — ユーザーを管理
vercel-admin-pp-cli user create-auth-token— 現在認証されているユーザーの新しい認証トークンを作成して返します。vercel-admin-pp-cli user delete-auth-token— 認証トークンを無効化し、以後の HTTP リクエストで使用できないようにします。vercel-admin-pp-cli user get-auth— 現在認証されているユーザーに関連する情報を取得します。vercel-admin-pp-cli user get-auth-token— 現在認証されているユーザーの認証トークンに関するメタデータを取得します。vercel-admin-pp-cli user list-auth-tokens— 現在のユーザーの認証トークン一覧を取得します。vercel-admin-pp-cli user request-delete— 削除確認メールを送信し、現在認証されているユーザーの削除手続きを開始します。
webhooks — ウェブフックを管理
vercel-admin-pp-cli webhooks create— ウェブフックを作成しますvercel-admin-pp-cli webhooks delete— ウェブフックを削除しますvercel-admin-pp-cli webhooks get— ウェブフックの一覧を取得しますvercel-admin-pp-cli webhooks get-id— ウェブフックを取得します
適切なコマンドを見つける
実行したい操作は分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。
vercel-admin-pp-cli which "<capability in your own words>"
which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も一致するコマンドに対応付けます。終了コード 0 は少なくとも 1 件一致したことを示します。終了コード 2 は確度の高い一致がなかったことを示します。その場合は --help を使うか、より具体的な問い合わせをしてください。
認証の設定
vercel-admin-pp-cli auth setup を実行すると、トークンを取得するための URL と手順が表示されます(--launch を追加すると URL を開きます)。次に、トークンを保存します。
vercel-admin-pp-cli auth set-token YOUR_TOKEN_HERE
または、VERCEL_ADMIN_TOKEN を環境変数として設定します。
設定を確認するには、vercel-admin-pp-cli doctor を実行します。
エージェントモード
任意のコマンドに --agent を追加します。次のオプションに展開されます:--json --compact --no-input --no-color --yes。
-
パイプ可能 — stdout に JSON、stderr にエラーを出力します
-
フィルター可能 —
--selectでフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素を走査します。出力が冗長な API でコンテキストを小さく保つうえで重要です:vercel-admin-pp-cli access-groups list --agent --select id,name,status -
プレビュー可能 —
--dry-runで送信せずにリクエストを表示します -
オフラインに対応 — 同期/検索コマンドは、利用可能な場合にローカル SQLite ストアを使用できます
-
非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します
-
明示的な再試行 — すでに存在するものの作成を成功として扱う場合にのみ
--idempotentを使用し、削除対象が存在しない場合に成功として扱う場合にのみ--ignore-missingを使用します
レスポンスエンベロープ
ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします:
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
データには .results を解析し、ライブデータかローカルデータかの判別には .meta.source を参照してください。人が読みやすい N results (live) の概要が stderr に出力されるのは、stdout がターミナルであり、かつ機械可読形式のフラグ(--json、--csv、--compact、--quiet、--plain、--select)が設定されていない場合のみです。パイプ経由/エージェント経由の利用や、形式を明示した実行では、stdout に純粋な JSON が出力されます。
エージェントからのフィードバック
この CLI に問題があると気付いた場合は(あなた自身でも、エージェントを通じてでも)、記録してください:
vercel-admin-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
vercel-admin-pp-cli feedback --stdin < notes.txt
vercel-admin-pp-cli feedback list --json --limit 10
エントリーは ~/.local/share/vercel-admin-pp-cli/feedback.jsonl にローカル保存されます。VERCEL_ADMIN_FEEDBACK_ENDPOINT が設定され、かつ --send が渡された場合、または VERCEL_ADMIN_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。
バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1 行で記述してください。それが積み重なっていく部分です。
出力の配信
すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて、または標準出力の代わりに、指定したシンクに送られるため、エージェントはコマンド結果を手作業でパイプ処理せずに転送できます。利用できるシンクは 3 種類です:
| シンク | 動作 |
|---|---|
stdout | デフォルト。標準出力のみに書き込みます |
file:<path> | 出力を <path> にアトミックに書き込みます(一時ファイル+リネーム) |
webhook:<url> | 出力本文を URL に POST します(--compact 指定時は application/json または application/x-ndjson) |
不明なスキームは、サポート対象を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。
名前付きプロファイル
プロファイルは、保存して再利用できるフラグ値のセットです。スケジュールされたエージェントが、毎回同じ設定で同じコマンドを実行する場合に使用します。これは HeyGen の「Beacon」パターンです。
vercel-admin-pp-cli profile save briefing --json
vercel-admin-pp-cli --profile briefing access-groups list
vercel-admin-pp-cli profile list --json
vercel-admin-pp-cli profile show briefing
vercel-admin-pp-cli profile delete briefing --yes
明示的に指定したフラグは、常にプロファイルの値より優先されます。プロファイルの値はデフォルトより優先されます。agent-context は、実行時に情報を調べるエージェントがプロファイルを確認できるよう、利用可能なすべてのプロファイルを available_profiles の下に一覧表示します。
終了コード
| コード | 意味 |
|---|---|
| 0 | 成功 |
| 2 | 使用方法のエラー(引数が不正) |
| 3 | リソースが見つかりません |
| 4 | 認証が必要です |
| 5 | API エラー(上流の問題) |
| 7 | レート制限中(待機して再試行してください) |
| 10 | 設定エラー |
引数の解析
$ARGUMENTS を解析します:
- 空、
help、または--help→vercel-admin-pp-cli --helpの出力を表示します installで始まる →mcpで終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照してください- その他すべて → 直接使用(CLI コマンドとして
--agentを付けて実行します)
MCP サーバーのインストール
- MCP サーバーをインストールします:
go install github.com/mvanhorn/printing-press-library/library/cloud/vercel-admin/cmd/vercel-admin-pp-mcp@latest - Claude Code に登録します:
claude mcp add vercel-admin-pp-mcp -- vercel-admin-pp-mcp - 確認します:
claude mcp list
直接使用
- インストールされているか確認します:
which vercel-admin-pp-cli見つからない場合は、インストールを提案してください(このスキルの冒頭にある「前提条件」を参照)。 - ユーザーの問い合わせに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
--agentフラグを付けて実行します:vercel-admin-pp-cli <command> [subcommand] [args] --agent- あいまいな場合は、サブコマンドのヘルプを確認します:
vercel-admin-pp-cli <command> --help。