$ claude mcp add --transport http vercel https://mcp.vercel.com copy
Vercel가 직접 호스팅하는 공식 원격 MCP 서버.
왜 필요한가?
배포가 실패하면 Vercel 대시보드를 열어 빌드 로그를 뒤져야 했습니다. Vercel MCP를 연결하면 Claude Code에서 배포 상태와 로그를 바로 조회해 실패 원인을 찾고, 문서까지 검색할 수 있습니다.
무엇을 할 수 있나
Vercel 공식 문서가 안내하는 대표 작업입니다.
- 빌드 실패 분석 — “내 최근 프로덕션 배포가 왜 실패했어?” (빌드 로그 조회)
- 런타임 에러 디버깅 — “지난 1시간 내 프로젝트의 런타임 에러 로그 보여줘”
- 문서 검색 — “Vercel에서 커스텀 도메인을 어떻게 설정해?”
- 배포 조회 — “내 블로그 프로젝트의 모든 배포를 보여줘”
- 보호된 배포 공유 링크 — “auth로 보호된 myapp.vercel.app의 공유 링크를 만들어줘”
- 배포 실행 — “이 프로젝트를 Vercel에 배포해줘”
근거: vercel.com/docs/agent-resources/vercel-mcp/tools.
핵심 기능
- 문서 —
search_documentation - 프로젝트, 팀 —
list_projects,get_project,list_teams - 배포 —
list_deployments,get_deployment,get_deployment_build_logs,get_runtime_logs - 도메인 —
check_domain_availability_and_price,buy_domain - 접근, 배포 실행 —
get_access_to_vercel_url,deploy_to_vercel,use_vercel_cli
연결 방법
claude mcp add --transport http vercel https://mcp.vercel.com
연결 후 /mcp로 OAuth 인증을 완료합니다. 프로젝트 범위로 좁히려면 https://mcp.vercel.com/<팀>/<프로젝트> 형태의 URL을 사용할 수 있습니다.
알아두면 좋은 점
- 원격 호스팅 — OAuth 인증
- 문서 검색 같은 공개 도구는 인증 없이 사용 가능, 프로젝트, 계정 도구는 인증 필요
- 클라이언트 연결마다 사용자 동의를 요구하는 confused-deputy 보호 적용
- Claude.ai, Claude Desktop에서는 커스텀 커넥터로 추가(설정 → 커넥터)