MCP로 Vercel을 에이전트에 연결하기

Vercel의 공식 MCP 서버는 https://mcp.vercel.com에서 실행돼요. Claude Code에 연결하면 에디터를 벗어나거나 대시보드를 열지 않고도 터미널에서 직접 배포를 조회하고, 로그를 읽고, 프로젝트를 점검할 수 있어요.

이것은 Blokby 강좌가 통과하는 MCP 브리지의 세 번째 엔드포인트예요. Claude Code가 MCP 서버를 어떻게 사용하는지, Supabase가 어떻게 MCP 서버를 노출하는지 살펴본 뒤, 여기서는 Vercel 측 마지막 연결 고리를 연결해요.

서버가 노출하는 도구들

Vercel MCP는 도구를 두 가지 카테고리로 구분해요.

공개 도구 (인증 불필요):

• search_documentation - Vercel 공식 문서에서 검색

인증된 도구 (Vercel 계정 필요):

• list_teams, list_projects, get_project - 프로젝트 구조 탐색
• list_deployments, get_deployment - 배포 상태 및 메타데이터
• get_deployment_build_logs - 빌드 실패 진단을 위한 빌드 로그
• get_runtime_logs - 레벨(error, warning, info), 환경(production, preview), HTTP 코드, 시간 범위로 필터링 가능한 런타임 로그
• check_domain_availability_and_price, buy_domain - 도메인 관리
• deploy_to_vercel - 에이전트에서 배포 트리거

MCP 서버 추가하기

다음 명령어는 현재 프로젝트에 Vercel 서버를 Claude Code에 등록해요.

$claude mcp add --transport http vercel https://mcp.vercel.com

기본 scope는 local(현재 프로젝트만)이에요. 모든 프로젝트에서 이 서버를 사용하려면 위 명령어에 --scope user를 추가하세요.

서버가 목록에 제대로 등록되었는지 확인할 수 있어요.

$claude mcp list

서버 인증하기

Vercel MCP 서버는 OAuth를 사용해요. 첫 번째 연결 시 브라우저에서 권한 부여 흐름이 열려요.

프로젝트에서 Claude Code를 실행하세요.

$claude

그런 다음 채팅 인터페이스에서 MCP 서버 상태를 표시해요.

$/mcp

Claude Code가 Vercel 계정 접근을 승인할 수 있도록 브라우저를 열어요. 승인 후 서버가 "connected" 상태가 되고 사용 가능한 도구가 목록에 나타나요.

첫 번째 테스트: 배포 목록 조회하기

연결되면 Claude Code에 자연어로 Vercel과 상호작용을 요청할 수 있어요. Claude Code에서 다음 프롬프트를 사용해 보세요.

내 최근 Vercel 배포 5개를 나열하고 어떤 것이 프로덕션 중인지 알려줘.

Claude가 list_teams와 list_projects를 호출해 프로젝트를 식별하고, list_deployments로 기록을 가져와요. 로그도 직접 조회할 수 있어요.

지난 한 시간 동안 blokby-website 프로젝트의 런타임 오류 로그를 보여줘.

실패한 배포 진단하기

MCP를 연결한 후 가장 일반적인 사용 사례는 대시보드를 열지 않고 빌드가 왜 실패했는지 파악하는 거예요.

마지막 배포가 실패했어. 빌드 로그를 가져와서 무슨 일이 일어났는지 설명해줘.

Claude가 list_deployments를 호출해 실패한 배포를 식별하고, get_deployment_build_logs로 로그를 읽어요. 그런 다음 오류를 설명하고 같은 대화에서 수정 방법을 제안해요.