Vercel Connect: 에이전트가 외부 서비스에 안전하게 접근하는 방법
요약
Vercel Connect는 에이전트가 외부 서비스(Slack, GitHub 등)에 안전하게 접근할 수 있도록 돕는 기능입니다. 이 시스템은 장기 지속되는 비밀을 저장하는 대신, 필요할 때마다 짧게 지속되고 범위가 지정된 토큰을 요청하여 보안성을 극대화합니다. 또한, 사용자 신원 기반 작동 및 환경별 격리 기능을 제공하여 보안 위험을 최소화했습니다.
핵심 포인트
- 장기 비밀 없이 런타임에 짧고 범위가 지정된 토큰 사용
- 사용자 신원(identity)으로 작동하여 권한 상속 및 제한 가능
- 개발/미리보기/프로덕션 환경별 격리로 보안 강화
- 토큰 요청 기반의 비용 모델과 다양한 커넥터 지원
앱과 에이전트가 환경 변수에 장기 지속되는(long-lived) 제공자 비밀(provider secret)을 저장하지 않고 Slack, GitHub, Salesforce 및 자체 커스텀 API와 같은 외부 서비스에 접근할 수 있게 합니다. 연결자(connector)를 한 번 등록하면, 코드가 필요할 때 런타임에 범위가 지정되고(scoped), 짧게 지속되는 토큰(short-lived tokens)을 요청합니다.Vercel Connect
대시보드나 Vercel CLI에서 연결자를 생성할 수 있습니다:
이후 에이전트는 필요할 때 런타임에 이 연결자로부터 토큰을 요청할 수 있습니다. SDK가 해당 토큰을 자동으로 가져오고 새로 고치므로, 사용자가 직접 저장하거나 순환(rotate)해야 할 비밀이 없습니다:
각 토큰은 그 앞에 있는 작업에 범위가 지정되며, 제공자에 따라 세밀도가 달라집니다. GitHub 토큰은 전체 조직이 아닌 단일 리포지토리에 읽기 전용으로 제한될 수 있습니다. 에이전트는 작업에 필요한 정확한 접근 권한만을 얻으며, 모든 것에 대한 광범위한 영구적 접근 권한을 갖지 않습니다.
토큰은 앱 대신 특정 사용자에게 연결될 수도 있습니다. 그러면 해당 사용자의 신원(identity)으로 작동하며 그들의 권한을 상속받기 때문에, 에이전트는 그 사용자가 할 수 있는 일만 할 수 있습니다:
연결자는 연결된 환경에서만 작동하므로, 개발(development), 미리보기(preview), 프로덕션(production)에 대해 별도의 연결자를 실행할 수 있습니다. 이는 만약 토큰이 개발 환경에서 유출되더라도 프로덕션 환경에서는 사용될 수 없다는 것을 의미합니다:
접근 권한이 토큰 형태로 발급되기 때문에, 자체적으로 또는 연결자가 모든 사용자 및 설치를 거쳐 발행한 모든 토큰을 단일 명령으로 취소(revoke)할 수 있습니다:
또한 제공자로부터 앱으로 이벤트가 흐를 수도 있습니다. 연결자에 트리거(triggers)가 활성화되면, Vercel Connect는 제공자의 들어오는 웹훅(webhooks)을 검증하고 사용자가 선택한 프로젝트로 전달합니다. 따라서 새로운 Slack 메시지가 해당 메시지에 따라 작동하는 에이전트에게 도달할 수 있습니다. 트리거는 Beta 버전에서 Slack, GitHub, Linear를 지원하며, 연결자는 최대 세 개의 프로젝트로 전송할 수 있습니다:
대시보드에서는 Slack, GitHub, Linear, Discord, Notion, Salesforce, Figma, Snowflake에 대한 전용 커넥터가 제공되며, 일반 OAuth 및 API 키 커넥터도 사용할 수 있습니다. 또한 CLI를 통해 .과 같은 MCP 서버를 포함하여 다른 서비스의 커넥터를 생성할 수 있습니다. Vercel Connect는 Better Auth, Auth.js, eve, AI SDK, 그리고 MCP 클라이언트를 위한 어댑터도 제공하므로, 이미 사용하고 있는 인증 라이브러리 및 에이전트 도구와 함께 작동합니다.
가격은 토큰 요청을 기준으로 합니다. Hobby 플랜은 추가 비용 없이 매월 5,000개를 포함하며, Pro 및 Enterprise는 10,000개당 $3로 청구됩니다.
현재 Public Beta에서 사용 가능합니다. [Vercel Connect]의 문서를 읽거나, npx skills add vercel/vercel-plugin --skill vercel-connect 명령어로 vercel-connect 스킬을 설치하여 코딩 에이전트가 설정하도록 할 수 있습니다.
범위 지정 토큰 (Scoped tokens)
격리 및 취소 (Isolation and revocation)
트리거 (Triggers)
커넥터 및 어댑터 (Connectors and adapters)
시작하기 (Get started)
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기