Vercel

제공 도구 12

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• vercel__api_destructive파괴적승인 필요

  Vercel 삭제·권한·보안·결제 변경 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. ⚠️ 삭제·권한·결제 변경은 데이터와 접근·요금에 반영되고 자동으로 되돌릴 수 없다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.

• vercel__api_send발신승인 필요

  Vercel 배포·외부 발신 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. ⚠️ 배포나 발신은 즉시 외부에 반영되며 회수할 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(카드엔 본문이 없다). 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.

• vercel__promote_deployment발신승인 필요

  지정한 기존 배포로 프로덕션 트래픽을 옮긴다(재빌드 없음, = 롤백). ⚠️ 사용자가 보는 사이트가 곧 바뀐다 — 되돌리려면 직전 프로덕션 배포(vercel__get_project 결과의 production.id)로 다시 promote 하니, 바꾸기 전에 그 id 를 확인해 둔다. deployment 는 vercel__list_deployments 결과의 id. 전환은 비동기라 반영은 vercel__get_project 의 production 으로 확인한다. 결과: promoted · project · deployment · note.

• vercel__redeploy발신승인 필요

  기존 배포를 같은 소스로 다시 빌드해 새 배포를 만든다. ⚠️ 실행은 되돌릴 수 없다 — 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_write쓰기

  Vercel 설정 생성·수정 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.

• vercel__api_read읽기

  Vercel 리소스 조회 — vercel__operations 결과의 operation과 입력 계약으로 실행한다. 계약의 위험도와 다르면 거부한다. 결과: operation · status · data · truncated · next_page. 202는 접수이며 완료는 조회로 확인한다.

• vercel__get_build_logs읽기

  빌드 로그 조회 — 긴 로그는 꼬리(실패 지점)만 남긴다. 배포 실패 원인 진단에 쓴다

• vercel__get_deployment읽기

  배포 상세 — 상태·소요·커밋·도메인·오류 메시지. 재배포 진행 확인에 쓴다. 결과: id · project · url · state · target · created_at · ready_at · duration_ms · domains · inspector_url · error.

• vercel__get_project읽기

  프로젝트 상세 — 도메인·git 연결·빌드 설정·현재 프로덕션 배포. promote 전에 되돌아갈 배포 id 를 확인하고, 반영을 확인할 때도 쓴다. 결과: id · name · domains · git · production(id · url · state · created_at).

• vercel__list_deployments읽기

  배포 목록 — 상태·환경·브랜치로 좁힌다. 배포 실패 진단은 보통 여기서 시작해 vercel__get_build_logs 로 이어진다. 결과: 배포마다 id · project · url · state · target · branch · commit · created_at · error (최대 50건).

• vercel__list_projects읽기

  프로젝트 목록과 프로덕션 상태 — 다른 Vercel 도구에 쓸 프로젝트 이름을 여기서 얻는다(id 는 나오지 않는다). 결과: 프로젝트마다 name · framework · production_url · production_state · paused · updated_at.

• vercel__operations읽기

  Vercel 공식 작업 검색 — operation을 지정하면 입력 계약과 위험도·권한·제약을 조회한다. tag/risk로 좁히고 offset 또는 schema_offset으로 다음 부분을 읽는다. 결과: id · risk · status · parameters · next_offset · next_schema_offset.

연동 준비

1. Create a Vercel access token for the target account/team. 바로가기
2. 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.