Vercel MCP 사용법 2026 — 도구 213개·연결법·인증·주의점 총정리

Vercel MCP는 Vercel 이 직접 운영하는 공식 MCP 서버예요. 주소 https://mcp.vercel.com 하나를 AI 도구에 넣고 Vercel 계정으로 로그인하면, AI 가 배포·로그·도메인 같은 도구 213개를 써요. 로그인 없이 직접 보내 보니 401 과 로그인 안내가 0.22초 만에 돌아왔어요.

글 서순명(솔리드그루 이사) · 운영 솔리드그루(사업자 875-44-00335 · 02-6933-6229 · support@futureinfra.ai) · 공식 문서 확인·실측·최종 수정 2026-10-01 서울 · Vercel 내용은 Vercel 공식 문서·변경 이력 기준 · 이용약관 · 개인정보처리방침

이 글의 Vercel 정보는 2026-10-01 에 공식 문서·변경 이력에서 직접 확인했어요. 도구 문서의 마지막 갱신일은 2026-09-15 예요. Vercel MCP 는 베타라 도구와 지원 목록이 자주 바뀌어요.

Vercel MCP 는 무엇이에요?

Vercel 은 웹사이트와 웹앱을 올려 주는 호스팅 서비스예요. Next.js 를 만든 회사이기도 해요. Vercel MCP 는 이 Vercel 계정을 AI 에게 이어 주는 공식 창구예요.

연결하면 AI 에게 말로 시킬 수 있어요. "어제 배포가 왜 실패했는지 로그 봐 줘", "이 저장소로 미리보기 배포 하나 만들어 줘" 같은 식이에요. AI 가 알맞은 도구를 골라 부르고, 결과를 읽어 설명해 줘요.

쉽게 말하면 Vercel 대시보드를 AI 가 대신 눌러 주는 리모컨이에요. 사람이 화면에서 하던 확인·설정을 AI 가 대화 중에 해요.

"Vercel 에 MCP 서버 올리기"와는 달라요

검색하면 두 가지 이야기가 섞여 나와요. 하나는 Vercel 이 운영하는 공식 서버(이 글)예요. 다른 하나는 내가 만든 MCP 서버를 Vercel 에 배포하는 방법이에요. 내 서버를 올리는 글은 "mcp server on vercel"처럼 검색하면 따로 나와요.

AI 에게 무엇을 시킬 수 있어요?

공식 도구 문서(2026-09-15 갱신)는 도구를 28개 분류로 나눠요. 분류마다 적힌 개수를 더하면 213개예요. 비슷한 것끼리 묶으면 이래요.

처음부터 이렇게 많지는 않았어요. 2025년 8월 공개 베타 때는 문서 검색과 프로젝트·로그 보기만 되는 읽기 전용이었어요. 바뀐 순서는 이래요.

분류별 전체 개수는 글 끝 부록에 표로 두었어요.

어떤 AI 도구에 붙일 수 있어요?

Vercel 은 직접 검토해 승인한 AI 도구만 연결을 허용해요. 2026-10-01 공식 문서에 연결법이 있는 곳은 14곳이에요.

모든 AI 도구에 한 번에 넣고 싶으면 npx -y add-mcp https://mcp.vercel.com -g 한 줄이면 돼요. 설치된 AI 도구를 찾아 각각 설정해 줘요. 문서에 따르면 Cline·fx·Grok Build·Kimi Code·Kilo Code·Zed 도 이 명령으로 설정돼요.

안티그래비티(Antigravity)도 돼요?

2026-10-01 공식 지원 목록에도, add-mcp 가 설정해 주는 목록에도 이름이 없어요. 쓰기 전에 Vercel 문서의 지원 목록이 바뀌었는지 먼저 확인하세요.

클로드 코드·커서·VS Code 에는 어떻게 붙여요?

Claude Code

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

첫 줄로 등록하고, 클로드 코드를 켠 뒤 /mcp 를 쳐요. 목록에서 vercel 을 고르면 브라우저가 열려요. 거기서 Vercel 에 로그인하고 허용하면 끝나요. 클로드 코드를 처음 깔면 클로드 코드 사용법 글부터 보세요.

Cursor

문서의 Add to Cursor 버튼을 누르면 자동으로 들어가요. 직접 넣으려면 .cursor/mcp.json 에 아래처럼 써요. 저장하면 Needs login 표시가 뜨고, 누르면 로그인 창이 열려요.

