从 Claude Code / Cursor 自动部署到 Vercel——用 MCP、Plugin 与 GitHub Actions 的三种工作流

“Claude Code 已经改好了——接下来我手动 push，再到浏览器里打开 Vercel 控制台……”为了减少这种来回切换，Vercel 官方提供了三样工具：Vercel MCP（让 AI 工具操作你的 Vercel 项目、部署和日志的服务器）、Vercel Plugin（给 Claude Code、Cursor 等加上 Vercel 知识和斜杠命令的扩展）以及 Agent Skills（用 npx skills add 安装的操作说明包）。名字相近、作用看上去又有重叠，所以网上流传着 “通过 MCP 接入 Agent Skills” 这类混在一起的说法。

先说结论：把“从 AI 代理部署到 Vercel”分成三种方案来考虑会更清楚。① Git 集成（git push → 自动部署），个人开发基本够用。② 直接在编辑器里操作（Vercel MCP、Vercel Plugin），适合想让 AI 连部署前后的事也一起处理的人——读日志、改环境变量。③ GitHub Actions + Claude Code Action，适合想在 PR 评论里让 @claude 修改、并且只在通过测试或审批后才发布的团队。没有“最强”的方案，关键在于你把多少交给 AI、在哪里由人来叫停。

本文在 2026 年 9 月 30 日重新阅读了 Vercel 和 Anthropic 的官方文档原文后写成。配置示例、命令和套餐条件均以当天为准（两者更新都很快，使用前请到文中链接确认）。也可以搭配阅读 AI 推荐 Vercel、Cursor 是什么 和 AI 能接管基础设施吗？。

1. “Agent Skills”“MCP”“Plugin”是三样东西

即使代码由 AI 来写，确认部署仍在另一块屏幕上：回到终端执行 git add . && git commit -m "fix" && git push，在浏览器里打开 Vercel 控制台，复制预览 URL 再贴到 Slack。为了减少这种切换，Vercel 陆续增加了面向 AI 的入口。

按时间顺序排一下，混淆就解开了。2025 年 8 月 4 日，Vercel MCP 进入公开测试（Vercel 公告）——它是位于 https://mcp.vercel.com 的 采用 OAuth 认证的远程 MCP 服务器。同一个月，即 2025 年 8 月，Anthropic 的 Claude Code GitHub Action 发布 v1.0（v1.0.0 标签日期为 2025-08-25）。2026 年 3 月 17 日推出了 Vercel Plugin（公告），2026 年 7 月 23 日起 Vercel MCP 可以直接部署代码（公告）。

而且 Agent Skills 不是 MCP。Vercel 的 Agent Skills 页面把它描述为用 npx skills add <owner/repo> 安装、教代理按特定方式做事的打包能力，可用于 Claude Code、GitHub Copilot、Cursor 等 18 个以上的代理。如果说 MCP 是在账户上 动手操作的手段，Skills 就是 做法的知识。也可参考 MCP 是什么 和 Claude Agent SDK。

2. Vercel 的五个入口——各自能做什么、怎么认证

下面按官方文档的描述，列出 AI 代理接触 Vercel 的入口（截至 2026 年 9 月 30 日）。“认证”一栏，也就是你交给 AI 的东西，决定了出事时后果有多严重。

来源：Vercel MCP、MCP 工具一览、Vercel Plugin、Agent Skills、提交没有触发部署时（Vercel KB）。

怎么看这张表：如果只需要“能部署”，Git 集成就够了。MCP 和 Plugin 的价值在于把部署前后的工作也放进对话里——让 AI 读日志找出构建失败的原因、显示环境变量的差异、把生产回退一步。

3. 三种方案一览

下面按 “交给 AI 什么 × 自动化深度 × 人在哪里叫停” 来整理三种方案。

选择参考：如果部署后常常只是为了看日志才去开控制台，选②。如果 PR 评审是日常，只想发布测试过的改动，选③。个人博客或小应用用①就够了，硬要升级只会让维护成本超过收益。三者并不互斥，常见做法是以①为基础，再叠加②或③。

4. 方案一：Git 集成（git push 自动部署）

