Vercel Connect의 Stripe 관리형 API 키

발행 2026.10.23출처 vercel.com · Dima Voytenko

Vercel레퍼런스준전문가

Vercel Connect, Managed Stripe API 키 추가

Vercel Connect는 이제 각 에이전트나 작업마다 별도의 제한된 Stripe API 키를 생성할 수 있습니다. Stripe 커넥터를 만들 때 연결 방법으로 Managed API Key를 선택할 수 있습니다.

Vercel은 사용자가 선택한 권한으로 제한된 키를 Stripe 계정에 생성합니다. 기존의 MCP 및 bring-your-own API key 방식은 그대로 유지됩니다.

대부분의 앱과 에이전트는 Stripe의 기본 시크릿 키로 실행되며, 이 키는 계정 전체에 대한 모든 권한을 가집니다. 에이전트별 키를 사용하면 각 에이전트는 자신의 작업에 필요한 접근 권한만 받습니다. 예를 들어, 매일 매출 보고서를 생성하는 에이전트는 결제 정보에 대한 읽기 전용 접근으로 제한할 수 있고, 온보딩 에이전트는 고객에 대한 쓰기 접근으로 제한할 수 있습니다.

Vercel이 키를 생성하고 저장하므로, 직접 붙여 넣을 시크릿 키가 없습니다. 재배포 없이 커넥터의 설정에서 키를 교체할 수 있으며, 전환하는 동안 이전 키는 최대 24시간 동안 계속 유효합니다.

Stripe 커넥터 추가

커넥터 디렉터리에서 Stripe 커넥터를 만들고, Managed API Key를 선택한 다음 권한을 고르고 프로젝트에 연결하세요. CLI에서 시작할 수도 있으며, 그러면 설정을 마치기 위해 브라우저가 열립니다:

bash

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

Vercel CLI로 Stripe 커넥터 추가

typescript

12345678910111213141
import Stripe from 'stripe';
2
import { getToken } from '@vercel/connect';
3
const key = await getToken('stripe/acme-stripe', {
4
  subject: { type: 'app' },
5
});
6
const stripe = new Stripe(key);
7
const customers = await stripe.customers.list({ limit: 10 });