mcpField
V
vercel

vercel

github.com/acedatacloudクラウド・DevOps17167 回インストール今日更新
リポジトリ

vercel について

curl と jq で Vercel REST API を操作するコマンドラインスキルです。プロジェクトやデプロイの確認、ビルド診断、ドメイン確認に加え、環境変数の保護や本番環境への再デプロイ確認も扱います。

主な機能

  1. 01プロジェクトとデプロイの一覧表示
  2. 02デプロイ状態と詳細の確認
  3. 03ビルドおよびランタイムログの取得
  4. 04プロジェクトドメインの確認
  5. 05チーム単位の API リクエスト

活用シーン

  1. 01最近のデプロイの確認
  2. 02ビルド失敗の診断
  3. 03ドメインの検証状態の確認
  4. 04プロジェクトのデプロイ状態の把握

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acedatacloud/skills --skill vercel

インストール後、Claude Code で/vercelを入力して読み込まれたか確認します。

詳細

curl + jq でVercel REST APIを呼び出します。ユーザーのトークンは $VERCEL_ACCESS_TOKEN に格納されています。すべての呼び出しで Authorization: Bearer $VERCEL_ACCESS_TOKEN が必要です。ベース URL：https://api.vercel.com。リソースが チームスコープの場合は、?teamId=$VERCEL_TEAM_ID を追加します（ユーザーがチームトークンを接続した場合のみ設定します）。

エラーは {"error":{"code","message"}} の形式で返されます。message をそのまま表示してください。 403 forbidden は通常、トークンからそのチーム／プロジェクトが見えないことを意味します → 適切なスコープで再接続してください。

任意のチームパラメーター用ヘルパー：

TEAM=""; [ -n "$VERCEL_TEAM_ID" ] && TEAM="?teamId=$VERCEL_TEAM_ID"
AUTH="Authorization: Bearer $VERCEL_ACCESS_TOKEN"

プロジェクトとデプロイ

# Projects
curl -sS -H "$AUTH" "https://api.vercel.com/v9/projects$TEAM" \
  | jq '.projects[] | {name, framework, latestProduction: .latestDeployments[0].url}'

# Recent deployments (optionally filter by ?projectId=… or &state=ERROR)
curl -sS -H "$AUTH" "https://api.vercel.com/v6/deployments${TEAM:-?}&limit=20" \
  | jq '.deployments[] | {uid, name, url, state, readyState, created}'

失敗したビルドの診断

# Deployment detail
curl -sS -H "$AUTH" "https://api.vercel.com/v13/deployments/DEPLOYMENT_ID${TEAM:+&teamId=$VERCEL_TEAM_ID}" \
  | jq '{name, url, state: .readyState, error: .errorMessage}'

# Build / runtime events (the actual logs)
curl -sS -H "$AUTH" "https://api.vercel.com/v3/deployments/DEPLOYMENT_ID/events${TEAM:+?teamId=$VERCEL_TEAM_ID}" \
  | jq -r '.[] | select(.type=="stdout" or .type=="stderr") | .payload.text'

ドメインと再デプロイ

# Project domains
curl -sS -H "$AUTH" "https://api.vercel.com/v9/projects/PROJECT_ID/domains${TEAM:+?teamId=$VERCEL_TEAM_ID}" \
  | jq '.domains[] | {name, verified}'

再デプロイするには、deploymentId（または Git ソース）を本文に指定して https://api.vercel.com/v13/deployments に POST します。本番環境に反映されるため、必ず最初にユーザーに確認してください。

注意点

  • 環境変数の値は絶対に表示しないでください。 プロジェクトの環境変数を一覧表示するとメタデータが返されます。 /v1/.../env/{id} の復号ルートはシークレットを返します。ユーザーから明示的に依頼されない限り呼び出さないでください。 その場合でも、内容を要約し、そのまま出力しないでください。
  • デプロイの state／readyState：QUEUED → BUILDING → READY | ERROR | CANCELED。
  • created／ready はエポックミリ秒です。人が読める時刻にするには 1000 で割ってください。

コメント

Markdown 対応