最基础的配置。把 Vercel 和 GitHub 关联之后，每次 git push Vercel 都会构建，构建完成即上线。AI 只需要 写代码、写提交信息、push。Vercel 自己的 GitHub Actions 指南也写道：由于 Git 集成已经负责预览 URL、不可变部署和即时回滚，大多数团队根本不需要流水线。

# 初始设置（只做一次）
1. Vercel 控制台 → Add New → Project
2. 选择 GitHub 仓库 → Import
3. Framework Preset：自动识别（Next.js 等）
4. Environment Variables：按需添加
5. Deploy

# 日常流程（在 Cursor / Claude Code 里）
> 把这个按钮改成红色。改完后 push 到 feature/red-button 分支。

# AI 执行的命令
git switch -c feature/red-button
git add app/components/Button.tsx
git commit -m "feat: change primary button to red"
git push -u origin feature/red-button

# Vercel 构建预览 → PR 上出现预览 URL

这种配置 真正的价值在于 每个分支都会自动得到预览 URL。Vercel 的预览 URL 有两种：始终指向该分支最新内容的分支 URL，以及 指向该次提交所对应部署的提交 URL（Environments）。只要规定只有合并到 main 才进生产，AI 再怎么 push 也只会停在预览。

注意：Hobby 套餐仅限非商业的个人用途（Hobby 套餐）。每天可创建的部署数量 Hobby 为 100 个、Pro 为 6,000 个，Hobby 同一时间只跑一个构建（Limits）。让 AI 频繁地小步 push，最先撞上的就是这些上限。费用陷阱请参阅 AI 推荐 Vercel 第 5 节。

5. 方案二：直接在编辑器里操作（Vercel MCP 与 Vercel Plugin）

如果想让 AI 连部署前后的事也一起做，就用 Vercel MCP 或 Vercel Plugin。两者都不需要把令牌写进文件。

Vercel MCP 的设置（Cursor）：按 官方步骤，只要在 .cursor/mcp.json（项目级或全局均可）里写一个 URL。

{
  "mcpServers": {
    "vercel": {
      "url": "https://mcp.vercel.com"
    }
  }
}

添加后 Cursor 会尝试连接并显示 Needs login。点击它会在浏览器中登录 Vercel，并选择允许 Cursor 使用的团队。Claude Code 则是两行：

claude mcp add --transport http vercel https://mcp.vercel.com
# 启动 claude 后，用 /mcp 完成认证

官方文档还列出了一次性登记到多个客户端的 npx add-mcp https://mcp.vercel.com。注意：只登记服务器并不等于完成了授权。在你登录并允许访问某个团队之前，AI 看不到该团队的部署和日志（工具一览页面）。

MCP 提供的是“工具”，不是斜杠命令。你只需说“查一下最近一次部署的错误”，AI 就会挑选并调用下面这类工具（摘自 2026 年 9 月 30 日的列表）。

Vercel Plugin（npx plugins add vercel/vercel-plugin）会加上 Vercel 知识和 5 个斜杠命令。命令带命名空间：/vercel-plugin:deploy（加 prod 为生产）、/vercel-plugin:env（list、pull、add、remove、diff）、/vercel-plugin:status、/vercel-plugin:bootstrap、/vercel-plugin:marketplace（Vercel Plugin）。读一下 deploy 命令的定义就会发现，它调用的是本地的 Vercel CLI（vercel、vercel --prod），默认部署预览，部署生产前要等用户明确说“是”。没有 /logs 或 /rollback 这样的命令，日志和回滚要用 MCP 工具或 CLI（vercel rollback）。

真正的价值在于 一切都在对话里完成。只要说“加上这个 API，部署到预览，出错就看日志修好”，AI 就会依次进行 改代码 → 部署 → 查看构建日志 → 修复 → 重新部署。按 AI 能接管基础设施吗？ 里的划分，这属于 “能做但危险” 的范围。Vercel 明确写道，MCP 连接会让 AI 拥有 与你的 Vercel 用户账户相同的权限，并建议 始终开启人工确认。不要把工具调用设成自动批准。

