用途:Vercel Connect 用于代表应用或用户安全获取访问第三方服务的作用域令牌。它使用 Vercel OIDC 令牌经 Vercel API 换取 Connect 令牌,适用于发送 Slack 消息、访问 GitHub 仓库或 API、连接需要 OAuth 令牌或 API 凭据的第三方系统,以及为已认证 API 调用获取令牌。
令牌主体类型:user(代表特定终端用户操作,需 user id 及可选 issuer);app(以应用自身身份操作,无同意流程,连接器未安装则终止失败);jwt-bearer(RFC 7523 JWT 断言交换,需 sub,可选 iss、aud 及 additionalClaims)。
使用方式:CLI 用 vercel connect create <service> 创建连接器、vercel connect list 列出、vercel connect token <connector> --subject user|app 获取令牌,均支持 --format=json。务必在将使用该连接的项目或智能体目录(含 package.json / vercel.json)中运行,否则需手动配置或传 --cwd <DIR>。创建和取令牌可能打开浏览器完成 OAuth 同意或安装应用,需用户配合。
JavaScript/TypeScript 用 @vercel/connect 的 getToken;Eve 项目可用 @vercel/connect/eve 的 connect 及 connectSlackCredentials、connectGitHubCredentials、connectLinearCredentials 等辅助函数;其他语言可直接请求 POST https://api.vercel.com/v1/connect/token/<connector>,以 VERCEL_OIDC_TOKEN 认证。Better Auth 与 Auth.js 可分别通过 @vercel/connect/betterauth、@vercel/connect/authjs 将连接器作为 OAuth 提供方接入。
支持服务:slack(user、bot)、github(user、app)、任意 MCP 服务器(user、app,注册时传完整端点 URL,连接器 ID 形如 mcp.<host>/<name>)、snowflake(user)、通用 OAuth 2.0 提供方(user、app)。
限制:需已认证 Vercel CLI 且操作限于当前所选团队;SDK 依赖用户已运行 vc env pull 拉取 OIDC 环境变量;app 模式无同意流程,未安装即失败;令牌应存入变量复用,避免在终端或日志中回显。具体收费、价格与平台支持范围资料未提供。