Vercel MCP Server 用于 Microsoft Copilot Studio

一个零依赖的 Model Context Protocol 服务器，专为 Vercel 平台构建，专门用于与 Microsoft Copilot Studio 配合使用（它需要 Streamable HTTP 传输并支持 API 密钥认证）。

为什么存在： Vercel 官方 MCP 服务器（https://mcp.vercel.com）使用 OAuth 和动态客户端注册，而 Copilot Studio 的 MCP 接入无法完成该流程。此服务器弥补了这一差距：您在 Copilot Studio 中输入的 API 密钥就是您的 Vercel 访问令牌，每个请求都会转发到 Vercel REST API。服务器本身是无状态的，不存储任何内容。

工具

部署

选项 A — 部署到 Vercel（推荐，约 1 分钟）

或者使用 CLI：

vercel deploy --prod

您的 MCP 端点将是：https://<your-deployment>.vercel.app/mcp

选项 B — 自托管（任何 Node 18+ 主机）

node server.js        # listens on PORT (default 3000), endpoint /mcp

无需 npm install — 没有依赖项。

从 Copilot Studio 连接

1. 在 https://vercel.com/account/settings/tokens 创建 Vercel 访问令牌（将其范围限定为您希望代理管理的团队/项目）。

2. 在 Copilot Studio 中，打开您的代理 → 工具 → 添加工具 → Model Context Protocol (MCP)。

3. 填写：

   • 名称： Vercel

   • 描述： 管理 Vercel 项目、部署、构建日志、域名和环境变量。

   • 服务器 URL： https://<your-deployment>.vercel.app/mcp

   • 身份验证： API 密钥

     • 标头名称/位置： x-api-key（标头）

     • 值： 您的 Vercel 访问令牌

4. 单击 添加 → Copilot Studio 执行 MCP 握手并列出所有 13 个工具。

5. 创建连接，在连接管理器中启用它，然后在预览窗格中测试，例如：

   • “列出我的 Vercel 项目”

   • “显示 my-site 最新失败部署的构建日志”

   • “仅将环境变量 API_URL=https://api.example.com 添加到 my-site 以用于预览”

服务器还通过 Authorization: Bearer <token> 或 x-vercel-token 标头接受令牌，并回退到 VERCEL_TOKEN 环境变量用于单租户自托管部署（在这种情况下，在 Copilot Studio 中选择 无身份验证 — 仅当服务器 URL 本身受保护/私有时才这样做）。

架构

Copilot Studio ──POST /mcp (JSON-RPC, Streamable HTTP)──▶ this server ──REST──▶ api.vercel.com
                     x-api-key: <vercel access token>          (stateless, no storage)

• 传输： MCP Streamable HTTP，无状态模式（协议版本 2024-11-05 → 2025-06-18）。无需会话，无需 SSE — 非常适合无服务器。

• 身份验证： 透传。服务器从不存储令牌；每个请求都携带调用者自己的 Vercel 令牌。

• 零依赖： 纯 Node.js ≥18。无需安装任何内容，无供应链。

开发与测试

node test/mcp.test.js

测试套件启动真实的 HTTP 服务器，模拟 api.vercel.com，并驱动完整的 MCP 握手（initialize → initialized → tools/list → tools/call），以及错误路径（错误令牌、未知工具/方法、格式错误的 JSON、批处理）。

安全说明

• 使用作用域 Vercel 令牌，最好在具有最低权限的专用团队上。

• list_env_vars 永远不会返回机密环境变量值。

• 仅在 HTTPS 下部署（在 Vercel 上自动）。Copilot Studio 需要 HTTPS。

• 如果您保护部署，请考虑 Vercel Deployment Protection 绕过标头。

许可证

MIT