6. 方案三：GitHub Actions（@claude 与检查关卡）

面向团队的配置。装上 Claude Code GitHub Actions 后，在 issue 或 PR 评论里 @ 一下 @claude，Claude 就会提交修改并在同一讨论串里回复。预览部署 仍由方案一的 Git 集成负责——Claude 一 push 到 PR 分支，Vercel 就会重新构建预览。

# 设置
1. 在 Claude Code 里执行 /install-github-app（仅限 github.com 上的仓库）
2. 安装 Claude GitHub App，把 ANTHROPIC_API_KEY（或 CLAUDE_CODE_OAUTH_TOKEN）保存到 Secrets
3. .github/workflows/claude.yml 会以 PR 的形式送达

# .github/workflows/claude.yml（官方文档中的示例）
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 30          # 防止任务失控（官方建议）
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write            # 默认的 GitHub App 认证需要
      actions: read              # 读取 PR 上的 CI 结果
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 10"   # 限制每次运行的轮数

timeout-minutes 和 --max-turns 是作为示例加上的，正是官方“Manage costs”一节推荐的两项措施（数值请按项目调整）。默认并没有轮数限制，需要自己设置。

如果还想用 GitHub Actions 来部署——仅限需要在部署前插入测试、漏洞扫描、性能预算或人工审批的情况——请按 Vercel 的 官方指南 来做。Secrets 需要三个：VERCEL_TOKEN、VERCEL_ORG_ID、VERCEL_PROJECT_ID（后两个在 vercel link 生成的 .vercel/project.json 里）。

# .github/workflows/vercel-preview.yml（Vercel KB 中的写法）
name: Vercel Preview Deployment
env:
  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
on:
  push:
    branches-ignore:
      - main
jobs:
  Deploy-Preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install --global vercel@latest
      - run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
      # 在这里插入测试和扫描
      - run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
      - run: vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }}

# vercel.json —— 关闭 Git 触发的自动部署，避免与 Actions 重复部署
{ "git": { "deploymentEnabled": false } }

同一份指南把这些列为陷阱：保留 Git 集成的同时又用 Actions 部署，同一个提交会触发两边；不加 --prebuilt，Vercel 会把同样的东西再构建一遍。反过来，如果只想跑测试，更轻便的做法是保留 Git 集成，在 deployment_status 事件时对预览跑测试，再用 Deployment Checks 拦住向生产的晋升。

# 实际运行的样子
# 开发者创建 PR → Git 集成构建预览
[Bot] Vercel Preview: https://<预览URL>

# 评审者在 PR 上评论
@claude 让这个按钮在 hover 时也变色

# Claude 追加提交并回复 → Vercel 重新构建预览
# 评审者确认 → approve → merge → 生产部署

注意：在私有仓库里，提交作者必须是 Vercel 团队成员（Hobby 则必须是所有者本人），否则不会部署（Vercel KB）。如果在 Actions 中产生的提交没有生成预览，先检查 Vercel Bot 的评论和提交作者。

有了这套配置，“PR 完成之前人不碰代码” 的场景就变得现实。正如 老手与新人、AI 会消灭白领工作吗？ 中所写，团队专注于评审，实现交给 AI，形成分工。

7. 用好预览环境——分支 → URL → 分享

三种方案共同受益的是 充分利用预览环境。Vercel 会为 非生产分支和 PR 自动创建预览部署，因此无需额外设置，就能 把同一改动的多个版本并排比较。

来源：Environments（预发布环境的做法和套餐）、Password Protection（价格）、Sharable Links（Hobby 仅 1 个），均截至 2026 年 9 月 30 日。不用密码的默认保护是 Vercel Authentication（只有团队成员能看），Vercel 称之为推荐的方式。

8. 四个坑——env 泄漏、上限与费用、冲突、回滚

把部署交给 AI 代理，很容易踩到下面四个坑。每一个都能通过事先设置把损失压小。

来源：MCP 的环境变量工具（get_project_env 返回解密后的值）、Spend Management（Pro 和部分 Enterprise 套餐免费提供；用量每隔几分钟检查一次，所以暂停会有一些延迟）、Instant Rollback、Git 配置。