{
  "mcpServers": {
    "vercel": { "url": "https://mcp.vercel.com" }
  }
}

VS Code (Copilot)

1. 명령 팔레트(Ctrl+Shift+P, 맥은 Cmd+Shift+P)에서 MCP: Add Server 를 실행해요.
2. HTTP 를 고르고 주소 https://mcp.vercel.com, 이름 Vercel 을 넣어요.
3. MCP: List Servers → Vercel → Start Server 를 누르고, 인증 창에서 Allow 를 눌러요.

문서에는 VS Code 에서 외부 사이트 열기를 물으면 Cancel 을 누르라고 적혀 있어요. 그다음 "다른 방법으로 해 볼까요?"에 Yes 를 누르면 로그인 창이 열려요. 순서가 낯설어 막히기 쉬운 곳이에요.

Vercel CLI 로도 설정할 수 있어요

Vercel CLI 를 쓰고 있다면 vercel mcp 명령이 Claude Code·Cursor·VS Code 설정을 대신 해 줘요. Claude 앱은 붙이는 방법을 화면에 알려 줘요. 이 명령은 내 컴퓨터 설정만 바꾸고, 따로 서버를 만들지 않아요.

로그인(인증)은 어떻게 해요?

Vercel MCP 는 MCP 인가 명세를 따르는 OAuth 로만 로그인해요. AI 도구가 브라우저를 열면 내가 Vercel 에 로그인해 허락하는 방식이에요. 2026-10-01 공식 문서에는 API 키나 토큰을 직접 넣는 연결 방법이 없어요.

로그인 없이 보내면 어떤 답이 오는지 직접 해 봤어요. 윈도우 11 PC 에서 Node.js 24 로, 계정 없이 initialize 요청을 15번 보냈어요. 모두 401(인증 필요)이 왔고, 응답 머리말에 로그인 안내가 들어 있었어요.

HTTP/1.1 401 Unauthorized
Www-Authenticate: Bearer error="invalid_token",
  error_description="No authorization provided",
  resource_metadata="https://mcp.vercel.com/.well-known/oauth-protected-resource"
X-Vercel-Id: icn1::iad1::…

AI 도구는 이 resource_metadata 주소를 읽어요. 거기에 "로그인은 vercel.com 에서"라고 적혀 있어서, 알아서 로그인 창을 열어요. 사람이 주소나 키를 따로 챙길 일이 없는 이유예요.

예외가 하나 있어요. https://mcp.vercel.com/cli/mcp 연결은 로그인 없이 열렸어요. 도구 목록을 받아 보니 문서 검색과 CLI 안내, 딱 2개였어요. 내 프로젝트를 건드리는 도구는 모두 로그인해야 보여요.

연결했는데 프로젝트가 안 보이면

서버를 등록한 것만으로는 끝이 아니에요. 로그인할 때 AI 가 쓸 팀을 골라 허용해야 해요. 팀을 허용하지 않으면 프로젝트 목록이 비어 있거나 403 이 나와요. Vercel 커뮤니티에도 같은 질문이 여러 번 올라와 있어요.

AI 에게 "내 팀과 프로젝트 목록 보여 줘"라고 먼저 물어보세요. 팀이 빠져 있으면 로그인한 계정이 맞는지, 그 팀을 허용했는지 확인하면 돼요.

쓰기 전에 알아 둘 것

공식 문서의 보안 안내에 따르면, 연결한 AI 는 내 Vercel 계정 권한을 그대로 가져요. 내가 지울 수 있는 건 AI 도 지울 수 있다는 뜻이에요.

AI 가 마음대로 결제하면 어떡해요?

청구·구매 도구 문서를 보면 구매는 두 단계예요. 먼저 견적 도구가 값을 보여 주고, 확인 단계에서 그 견적을 그대로 다시 보내야 결제돼요. 견적은 5분이 지나면 무효예요. 같은 견적으로 두 번 보내도 한 번만 청구돼요.

다만 확인하고 나면 바로 청구되고 환불이 안 돼요. 결제하려면 팀에 결제 수단과 청구 권한도 있어야 해요. 도메인은 확인 때 견적 값과 실제 값이 다르면 주문이 거절돼요. 견적보다 비싸게 나가지 않게 막는 장치예요.

