mcpField
V
vercel

vercel

github.com/openhandsクラウド・DevOps17570 回インストール1 日前に更新
リポジトリ

vercel について

自動アクセス向けの保護バイパス、環境変数、一般的な CLI コマンドを扱う Vercel デプロイガイドのスキルです。保護されたプレビュー環境への対処方法も説明します。

主な機能

  1. 01保護されたプレビュー環境の特定
  2. 02自動化用バイパスシークレットの設定
  3. 03ヘッダーや URL によるシークレットの指定
  4. 04環境変数の設定
  5. 05一般的な Vercel CLI コマンドの利用

活用シーン

  1. 01テストのための保護されたプレビュー環境へのアクセス
  2. 02Vercel での環境変数の設定
  3. 03プレビュー版または本番環境へのデプロイ

インストール

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

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

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

同梱ファイル.plugin/plugin.jsonREADME.md

詳細

Vercel デプロイガイド

デプロイ保護とエージェントのアクセス

Vercel のデプロイでは、プレビュー環境へのアクセスに認証が必要な デプロイ保護 が有効になっている場合があります。これにより、自動テストやプレビュー URL へのエージェントのアクセスがブロックされることがあります。

保護されたデプロイの特定

Vercel のプレビュー URL にアクセスしたときにログインページが表示されたり、認証を求められたりする場合は、デプロイ保護が有効になっています。次のような兆候があります。

  • vercel.com/login または SSO ログインページへのリダイレクト
  • デプロイへのアクセス時に 401／403 エラーが発生する
  • Vercel チームへの参加が必要なプレビュー URL
保護バイパスによるエージェントのアクセス許可

保護されたデプロイにエージェントや自動化システムがアクセスできるようにするには、ユーザーが 自動化用保護バイパス を設定する必要があります。

  1. プロジェクト設定に移動する

    • Vercel Dashboard に移動します
    • プロジェクトを選択します
    • Settings → Deployment Protection をクリックします

  2. 保護バイパスシークレットを生成する

    • 「Protection Bypass for Automation」の下にある Generate Secret をクリックします
    • 生成されたシークレットを安全にコピーします

  3. バイパスシークレットを使用する

    シークレットは次の 2 つの方法で使用できます。

    ヘッダーとして使用する場合：

    curl -H "x-vercel-protection-bypass: <secret>" https://your-preview-url.vercel.app

    PowerShell の場合：

    Invoke-WebRequest -Headers @{ "x-vercel-protection-bypass" = "<secret>" } -Uri https://your-preview-url.vercel.app

    クエリパラメーターとして使用する場合：

    https://your-preview-url.vercel.app?x-vercel-protection-bypass=<secret>

  4. ブラウザーベースのテストの場合

    • プレビュー URL に ?x-vercel-protection-bypass=<secret> を追加します
    • 以降のリクエストでは、シークレットが Cookie に保存されます
代替方法：プレビューの保護を無効にする

保護バイパスが適さない場合は、プレビューデプロイの保護を無効にできます。

  1. Settings → Deployment Protection に移動します
  2. 「Vercel Authentication」を Only Production Deployments または Disabled に設定します
認証要件のために Vercel のプレビューデプロイにアクセスできない場合は、次のいずれかが必要であることをユーザーに伝えてください。 1. 保護バイパスシークレットを設定し、それを提供すること、または 2. Vercel プロジェクト設定で、プレビューデプロイのデプロイ保護を無効にすること

バイパスシークレットなしで、保護された URL へのアクセスを繰り返し試みてはいけません。

環境変数

Vercel Dashboard の Settings → Environment Variables で環境変数を設定するか、Vercel CLI を使用します。

vercel env add MY_SECRET

アプリケーションでのアクセス方法：

const secret = process.env.MY_SECRET;

Vercel CLI コマンド

よく使われる Vercel CLI コマンド：

# Login to Vercel
vercel login

# Deploy to preview
vercel

# Deploy to production
vercel --prod

# List deployments
vercel ls

# View deployment logs
vercel logs <deployment-url>

# Pull environment variables locally
vercel env pull

コメント

Markdown 対応