mcpField
V
vercel

vercel

github.com/openhands云与 DevOps17570 次安装1 天前更新
代码仓库

关于 vercel

介绍 Vercel 部署操作的技能，涵盖自动化访问的保护绕过、环境变量和常用 CLI 命令，并说明受保护预览部署的处理方式。

主要功能

  1. 01识别受保护的预览部署
  2. 02配置自动化绕过密钥
  3. 03通过请求头或 URL 传递绕过密钥
  4. 04设置环境变量
  5. 05使用常见 Vercel CLI 命令

适用场景

  1. 01为测试访问受保护的预览部署
  2. 02在 Vercel 中配置环境变量
  3. 03部署预览版或生产版本

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/vercel确认已加载。

附带文件.plugin/plugin.jsonREADME.md

详细介绍

Vercel 部署指南

部署保护与 Agent 访问

Vercel 部署可能启用了部署保护，访问预览部署时需要进行身份验证。这可能会阻止自动化测试和 Agent 访问预览 URL。

识别受保护的部署

如果访问 Vercel 预览 URL 时遇到登录页面或身份验证要求，则表示该部署已启用保护。常见迹象包括：

  • 重定向到 vercel.com/login 或 SSO 登录页面
  • 访问部署时出现 401/403 错误
  • 预览 URL 要求用户加入 Vercel 团队
通过保护绕过功能启用 Agent 访问

如需允许 Agent 和自动化系统访问受保护的部署，用户需要设置自动化保护绕过：

  1. 前往项目设置

    • 前往 Vercel Dashboard
    • 选择项目
    • 点击 Settings → Deployment Protection

  2. 生成保护绕过密钥

    • 在“Protection Bypass for Automation”下，点击 Generate Secret
    • 安全地复制生成的密钥

  3. 使用绕过密钥

    密钥可以通过两种方式使用：

    作为标头：

    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