Vercel 밖의 서버·DB·도메인까지 맡기려면?

Vercel MCP 는 Vercel 안의 일을 다뤄요. 그런데 실제 서비스는 Vercel 밖에도 걸쳐 있는 경우가 많아요. 매일 도는 자동화 서버, 회원 정보를 담는 DB, 다른 곳에서 산 도메인 같은 것들이요. 이럴 때 고를 수 있는 길은 세 가지예요.

세 번째 방법을 직접 재 봤어요. 퓨쳐인프라 MCP 에 API 키로 도구 목록(tools/list)을 20번 달라고 했어요. 매번 도구 30개가 왔고, 가운데 값은 12.1ms였어요. 같은 날 Vercel 에도 로그인 없이 되는 요청을 보내 시간을 쟀어요.

Vercel 은 서울 근처 지점(icn1)에서 받아 미국 동부(iad1)에서 처리해요. 차이는 대부분 거리에서 나와요.

두 서버는 연결 방식이 달라서 빠르기를 줄 세울 값은 아니에요. Vercel 의 응답 머리말을 보면 서울 근처 지점(icn1)에서 받아 미국 동부(iad1)에서 처리해요. 태평양을 오가는 데만 0.2초쯤 걸리니, 차이는 대부분 거리 차이예요. 실제로 쓸 때는 AI 가 생각하는 시간이 이보다 훨씬 길어요.

퓨쳐인프라 MCP 는 Claude Code 에 아래 한 줄로 붙여요. 브라우저에서 로그인하거나, 콘솔에서 받은 API 키를 헤더로 넣어요. 앱은 월 5,500원(DB 를 붙이면 7,700원), 가장 작은 서버는 월 9,900원부터예요(부가세 포함, 쓴 만큼 분 단위). 다른 MCP 연결 방법은 MCP 연동 방법 글에 모아 두었어요.

claude mcp add --transport http futureinfra https://futureinfra.ai/v1/mcp
/mcp

어떤 플랫폼에서 시작할지 아직 고르는 중이라면 바이브코딩 플랫폼 비교 글도 같이 보세요.

자주 묻는 질문

Vercel MCP 는 무료예요?

공식 문서 첫머리에 모든 요금제에서 베타로 쓸 수 있다고 적혀 있어요. 연결 자체에 붙는 요금은 문서에서 찾지 못했어요. 배포·도메인 구매처럼 원래 돈이 드는 일은 Vercel 요금대로 청구돼요.

Vercel MCP 주소는 뭐예요?

https://mcp.vercel.com 이에요. 특정 프로젝트만 다루게 하려면 vercel mcp --project 로 https://mcp.vercel.com/<팀>/<프로젝트> 주소를 써요.

API 키나 토큰으로 연결할 수 있어요?

2026-10-01 공식 문서는 OAuth 로그인만 안내해요. 키를 헤더로 넣는 방법은 문서에 없어요. 로그인 없이 보내면 401 과 로그인 안내 주소가 돌아와요.

클로드 코드에 붙이는 명령은요?

claude mcp add --transport http vercel https://mcp.vercel.com 을 실행하고, 클로드 코드 안에서 /mcp 로 로그인해요.

연결했는데 프로젝트가 안 보여요.

로그인할 때 그 프로젝트가 속한 팀을 허용했는지 확인하세요. 팀 접근이 없으면 목록이 비거나 403 이 나와요.

AI 가 몰래 결제할 수 있나요?

구매는 견적을 받고, 같은 견적으로 확인해야 진행돼요. 견적은 5분 뒤 무효예요. AI 도구의 사람 확인을 켜 두면 결제 전에 한 번 더 물어요.

이 글의 숫자는 어디서 왔나요?

부록 — 실측 원자료와 도구 분류 전체

응답 시간 원자료

측정 방법이에요. 우리 서버에는 API 키를 넣고 tools/list 를 보냈어요. Vercel 은 로그인 없이 되는 요청만 보냈고, 상태 코드와 머리말만 봤어요. Vercel 공개 연결은 대부분 0.2초 안팎이었지만 가끔 3~5초가 걸린 때도 있었어요. 로그인한 뒤 본 주소의 응답 시간은 재지 않았어요.

공식 도구 분류 28개