手冊 · Vercel agents
Vercel agent 工具 — plugin、MCP、AI Gateway
裝 plugin、接 MCP,可選用 AI Gateway 統一模型用量。
2026-10-16
一句承諾
幫 coding agent 接上 Vercel plugin(skills/context)、MCP(OAuth 後查 project/deploy/docs)、同可選 AI Gateway(統一 agent 模型流量)。唔係教你點 deploy preview/production(嗰篇係 Vercel 預覽部署)。
同 deploy 篇點分
| 呢篇(agent toolchain) | 姊妹篇(deploy) |
|---|---|
| Plugin + MCP + AI Gateway | Project 同 preview URL |
| STOP:OAuth/API key/經 MCP 嘅 prod 動作 | STOP:買域名、promote production |
適合/唔適合
| 適合 | 唔適合 |
|---|---|
| 已經喺度寫 hub、想 Cursor/Claude Code/Codex 等識 Vercel | 只想要 preview URL → 去 Vercel 預覽部署 |
| 「bot 打 checklist、你控登入/OAuth/key/上線」 | 以為 MCP 可以跳過你自己撳嘅域名、收款同 production |
| 想集中睇 coding agent 模型開銷 | 未準備好接 agent 嘅專案 |
Stack
- Vercel plugin(plugin)
- Vercel MCP:
https://mcp.vercel.com(MCP) - 可選 AI Gateway(getting started、coding agents)
vercel setup一次搞 plugin + gateway(CLI setup)- Agent Plugins 1.0 格式背景(KB)——日常係裝官方
vercel/vercel-plugin
Bot vs 你
| Bot | 你(human) |
|---|---|
| 寫 playbook/SEO/步驟 | 擁有 Vercel 帳號/team |
| 抄官方 install 指令 | 自己喺終端/IDE 跑;完成 MCP 瀏覽器 OAuth |
| 列明 docs 有邊啲 skill/slash command | 決定邊啲 agent 行 AI Gateway;自己建/貼 key(唔貼 chat/git) |
| 唔會代你批 prod/買域名 | 任何 MCP deploy/purchase/promote 都要你確認 |
步驟
- 今日需要:context → plugin;對住你嘅 team 查 deploy/log → MCP;統一模型帳單 → AI Gateway。Preview URL 去姊妹篇。
- 裝 plugin:
npx plugins add vercel/vercel-plugin;OpenCode:opencode plugin add github:vercel/vercel-plugin(plugin)。按需用/vercel-plugin:…;deploy prod你準備好先用。 - 可選:
vercel setup(或--plugin/--gateway/--dry-run)(CLI setup)。 - 接 MCP:
npx -y add-mcp https://mcp.vercel.com -g;Cursor 可寫.cursor/mcp.json指向https://mcp.vercel.com;完成 OAuth + team grant(MCP)。 - 開 human confirmation;只用官方 endpoint;工具清單以你 client 顯示為準(tools)。
- 可選 AI Gateway:
npx vercel@latest ai-gateway setup;key 用AI_GATEWAY_API_KEY;coding-agent basehttps://ai-gateway.vercel.sh/coding-agent/v1;smoke test 跟 getting-started(模型 slug 以你 team 可呼叫為準)。 - Plugin telemetry:
VERCEL_PLUGIN_TELEMETRY=off可關;debug 用VERCEL_PLUGIN_LOG_LEVEL/npx vercel-plugin doctor。 - 你自己撳: OAuth、prod、域名、收款、Send。
失敗模式/注意
- 裝咗 plugin ≠ 已 deploy hub。
- 加咗 MCP 但未 login/錯 team → 冇 project。
- 假 MCP URL/prompt injection → 跟官方 security 段。
- AI Gateway 會產生帳單;唔好吹「永久免費」。
- 模型 ID/支援 client 名單會變——你必須核對當日 docs/Dashboard。
Newsletter CTA
如果仲未有預覽 URL,下一篇係 用 Vercel 部署。
你必須核對
同上 EN「Human must verify」清單 1–8。
引用文件
- Agent Resources · 2026-10-16
- Vercel Plugin for AI Coding Agents · 2026-10-16
- Use Vercel MCP · 2026-10-16
- Vercel MCP tools · 2026-10-16
- Getting Started with AI Gateway · 2026-10-16
- Coding Agents and Chat Platforms with AI Gateway · 2026-10-16
- vercel setup CLI · 2026-10-16
- The Complete Guide to Agent Plugins · 2026-10-16