Vercel CLI + MCP로 웹사이트 간단 배포하기 (2026 가이드)

 

웹사이트를 만들었다면, 다음은 배포죠. Vercel은 이걸 가장 간단하게 해주는 플랫폼인데, 방법이 두 가지예요 — CLI로 명령 한 줄, 그리고 MCP로 Claude Code 같은 AI에게 맡기기. 이 글에서 둘을 각각, 그리고 합쳐서 쓰는 법을 2026년 기준으로 정리합니다.

📌 이 글에서 얻어갈 것

✓ Vercel CLI로 미리보기·프로덕션 배포
✓ Vercel MCP로 AI에게 배포·로그 맡기기
✓ 둘을 합친 실전 워크플로
✓ 꼭 알아야 할 보안 주의점

방법 1 — Vercel CLI로 한 줄 배포

가장 직접적인 방법입니다. 설치하고 프로젝트 폴더에서 명령만 치면 돼요.

# 설치
npm i -g vercel

# 프로젝트 연결 (한 번만)
vercel link

# 환경변수 내려받기 (필요시)
vercel env pull .env.local

# 미리보기(preview) 배포
vercel

# 프로덕션 배포
vercel deploy --prod   # 또는 vercel --prod

💡 핵심 — --prod를 꼭 확인

--prod 없이 배포하면 미리보기 환경으로 나갑니다. 실서비스 배포는 반드시 --prod를 붙이세요. 처음 세팅 질문을 건너뛰려면 --yes, 배포 후 다음 단계 안내는 --guidance를 활용하면 됩니다.

방법 2 — Vercel MCP로 AI에게 맡기기

Vercel MCP는 Vercel 공식 원격 MCP 서버(https://mcp.vercel.com)입니다. Claude Code 같은 AI에 붙이면 자연어로 Vercel을 다룰 수 있어요:

📚 문서 검색 — Vercel 공식 문서에서 정확한 답을

🪵 배포 로그 분석 — 에러 로그를 읽고 원인·수정안 제시

🗂️ 프로젝트·배포 관리 — 배포·환경변수·도메인 상태 등

Claude Code에 붙이는 법은 명령 한 줄(인증은 /mcp):

# 프로젝트 폴더에서
claude mcp add --transport http vercel https://mcp.vercel.com
claude
/mcp        # OAuth로 Vercel 인증

# 모든 AI 클라이언트에 한 번에 설치하려면
npx add-mcp https://mcp.vercel.com

※ Claude Code 외에 Cursor·Codex CLI·VS Code(Copilot)·ChatGPT·Gemini CLI 등도 mcp.vercel.com에 연결됩니다.

둘을 합친 실전 워크플로

1

코딩은 Claude Code로
사이트를 만들고, "Vercel에 배포해줘"라고 자연어로 지시.

2

에러는 MCP로 디버그
배포가 실패하면 "배포 로그 보고 원인 고쳐줘" — MCP가 로그를 읽어 수정안을 줍니다.

3

정밀 제어는 CLI로
최종 프로덕션 배포·환경변수 같은 민감한 작업은 vercel --prod로 직접.

"코딩 → 배포 → 디버그까지 탭 하나, 명령 한 줄"
CLI의 정밀함 + MCP의 자연어, 둘을 섞는 게 최고

⚠️ 보안 주의

🔐 공식 엔드포인트만 — 반드시 https://mcp.vercel.com 인지 확인. MCP 연결은 내 Vercel 계정 권한을 AI에 줍니다.

✅ 사람 확인 켜두기 — 배포 등 변경 작업은 실행 전 직접 검토·승인하도록.

🛡️ 프롬프트 인젝션 경계 — 신뢰할 수 없는 도구/입력이 "로그를 외부로 보내라" 같은 악성 지시를 심을 수 있으니 주의.

자주 묻는 질문 (FAQ)

Q. CLI랑 MCP, 뭘 써야 하나요?

둘 다 쓰면 좋습니다. 빠르고 정밀한 배포는 CLI, 로그 분석·문서 검색·자연어 작업은 MCP. 역할이 다릅니다.

Q. 미리보기와 프로덕션 차이는?

vercel은 미리보기 URL(테스트용), vercel --prod는 실제 도메인으로 나가는 프로덕션 배포입니다.

Q. MCP는 안전한가요?

OAuth 인증과 연결마다 명시적 동의를 요구하고, '혼동된 대리자' 공격 방어 등 보안 장치가 있습니다. 그래도 사람 확인을 켜고 권한을 점검하는 게 안전해요.

마치며

Vercel은 "명령 한 줄로 배포"를 넘어, 이제 "AI에게 배포를 말로 맡기는" 단계까지 왔습니다. CLI로 정밀하게, MCP로 똑똑하게 — 둘을 섞으면 코딩부터 배포·디버그까지 한 흐름이 됩니다. 보안만 챙기면, 1인 개발자도 운영팀처럼 일할 수 있어요.

여러분은 어떻게 배포하고 계신가요? 나만의 배포 워크플로가 있다면 댓글로 공유해주세요 🙌

---

※ 본 글은 2026년 7월 기준 Vercel 공식 문서를 확인해 작성했습니다. 주요 출처: vercel.com/docs/cli/deploy, vercel.com/docs/agent-resources/vercel-mcp. CLI 옵션·MCP 도구·보안 정책은 업데이트될 수 있으니 공식 문서에서 현행 정보를 확인하세요.