Vercel Connect 用于代表应用或用户安全获取访问第三方服务的受限令牌,借助 Vercel OIDC 令牌通过 Vercel API 换取 Vercel Connect 令牌。适用于通过 Slack 发消息、访问 GitHub 仓库或 API、连接任何需要 OAuth 令牌的第三方系统,以及为已认证 API 调用获取令牌。
令牌支持三种主体类型:user(代表特定终端用户操作,需用户 id 及可选 issuer);app(以应用自身身份操作,无同意流程,连接器未安装则终止失败);jwt-bearer(RFC 7523 JWT 持有者交换,需传 sub,可选 iss、aud 与 additionalClaims)。
使用方式有三种。命令行用 vercel connect CLI,需先完成 Vercel CLI 认证,命令在当前选定的 Vercel 团队范围内生效;务必在将使用该连接的项目或智能体目录(含 package.json / vercel.json)中运行,以便自动配置连接,否则需手工接线,也可用 --cwd 指定目录。常用命令:vercel connect create <service> 创建连接器、vercel connect list 列出连接器、vercel connect token <connector> --subject user|app 获取令牌,均支持 --format=json。创建与获取令牌可能打开浏览器完成手动注册或 OAuth 同意,需用户访问该 URL 完成流程。JavaScript/TypeScript 可用 @vercel/connect 包的 getToken 方法,SDK 使用用户 Vercel OIDC 令牌认证,用户应已运行 vc env pull 或 vc link 拉取本地 OIDC 环境变量。其他语言可直接向 https://api.vercel.com/v1/connect/token/<connector> 发起 POST 请求,请求头携带 VERCEL_OIDC_TOKEN,响应 JSON 含 token 及 expiresAt 等元数据。
支持的服务包括 slack(user、bot)、github(user、app)、MCP 服务器(user、app,格式 mcp.<host>/<path>)、snowflake(user)、通用 OAuth 提供商(user、app)。注册 MCP 服务器时需传完整端点 URL,如 vercel connect create https://mcp.linear.app/mcp,连接器 ID 形如 mcp.linear.app/myagent。
限制与注意事项:存在多个连接器时应让用户在之间选择或询问是否新建;注册时应提供最精确的服务器 URL,短别名可能解析到与所需传输或路径不符的默认端点;令牌值应存入变量后在后续命令中使用,避免在终端或日志中回显,避免用 && 与其他命令拼接;应尽量复用已有令牌;获取令牌时可加 --yes 以触发重新授权流程;创建命令可能打开浏览器,建议先取得用户批准。文档未提供具体收费、价格与平台支持范围信息。