Vercel
VercelDev & Deploy
Manage Vercel resources and environment variables, inspect runtime logs and cancel deployments
Available tools 12
Hard-to-undo tools, such as sending or destructive actions, require your approval before running.
- vercel__api_destructiveDestructiveApproval required
Vercel 삭제·권한·보안·결제 변경 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. ⚠️ 삭제·권한·결제 변경은 데이터와 접근·요금에 반영되고 자동으로 되돌릴 수 없다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.
- vercel__api_sendSendApproval required
Vercel 배포·외부 발신 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. ⚠️ 배포나 발신은 즉시 외부에 반영되며 회수할 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(카드엔 본문이 없다). 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.
- vercel__promote_deploymentSendApproval required
지정한 기존 배포로 프로덕션 트래픽을 옮긴다(재빌드 없음, = 롤백). ⚠️ 사용자가 보는 사이트가 곧 바뀐다 — 되돌리려면 직전 프로덕션 배포(vercel__get_project 결과의 production.id)로 다시 promote 하니, 바꾸기 전에 그 id 를 확인해 둔다. deployment 는 vercel__list_deployments 결과의 id. 전환은 비동기라 반영은 vercel__get_project 의 production 으로 확인한다. 결과: promoted · project · deployment · note.
- vercel__redeploySendApproval required
기존 배포를 같은 소스로 다시 빌드해 새 배포를 만든다. ⚠️ 실행은 되돌릴 수 없다 — target=production 이면 곧 프로덕션 배포다. 재빌드 없이 이전 배포로 되돌리려면 vercel__promote_deployment. project 는 프로젝트 이름(id 아님 — vercel__list_projects 결과의 name), deployment 는 vercel__list_deployments 결과의 id. 새 배포는 보통 QUEUED 로 시작하니 vercel__get_deployment 로 진행을 본다. 결과: redeployed · id · url · state · target · inspector_url.
- vercel__api_writeWrite
Vercel 설정 생성·수정 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.
- vercel__api_readRead
Vercel 리소스 조회 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.
- vercel__get_build_logsRead
빌드 로그 조회 — 긴 로그는 꼬리(실패 지점)만 남긴다. 배포 실패 원인 진단에 쓴다
- vercel__get_deploymentRead
배포 상세 — 상태·소요·커밋·도메인·오류 메시지. 재배포 진행 확인에 쓴다. 결과: id · project · url · state · target · created_at · ready_at · duration_ms · domains · inspector_url · error.
- vercel__get_projectRead
프로젝트 상세 — 도메인·git 연결·빌드 설정·현재 프로덕션 배포. promote 전에 되돌아갈 배포 id 를 확인하고, 반영을 확인할 때도 쓴다. 결과: id · name · domains · git · production(id · url · state · created_at).
- vercel__list_deploymentsRead
배포 목록 — 상태·환경·브랜치로 좁힌다. 배포 실패 진단은 보통 여기서 시작해 vercel__get_build_logs 로 이어진다. 결과: 배포마다 id · project · url · state · target · branch · commit · created_at · error (최대 50건).
- vercel__list_projectsRead
프로젝트 목록과 프로덕션 상태 — 다른 Vercel 도구에 쓸 프로젝트 이름을 여기서 얻는다(id 는 나오지 않는다). 결과: 프로젝트마다 name · framework · production_url · production_state · paused · updated_at.
- vercel__operationsRead
Vercel 공식 작업 검색 — operation을 지정하면 입력 계약과 위험도·권한·제약을 조회한다. tag/risk로 좁히고 offset 또는 schema_offset으로 다음 부분을 읽는다. 결과: id · risk · status · parameters · next_offset · next_schema_offset.
Before you connect
- Create a Vercel access token for the target account/team. Open
- Use a Vercel access token scoped to the target account/team. Expanded REST operations include environment management, runtime log snapshots and deployment cancellation. Deployment/send and destructive/security/billing operations require approval. A 403 can indicate team role, plan or API entitlement. Reissue the token at https://vercel.com/account/tokens and reconnect when necessary; updating this catalog does not grant permissions to existing tokens. OAuth re-consent does not apply to this api_key connector.