Vercel MCP 用 mcp.vercel.com,不要加 /mcp 后缀

CLI:codex mcp add vercel --url https://mcp.vercel.com,再 mcp login vercel。官方远程没有 /mcp 后缀。不要把 npx add-mcp 或 vercel mcp 当 Codex 主路径。

Vercel 官方给 Codex CLI 的是远程 Streamable HTTP,地址是 https://mcp.vercel.com没有 /mcp 后缀(和 Stripe 一样)。官方 Codex 节:

codex mcp add vercel --url https://mcp.vercel.com
codex mcp login vercel

add 时会探测 OAuth 并开浏览器;没弹出再跑 codex mcp login vercel。手写 TOML 效果一样:

[mcp_servers.vercel]
url = "https://mcp.vercel.com"
enabled = true

连上之后权限跟你的 Vercel 账号走。公开工具(搜文档)可以不登录;管项目、部署、日志、Web Analytics 要 OAuth。保持工具批准,不要一上来 --yolo

要限定到某个项目时,把 URL 写成 https://mcp.vercel.com/acme/my-app(团队 slug / 项目名),再 mcp add / mcp login。这是自己写进 url,不是跑 vercel mcp --project

若浏览器停在 The app redirect URL is invalidredirect_uri 会带 callback ID,形如 http://127.0.0.1:49683/callback/J69OfRTZqnV5。这是 Vercel 侧 allowlist 拒这种 loopback,不是你能在 TOML 里修好的。不要自己建 Sign in with Vercel 应用去打 mcp.vercel.com——那些 token 只对 REST,不是 MCP。官方页仍列 Codex CLI,不要当成「现行一定失败」。完整回调规则见「MCP OAuth 登记完整回调」那条。

不要做这些:

  • 不要把 npx add-mcp https://mcp.vercel.com 当 Codex 主路径。它会改所有检测到的 agent。
  • 不要跑 vercel mcp。那条 CLI 的客户端名单只有 Claude Code、Claude.ai、Cursor、VS Code,没有 Codex。
  • 不要抄 Gemini 的 npx mcp-remote,也不要抄 Claude 的 --transport http
  • 不要把 npx plugins add vercel/vercel-plugin 当成这条 MCP。那是插件 / 技能路径。
  • 不要和 AI Gateway 的 [model_providers.vercel] 搞混。那是模型供应商,不是这台 MCP。
  • 不要给它 required = true 挂全局。
  • 不要抄 /sse,也不要给 HTTP 写 env 表。

网页 Cloud 不读 ~/.codex/config.toml。改完新开会话。用 codex mcp get vercel 看传输是 streamable_http。

来源