常见的“在 Vercel 前面加一层 Cloudflare 代理”，我们不推荐作为防护手段。Vercel 在 官方 KB 中写明 不推荐 在前面放外部代理：这样 Vercel Firewall 就看不到完整的流量，性能也会下降。

再提醒一点：不建议让 AI 完全自动化生产部署。即便是方案②③，生产也要由人做最终审批。正如 哪些信息不该交给 AI 中提到的，AI 即使 毫无恶意 也可能搞坏生产。预览、预发布可以自动，生产由人审批——设好 两级关卡。

总结

考虑“从 Claude Code / Cursor 部署到 Vercel”时，先 区分 Git 集成、CLI、Vercel MCP、Vercel Plugin 和 Agent Skills。MCP 是通过 OAuth 连接的 操作手段，Plugin 带来 /vercel-plugin:* 命令和知识，Skills 是操作说明。部署本身，大多数情况下 Git 集成就足够了。

选择取决于 把多少交给 AI、在哪里由人叫停：① 个人开发 → Git 集成型；② 想让 AI 连日志排查和 env 管理也做 → Vercel MCP / Plugin 型（不写令牌，用 OAuth 登录）；③ PR 评审是日常的团队 → GitHub Actions 型（@claude 修改；部署由 Git 集成负责，需要检查关卡时用 Actions + CLI）。预览环境用于 A/B 对比、预发布和客户验收，四个坑则用 工具调用确认、上限与费用设置、回滚步骤、生产人工审批来防。

相关文章：AI 推荐 Vercel、Vercel AI SDK、v0 vs Bolt vs Lovable、Cursor 是什么、AI 能接管基础设施吗？。

常见问题

问：Vercel 以外的托管（Cloudflare、Netlify）也能这样做吗？
答：可以。两家都发布了官方 MCP 服务器。Cloudflare 按用途提供了多款通过 OAuth 连接的远程 MCP 服务器，其中包括 Workers 构建用的（Cloudflare 的 MCP 服务器）。Netlify 有 Netlify MCP Server。选择时与其看有没有代理集成，不如看与框架的契合度和价格。也请参阅 AI 推荐 Vercel 中的选择标准。

问：Claude Code 和 Cursor，哪个更适合部署到 Vercel？
答：两者都在 Vercel MCP 和 Vercel Plugin 的支持列表里，在 Vercel 这边能做的事几乎一样。区别在用法：Claude Code 以终端为中心，有官方的 GitHub Actions 集成；Cursor 以编辑器为中心，可以一键添加 MCP。习惯 VS Code 的人用 Cursor 更顺手，习惯终端的人用 Claude Code 更自然。

问：可以让 AI 完全自动化生产部署吗？
答：不建议。预览和预发布可以自动化，但 生产一定要有人做最终审批。原因是 AI 即使没有恶意也可能搞坏生产，而且 出事时责任会变得模糊。用 GitHub 的 Branch Protection 禁止直接 push 到 main，并要求 PR 必须经过审批。

问：.cursor/mcp.json 可以提交到 git 吗？
答：如果是 Vercel MCP 的官方配置，里面没有机密信息。内容只有 https://mcp.vercel.com 这个 URL，认证通过 OAuth 保存在浏览器一侧，为了团队共享而提交也没问题。但如果你把其他 MCP 服务器的 API 密钥直接写在请求头里，情况就不同了，那样的文件不要放进 git。CI 用的 VERCEL_TOKEN 放在 GitHub 的 Secrets 里，不要直接写进工作流文件。

问：担心 GitHub Actions 的费用。
答：据官方文档，费用来自 GitHub Actions 的运行时间和 Claude API 的 token 两部分（如果用订阅的 OAuth 令牌认证，消耗的是 Claude 订阅额度，而不是 API 按量计费）。每次的金额随提示长度、任务复杂度和代码规模而变。官方列出的控制方法有：在 claude_args 中用 --max-turns 限制轮数、给工作流设置超时、把 @claude 的请求写具体、保持 CLAUDE.md 简短。默认没有轮数上限，需要自己设置。