Vercel × AI 编码代理：Plugin、Skills 与 MCP 三件套

一句话目标：用三条官方命令，把 Vercel 的 Plugin、Skills、MCP 三件套装进你的 AI 编码代理，让它直接操作你的 Vercel 项目，省去在终端和对话窗口之间来回切换的功夫。

准备

动手前确认三件事：

1. 终端里能跑 npx（说明 Node.js 已装好）；如果提示 command not found，先装好 Node.js 再继续。
2. 读完进阶手册：让 AI 更懂你的项目，项目里已经配好 AI 编码代理（例如 Claude Code）。
3. 建议先过一遍Vercel 上线：AI 编码代理的一条命令部署，了解代理部署 Vercel 的基本玩法。

三件套各管一段：Plugin 给代理补上 Vercel 官方能力，Skills 提供官方整理的标准做法，MCP 负责把代理连到你的 Vercel 项目。三条命令都来自 Vercel 官方，会自动写入配置，你不用手动改文件；在项目根目录按顺序执行。

跟我做

第 1 步：安装 Vercel Plugin

在项目根目录执行：

npx plugins add vercel/vercel-plugin

第一次跑会先下载包再安装，稍等片刻。预期结果：命令结束没有报错，插件包 vercel/vercel-plugin 进入代理配置，后续对话里代理能认出 Vercel 相关任务。

第 2 步：添加 Agent Skills

接着执行：

npx skills add vercel-labs/agent-skills

它会把 Vercel 官方维护的技能包 vercel-labs/agent-skills 交给代理。按官方文档，这条命令主要面向不在 Plugin 支持列表里的代理；列表内的代理（Claude Code、Codex、Cursor、GitHub Copilot 等）装完第 1 步的 Plugin，就已经获得部署技能与框架最佳实践。预期结果：技能添加成功，代理处理 Vercel 项目里的常见任务时有了官方参考，不再全凭模型记忆自由发挥。

第 3 步：连接 Vercel MCP 服务器

最后执行：

npx -y add-mcp https://mcp.vercel.com -g

这条把 Vercel 官方 MCP（Model Context Protocol）服务器 https://mcp.vercel.com 注册进代理；-y 让 npx 跳过下载确认，命令可以原样复制，-g 表示全局生效，之后所有项目都能连上它。预期结果：命令提示添加成功，mcp.vercel.com 出现在代理的服务器列表里。

验证

新开一个代理会话（新配置不会热加载），直接下指令：

帮我看看 Vercel 上的项目情况，再把当前项目部署上去。

如果代理开始调用 Vercel 相关工具，而不是甩给你一段命令让你自己跑，Vercel MCP 三件套就配通了；部署完成后让它把线上地址发给你，点开确认页面正常。用 Claude Code 的话，还可以输入 /mcp 查看服务器连接状态。

如果代理说找不到相关工具，回到第 3 步确认命令执行成功，再重开会话试一次。

常见坑

• 目录跑错：三条命令都要在项目根目录执行，别在子目录或别的项目里跑。
• npx 停在确认提示：第三条自带 -y 自动确认；前两条若询问是否安装包，按提示确认即可。
• 装完代理没变化：代理不会自动加载新配置，新开一个会话再试。
• MCP 连不上：首次连接 mcp.vercel.com 可能要求完成 Vercel 账号授权，按代理给出的提示走完流程再重试。
• 只装了一两条：Plugin 和 Skills 在官方文档里是按代理二选一（支持列表内装 Plugin、列表外装 Skills），不必两个都装；MCP 独立负责把代理连到你的 Vercel 项目，建议配上。

下一课

到这里，代理已经能替你直接操作 Vercel。下一课自定义域名：从 github.io 到你自己的域名，把部署出来的临时地址换成你自己的域名。想再强化代理对这个项目的理解，可以配合AGENTS.md 与 CLAUDE.md：给 AI 留一份项目说明书一起使用。