代码都让 AI 写了，部署失败后，还得自己去 Vercel 找日志，再复制回来问它："这是什么问题？"
AI 看完说："能把前面几行也发一下吗？"
行，又跑一趟。代码助手用上了，人还在当快递员。
Vercel MCP 能让这件事省心一些。接好之后，你可以在编码助手里让它创建预览部署、查询部署状态。遇到报错，也可以让它直接读取对应日志，再结合源码排查，省掉来回复制的步骤。
部署和排错步骤是操作示例，我这次实际执行的是项目与日志查询，没有动生产站。
接上以后，哪些事可以交给 AI？
MCP 可以简单理解成 AI 调用外部工具的一种通用方式。Vercel 提供官方服务，授权连接后，编码助手就能使用它开放的工具访问项目。
你原来在后台点的部分操作，可以改成在对话里交代：
| 你要做的事 | 可以怎么交代 |
|---|---|
| 部署新版本 | 把指定仓库的指定提交发成 Preview，返回预览地址 |
| 确认发布状态 | 查这次部署是构建中、成功，还是失败 |
| 排查构建报错 | 读取失败部署的构建日志，引用错误，再检查源码 |
| 排查线上异常 | 查指定部署近期的运行时错误，看看集中在哪些请求上 |
| 核对域名 | 看这个域名属于哪个项目，当前指向哪次部署 |
实际能用哪些操作，要看客户端加载的工具、账号权限和团队设置。
比如，AI 能读项目源码，又能通过 MCP 拿到构建日志，就有条件把"哪里报错"和"哪里写错"放在一起检查。以前这两份材料，往往要你自己搬到同一个窗口里。
准备部署时，先让它发一个预览版
写完功能，不妨这样交代：
text
我准备把【仓库地址】的【分支或完整提交 SHA】
部署到 Vercel 的【团队】下现有【项目】。
先核对代码来源、目标项目和构建设置，给我部署计划。
我确认后再创建 Preview 部署，返回部署 ID 和预览地址，
并继续检查构建状态。
不要改生产域名，不要提交或推送代码，
不要修改环境变量或创建付费资源。这里用 Preview，是想先拿到一个不替换正式站点的预览地址。确认没问题，再单独决定是否发布到生产。
Vercel MCP 的部署工具支持从可访问的 Git 来源或提供的文件内容创建部署。代码已经推送到可访问的仓库，可以按仓库和提交定位；代码只在本地时，Pi 这类编码助手还可能需要配合 Vercel CLI 读取和上传文件。
远程 MCP 服务不能仅凭一句"项目在我电脑的这个目录里"，自己进硬盘拿源码。也别为了凑参数，把 node_modules、.env 和密钥一股脑塞给它。
确认计划后，再明确授权执行。助手创建部署后还得继续查状态，不能刚拿到部署 ID 就宣布成功。"已接单"和"饭到了"，中间还是有段距离的。
构建失败，让它自己拿日志，不用你截一屏红字
拿到失败部署的 ID 或地址，可以接着问：
text
请读取【部署 ID 或部署地址】的构建日志。
找到最早的有效错误，引用原始日志和必要的前后文，
不要只看最后一行 Build failed。
如果你能访问项目源码，请核对相关文件，
说明日志已经证实了什么、还有什么需要检查，
给出最小修改建议。
先不要改代码、环境变量或重新部署。这时，助手可以调用构建日志工具，再根据错误去读源码。比如日志显示找不到某个模块，就检查引用路径、文件是否存在、大小写是否一致。这些检查有了具体对象，不用先端出一大盘"常见原因"，让你自己猜中哪道菜。
需要修复时，再授权它修改相关文件、运行项目的检查和构建。通过以后，可以创建新的 Preview，并核对新部署对应的代码版本。提交和推送代码要另外说清楚，别把"帮我看看"扩大成"顺便上线"。
如果日志取不到，先把接口错误说清楚，再检查授权、保留期和查询条件。缺少证据时，源码分析仍可以继续，但不能把猜测说成已经从日志里查明的原因。
部署成功，页面却有问题？换运行时日志查
构建日志主要回答"安装依赖、编译和打包为什么失败"。网站已经部署完成，服务端请求却报错，就该查运行时日志。
可以给助手更具体的范围：
text
查询【项目】中【部署 ID】最近 30 分钟的运行时错误。
列出主要错误、涉及的请求路径和原始日志证据。
如果能访问源码，核对相关处理逻辑并给出排查建议。
如果查询失败，请说明接口返回的原因；
如果结果为空，请写清查询范围。
不要修改任何配置。运行时日志主要看服务端函数等运行过程。前端按钮失灵、浏览器里的 JavaScript 报错，还需要检查页面和浏览器控制台，不能指望一份服务端日志包办全部故障。
域名也可以让助手帮忙核对：先查绑定的项目和部署，避免一直排查新代码，浏览器访问的却还是另一个部署。涉及修改 DNS 或域名绑定时，再单独确认操作，先查明白再动手。
我用的是 Pi，怎么接？
不用特意换到 ChatGPT。Vercel MCP 支持多种客户端；我本机用的 Pi-Bolt 已经内置 MCP，命令是 pi-bolt。
在终端添加服务：
bash
pi-bolt mcp add vercel \
--url https://mcp.vercel.com \
--exposure deferred再登录授权：
bash
pi-bolt mcp login vercel浏览器会打开授权页面。看清账号、团队和申请的权限，不用把令牌、Cookie 或回调链接发给 AI。
回到 Pi 会话，依次输入：
text
/reload
text
/mcp确认 vercel 已连接、工具已经加载。如果仍提示登录，可以在 /mcp 里选择 Sign in。
这套内置 MCP 的 Pi-Bolt 不需要再装 pi-mcp-adapter。其他版本的 Pi，以对应版本的说明为准。deferred 只是工具按需发现的方式，不是只读开关；提示词里的"只查询"也不会自动收窄账号授权。
Vercel 公告里还有聊天部署卡片，那需要客户端支持 MCP Apps。我这套 Pi-Bolt 不渲染卡片，但可以调用部署和日志工具，不影响上面这些查询。
实际查了一轮，哪些已经跑通？
我让 Pi 查询绑定 seller-bot-murex.vercel.app 的项目。它核对了域名和部署别名，找到了 seller-bot 的当前生产部署，返回状态 READY，来源字段是 cli。随后按部署 ID 查询日志，整个过程没有手动复制后台日志。
这次构建日志返回空列表。运行时日志第一次查最近 1 小时，被接口以 Hobby 套餐保留期限制拒绝；缩到最近 30 分钟后，查询成功，没有匹配记录。
这轮跑通了项目定位和日志查询工具的调用，没有拿到可用于分析故障的日志内容，也没有验证新部署、故障修复或页面功能。空结果只覆盖那次查询的条件，不能写成"全站无故障"。
如果你已经在编码助手里写项目，可以先接上 Vercel，给它一个部署地址，做一次只读查询。确认项目找对、接口能正常返回，再试着把 Preview 部署也交给它处理。