Vercel MCP — Claude Code MCP 서버

Vercel 공식 원격 MCP 서버. 프로젝트/배포 관리, 배포 로그 분석, Vercel 문서 검색을 OAuth로 안전하게 제공한다.

Vercel MCP는 Vercel이 공식 제공하는 원격(HTTP transport) MCP 서버로, Claude Code 같은 MCP 클라이언트가 Vercel 계정의 작업을 자연어로 다룰 수 있게 해줍니다. 핵심 기능은 세 가지로 요약됩니다. 첫째, 프로젝트와 배포 관리 — 어떤 프로젝트가 있는지, 최근 배포 상태가 무엇인지 조회하고 배포 흐름을 확인합니다. 둘째, 배포 로그 분석 — 실패하거나 이상이 있는 배포의 로그를 가져와 원인을 추적하고 디버깅을 돕습니다. 셋째, Vercel 공식 문서 검색 — 빌드 설정, 환경 변수, 도메인, 프레임워크 연동 등 문서를 검색해 정확한 근거와 함께 답을 얻습니다. 인증은 OAuth 기반이라 토큰을 코드나 설정 파일에 하드코딩하지 않고 브라우저 인증 흐름으로 안전하게 권한을 위임합니다.\n\n이 서버가 푸는 문제는 명확합니다. 평소 대시보드를 오가거나 CLI 명령을 일일이 외우지 않고도, AI 에이전트가 배포 상태·로그·문서를 한 흐름에서 조회해 "왜 빌드가 깨졌는지", "어떤 환경 변수를 설정해야 하는지"를 맥락과 함께 설명하게 만드는 것입니다. 특히 Next.js를 Vercel에 올려 운영하는 팀이라면, 코드 작업과 배포 점검을 같은 대화 안에서 이어가며 컨텍스트 전환 비용을 줄일 수 있습니다.\n\n쓰면 좋은 사람: Vercel에 프로젝트를 호스팅하는 Next.js/Node 개발자, 배포 실패 원인을 빠르게 좁히고 싶은 운영자, AI 에이전트로 배포 모니터링과 문서 확인을 자동화하려는 팀입니다. 실제 가능한 동작·권한 범위와 지원하는 도구 목록은 버전에 따라 달라질 수 있으니, 세부 사항은 Vercel 공식 문서(agent-resources/vercel-mcp)를 확인하는 것을 권장합니다.

언제 쓰나

Vercel에 호스팅하는 프로젝트의 배포 상태·로그를 AI 대화 안에서 바로 확인하고 싶을 때, 빌드/배포 실패 원인을 로그로 추적할 때, Vercel 문서를 근거로 환경 변수·도메인·프레임워크 설정을 점검할 때 적합합니다. 특히 Next.js를 Vercel에서 운영하며 코드 작업과 배포 모니터링을 한 흐름으로 묶고 싶은 개발자/운영자에게 유용합니다.

설치

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

원격(HTTP transport) 서버라 별도 패키지 설치 없이 클라이언트가 원격 엔드포인트에 연결합니다. 최초 연결 시 OAuth 브라우저 인증으로 Vercel 계정 권한을 위임해야 하므로 로그인 가능한 환경이 필요합니다. 접근 가능한 프로젝트는 인증한 계정/팀 권한 범위를 따릅니다. 도구 목록·지원 동작·엔드포인트는 버전에 따라 변경될 수 있으니 Vercel 공식 문서(agent-resources/vercel-mcp)를 확인하세요. 헤드리스 환경에서는 OAuth 콜백 처리가 까다로울 수 있습니다.

보안 주의

OAuth로 Vercel 계정 권한을 위임하므로, 인증한 계정/팀 범위의 프로젝트·배포·로그에 접근할 수 있습니다. 최소 권한 원칙으로 필요한 팀/프로젝트에만 권한을 부여하고, 운영 중요 계정과 분리하는 것이 안전합니다. 배포 로그에는 환경 변수 값·시크릿·내부 URL이 노출될 수 있으니 AI가 가져온 로그를 외부로 공유하거나 그대로 커밋하지 않도록 주의하세요. 로그·문서 등 외부 콘텐츠가 프롬프트로 유입되면 프롬프트 인젝션 위험이 있으므로, 자연어 지시를 무비판 실행하지 말고 파괴적/결제성 동작은 사람이 검토·승인하세요. 토큰은 설정 파일에 하드코딩하지 마세요(env 불필요: []).

자주 묻는 질문

별도 API 키나 토큰을 설정해야 하나요?

아니요. OAuth 기반 원격 서버라 env에 키를 넣지 않습니다(env: []). 최초 연결 시 브라우저 OAuth로 Vercel 계정 권한을 위임하며, 토큰을 설정 파일에 하드코딩하지 않습니다.

무엇을 할 수 있나요?

프로젝트·배포 조회 및 관리, 배포 로그 분석을 통한 실패 원인 추적, Vercel 공식 문서 검색을 지원합니다. 구체적인 도구·동작 범위는 버전에 따라 다를 수 있어 공식 문서 확인을 권장합니다.

접근할 수 있는 프로젝트 범위는 어떻게 정해지나요?

OAuth로 인증한 계정과 팀의 권한 범위를 따릅니다. 최소 권한 원칙으로 필요한 팀/프로젝트에만 권한을 부여하는 것이 안전합니다.