기능 하나를 함께 켜려고 키까지 복사하나요? Vercel이 프로젝트를 연결합니다

여러 앱에서 같은 기능을 켜고 끄려면, 기능 설정뿐 아니라 접근 키도 나눠 관리해야 했습니다. Vercel이 11월 2일 소개한 Project Connections는 같은 팀의 프로젝트끼리 SDK 키를 복사하지 않고 플래그를 읽도록 연결하는 기능입니다. 편해진 것은 인증 관리입니다. 어떤 설정을 어디까지 공유할지는 여전히 따져야 합니다. 공식 발표

같은 출시 스위치를 여러 앱이 읽습니다

기능 플래그는 코드를 지우지 않고도 기능의 노출 여부나 동작을 바꾸는 설정입니다. 예를 들어 쇼핑몰 화면을 여러 앱으로 나눠 운영한다면, 새 결제 기능을 보여줄 기준을 한 프로젝트에 두고 다른 앱들이 읽는 구조를 생각할 수 있습니다.

기존에는 이 연결을 위해 서버 SDK 키를 환경변수에 복사해야 했습니다. Project Connections에서는 설정을 보유한 소스 프로젝트와 읽어 쓰는 소비 프로젝트를 연결하고, 소비 프로젝트의 배포 신원으로 인증합니다. 키를 여러 곳에 배포하고 교체하는 부담을 줄이는 방식입니다. 공식 발표

읽기 전용이라고, 특정 설정만 보이는 것은 아닙니다

Vercel Project Connections 공식 발표 · 2026년 11월 2일

연결은 읽기·평가 권한을 주며, 소스의 플래그를 수정하는 권한은 주지 않습니다. 그러나 공유 범위는 소스 프로젝트의 모든 플래그와 환경입니다. 개별 플래그나 환경만 골라 연결하는 방식은 지원하지 않습니다. 타기팅 규칙에 담긴 데이터도 읽기 범위에 포함됩니다.

따라서 연결할 때는 “이 앱이 이 기능을 쓰는가”뿐 아니라 “이 프로젝트의 설정 전체를 읽어도 되는가”를 함께 확인해야 합니다. 같은 팀이라는 이유만으로 모든 프로젝트를 연결할 필요는 없습니다. 연결 범위 문서

운영·미리보기 환경을 먼저 맞춰 보세요

읽을 환경은 소비 프로젝트의 환경에 따라 정해집니다. Production은 Production, Preview는 Preview, Development는 Development 설정을 읽습니다. Custom environment는 Preview에 대응합니다.

도입 전에는 소스·소비 프로젝트를 적고, 각 배포 환경에서 기대하는 값을 정한 뒤 작은 플래그 하나로 확인하는 편이 좋습니다. 연결을 끊으면 재배포 없이 접근 권한이 회수됩니다. 평가할 수 없을 때 사용할 기본값도 함께 점검해야 합니다. 환경 및 연결 해제 안내

연결 편의성과 사용 비용은 별개입니다

Project Connections는 모든 요금제에서 제공됩니다. 최소 버전은 Vercel 어댑터 1.6.0, 코어 라이브러리를 직접 쓰면 1.11.0입니다. CLI로 연결을 관리하려면 Vercel CLI 63.0.0 이상이 필요합니다. 공식 발표

여기서 모든 요금제 제공을 무제한 무료 이용으로 읽으면 안 됩니다. 플래그 읽기와 평가는 소스 프로젝트의 사용량으로 집계됩니다. 캐시된 설정을 읽는 요청도 집계되며, 여러 소스 프로젝트를 읽으면 각각 계산됩니다. 연결을 늘리기 전에는 설정을 어디에 모을지와 그 프로젝트의 사용량을 함께 보세요. 사용량·요금 기준

핵심은 키 관리가 줄었다는 이유로 접근 범위 확인까지 줄이지 않는 것입니다. 여러 앱이 정말 같은 출시 기준을 공유해야 한다면 연결을 검토하고, 서로 다른 권한 경계를 유지해야 한다면 프로젝트 구성부터 다시 살펴볼 만합니다.