Vercel Connect为Stripe提供托管式受限API密钥

AI Agent 接入第三方支付服务时，API 密钥往往意味着一把"万能钥匙"。Vercel 正在尝试改变这一局面：其 Vercel Connect 服务新增了 Managed API Key（托管 API 密钥） 连接模式，可为每个 Agent 或任务单独创建受限的 Stripe 密钥。

从"万能密钥"到按需授权

据 Vercel 官方说明，目前大多数应用和 Agent 直接使用 Stripe 的默认 secret key，而这把密钥拥有账户的完整访问权限。一旦密钥泄露或 Agent 行为失控，攻击面覆盖整个支付账户。

托管 API 密钥的价值在于最小权限原则的落地。开发者创建 Stripe 连接器时选择 Managed API Key 模式，Vercel 会在开发者的 Stripe 账户中生成一把密钥，并将权限严格限制在所选范围内。官方给出的两个典型场景很能说明问题：每日营收报告 Agent 只被授予 charges 的只读权限，而用户引导（onboarding）Agent 则只被授予 customers 的写入权限。

换句话说，每个 Agent 拿到的是"只够干这件事"的凭证，而非整个账户的控制权。

最小权限原则（Principle of Least Privilege，PoLP）是信息安全领域的基础准则之一，指任何主体（用户、程序或 Agent）只应被授予完成其特定任务所必需的最小访问权限，且仅在必要时间内持有。该原则最早由 Saltzer 与 Schroeder 在 1975 年的论文中系统阐述，现已被零信任架构、OAuth 2.0 授权范围（scope）等机制广泛采用。在 Stripe 的场景中，最小权限意味着把账户级 secret key 拆解为按资源类型（charges、customers、payment_intents 等）与操作类型（只读、写入）划分的细粒度权限。实践难点在于权限粒度与运维成本的平衡：粒度过粗则隔离失效，过细则连接器配置与密钥管理变得繁琐。Vercel 将权限选择前置到连接器创建阶段，正是试图把这一权衡交给平台自动处理。

密钥由 Vercel 托管，轮换不再需要重新部署

托管模式带来的另一个变化是密钥生命周期的管理方式。密钥由 Vercel 创建并存储，开发者无需在代码或环境变量中粘贴 secret key。需要轮换时，直接在连接器设置中操作即可，无需重新部署应用；旧密钥在新密钥生效后仍可保持最长 24 小时有效，为切换留出缓冲窗口。

这一设计对持续运行的 Agent 服务尤为实用——密钥轮换以往意味着一次发布流程，现在则接近一次配置变更。

密钥轮换（Key Rotation）指定期或在疑似泄露后废弃旧凭证、签发新凭证的安全实践，是 SOC 2、PCI DSS 等合规框架的常见要求。传统做法中，secret key 以环境变量形式注入应用，轮换时必须更新配置并重新部署，期间容易产生服务中断或旧密钥残留。24 小时的双密钥并存窗口属于"重叠轮换"（overlapping rotation）策略，使新旧凭证在过渡期内同时有效，从而支持无中断切换。托管模式下，密钥的生成、存储与吊销由平台统一完成，通常配合密钥管理服务（KMS）或硬件安全模块实现加密存储，开发者接触不到明文密钥，也就减少了密钥经由代码仓库、日志或构建产物泄露的风险面。

三种连接方式并存

此次更新并未改动已有的接入路径。Vercel Connect 目前支持三种 Stripe 连接方式：

• Managed API Key：由 Vercel 创建并托管受限密钥，本次新增
• MCP：通过 MCP 协议接入，保持不变
• Bring-your-own API key：自带密钥，保持不变

开发者可以按团队的安全要求和既有架构选择合适的方式，已有项目无需迁移。

MCP（Model Context Protocol，模型上下文协议）是由 Anthropic 提出并开源的标准化协议，用于让 AI 模型与 Agent 以统一方式连接外部工具、数据源和服务。其基本结构是 MCP 服务器对外暴露工具（tools）、资源（resources）与提示模板，客户端（通常是 Agent 运行时）按协议发起调用。相较直接持有 API 密钥，MCP 方式把凭证交由 MCP 服务器管理，Agent 只看到抽象后的工具接口。三种连接方式的定位因此有所区分：MCP 适合已有 MCP 服务器封装的场景，自带密钥适合需要完全掌控凭证或已有密钥管理体系的团队，而以本次新增的托管密钥最为省心。理解三者差异有助于开发者在安全边界、运维负担与灵活性之间做出取舍。

接入流程：控制台与命令行均可

添加 Stripe 连接器的入口是 Vercel 的 connectors 目录：选择 Managed API Key，勾选权限范围，再将其绑定到目标项目。习惯命令行的团队也可以直接通过 CLI 完成，命令会自动打开浏览器完成授权：

vercel connect create stripe --connection-method managed-api-key --name acme-stripe
vercel connect attach stripe/acme-stripe --project my-app --environment production

运行时获取密钥的方式同样简洁：调用 @vercel/connect 提供的 getToken，传入连接器的 UID，即可拿到受限密钥并交给 Stripe SDK 使用：

import Stripe from 'stripe';
import { getToken } from '@vercel/connect';

const key = await getToken('stripe/acme-stripe', {
  subject: { type: 'app' },
});
const stripe = new Stripe(key);
const customers = await stripe.customers.list({ limit: 10 });

权限隔离正成为 Agent 基础设施的标配

把这件事放到更大的背景下看，Vercel 的这次更新回应的是 Agent 落地过程中的一个真实矛盾：Agent 需要自主调用外部服务，但企业不愿为此交出全权限凭证。按 Agent、按任务发放受限密钥，本质上是在把传统的服务账户治理思路引入 Agent 场景。

Vercel 承担密钥的创建与存储，意味着安全边界从应用代码层上移至平台层，开发者少了一处需要自行保管的敏感信息。至于这种托管模式能否覆盖更多第三方服务、权限粒度会细到什么程度，将决定 Vercel Connect 在 Agent 工具链中的实际分量。目前，该功能已可通过 Stripe 连接器直接使用，相关细节可查阅官方文档。