---
title: "Vercel MCP 用 mcp.vercel.com，不要加 /mcp 后缀"
summary: "CLI：codex mcp add vercel --url https://mcp.vercel.com，再 mcp login vercel。官方远程没有 /mcp 后缀。不要把 npx add-mcp 或 vercel mcp 当 Codex 主路径。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Vercel", "OAuth", "HTTP"]
canonical: /tips/mcp-vercel-remote/
---

# 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 节：

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

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

```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 invalid**，`redirect_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。

## 来源

- [Vercel · MCP](https://vercel.com/docs/agent-resources/vercel-mcp)
- [Vercel Community · redirect URL is invalid](https://community.vercel.com/t/codex-cli-vercel-mcp-login-fails-with-the-app-redirect-url-is-invalid/42756)
- [OpenAI · Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp)