Vercel MCP 사용법 2026, 연결법·인증·내 MCP 서버 배포까지

마지막 확인 2026-10-26 · 도구 수·분류·결제 범위·요금을 공식 문서와 요금표로 다시 맞췄어요

Vercel MCP는 Vercel 이 직접 운영하는 공식 MCP 서버예요. 주소 https://mcp.vercel.com 를 AI 도구에 넣고 Vercel 계정으로 로그인하면, AI 가 배포·로그·도메인 같은 도구를 직접 써요. 2026-10-26 공식 문서 기준 도구는 248개(분류 27개)예요. 내가 만든 MCP 서버를 Vercel 에 올리는 법도 이 글에 같이 담았어요.

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

Vercel 정보는 2026-10-26 에 공식 문서·변경 이력에서 다시 확인했어요. 도구 문서의 갱신일 표시는 2026-09-15 그대로인데, 숫자는 10월 1일에 본 것과 달라졌어요(213개 → 248개). 도구 목록은 계정·팀·연결 방식에 따라 달라질 수 있어요.

Vercel MCP 는 무엇이에요?

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

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

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

"Vercel MCP" 를 검색하면 두 가지 뜻이 섞여 나와요

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

공식 도구 문서에는 "카탈로그 도구 217개와 작업·위젯 도구 31개"가 적혀 있어요. 분류는 27개이고, 분류마다 도구를 세어 보면 모두 248개예요. 비슷한 것끼리 묶으면 이래요.

10월 1일과 비교하면 가장 크게 바뀐 곳은 셋이에요. Vercel CI 분류(15개)가 새로 생겼어요. 도메인·DNS 는 19개에서 28개로 늘었어요. 청구·구매는 9개에서 5개로 줄었어요. AI 게이트웨이·인증 토큰 분류는 목록에서 빠졌어요.

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

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

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

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

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

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

2026-10-26 다시 봐도 안티그래비티는 공식 지원 목록에도, add-mcp 목록에도 없어요. Kiro 도 MCP 지원 목록에는 없어요. 다만 Kiro 는 Vercel 플러그인 지원 목록에는 들어 있어요. 쓰기 전에 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 설정을 대신 해 줘요. vercel mcp --project 로 하면 한 프로젝트 전용 주소(https://mcp.vercel.com/<팀>/<프로젝트>)로 붙어요. 이 명령은 내 컴퓨터 설정만 바꾸고, 따로 서버를 만들지 않아요.

연결이 안 될 때 흔한 실수 5가지

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

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

로그인 없이 보내면 어떤 답이 오는지 다시 해 봤어요. 2026-10-26 윈도우 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 이 나와요.

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

Vercel MCP 와 Vercel CLI, 뭘 써요?

둘 다 Vercel 을 다루지만 쓰는 자리가 달라요. MCP 는 AI 와 대화하면서, CLI 는 터미널 명령이나 자동 배포(CI)에서 써요. 공식 문서는 "MCP 와 CLI 는 인증이 따로"라고 적고 있어요. CLI 로 된다고 MCP 연결도 같은 권한이 있다는 뜻은 아니에요.

둘을 같이 쓰는 흐름이 흔해요. 평소 배포는 CLI·Git 으로 자동으로 하고, 배포가 깨졌을 때 AI 에게 MCP 로 로그를 읽혀 원인을 찾는 식이에요.

쓰기 전에 알아 둘 것

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

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

청구·구매 도구 문서를 2026-10-26 다시 보니 범위가 좁아졌어요. MCP 로 살 수 있는 건 도메인 등록뿐이에요. 문서에 "크레딧·구독·추가 기능은 MCP 로 사지 않는다"고 적혀 있어요.

도메인을 살 때는 세 단계를 거쳐요. 먼저 견적 도구가 값·세금·결제 수단·자동 갱신 조건을 보여 줘요. 사람이 그걸 보고 승인해요. 그다음 확인 단계에서 견적에 나온 값을 그대로 다시 보내야 주문이 들어가요.

견적은 5분이 지나면 무효예요. 확인할 때 실제 값이 견적과 다르면 주문이 거절돼요. 견적보다 비싸게 나가지 않게 막는 장치예요.

내 MCP 서버를 Vercel 에 올리려면?

여기서부터는 두 번째 뜻이에요. 내가 만든 도구를 MCP 서버로 묶어 Vercel 에 올리면, 주소 하나로 클로드·커서 같은 AI 가 그 도구를 써요. Vercel 은 공식 배포 문서에서 mcp-handler 패키지와 Next.js 를 쓰는 방법을 안내해요.

1. 준비 Next.js(App Router) 프로젝트와 Node.js 20 이상이 있어야 해요.
2. 설치 npm i mcp-handler @modelcontextprotocol/server@2 zod@4
3. 라우트 파일 app/api/mcp/route.ts 에 도구를 적어요(아래 예시).
4. 배포 Git 에 올리거나 vercel deploy --prod 로 배포해요.
5. 연결 claude mcp add --transport http my-tools https://내프로젝트.vercel.app/api/mcp

// app/api/mcp/route.ts — 인사말을 돌려주는 도구 하나
import { createMcpHandler } from 'mcp-handler';
import { z } from 'zod';

const handler = createMcpHandler((server) => {
  server.registerTool(
    'say_hello',
    {
      description: '이름을 받아 인사말을 돌려줘요',
      inputSchema: z.object({ name: z.string() }),
    },
    async ({ name }) => ({
      content: [{ type: 'text', text: `안녕하세요, ${name}님` }],
    }),
  );
});

export { handler as GET, handler as POST };

AI 도구는 /api/mcp 주소로 붙어요. 이 경로는 관례일 뿐이라 바꿔도 돼요. 2026-10-26 npm 최신판은 mcp-handler 2.3.0 이에요. 공식 문서의 설치 예시는 2.1.1 로 고정돼 있어요.

예전 글의 코드가 안 돌아가요

검색에 나오는 글 중에는 옛날 방식이 많아요. 아래 셋이 보이면 1.x 시절 코드예요.

1.x 를 계속 써야 하면 SDK 1.x 와 짝을 맞춰요. 공식 저장소 설명에는 1.x 를 쓸 때 SDK 1.26.0 이상을 권한다고 적혀 있어요. 그 아래 판에는 보안 문제가 있었기 때문이에요.

로그인을 붙이려면

남이 못 쓰게 하려면 withMcpAuth 로 감싸서 토큰을 검사해요. 다만 mcp-handler 는 토큰을 발급하지 않아요. 로그인 서버(인증 서버)는 따로 있어야 하고, 이 패키지는 받은 토큰을 확인하는 일만 해요.

실행 시간은 얼마나 허용돼요?

Vercel 함수는 요청 한 번에 쓸 수 있는 시간에 한도가 있어요. 공식 문서(Fluid compute 기본 켬)를 보면 이래요.

도구 하나가 몇 초 안에 끝나는 일이면 넉넉해요. 크롤링·큰 파일 변환처럼 오래 걸리는 도구는 작업을 따로 돌리고 결과만 돌려주게 짜요.

같은 MCP 서버, Vercel 말고 다른 곳에 올리면?

MCP 서버는 결국 HTTP 로 답하는 작은 웹 서버예요. 그래서 도커 이미지로 만들면 컨테이너를 돌려 주는 곳 어디든 올릴 수 있어요. 고르는 기준은 이래요.

퓨쳐인프라 앱은 도커 이미지 태그만 주면 주소와 HTTPS 가 붙어요. 1코어·1GB·트래픽 20GB 가 들어 있고, 정지하면 실행 요금이 0원이 돼요(자리·볼륨 요금은 남아요). 자세한 값은 앱 호스팅 페이지에 있어요.

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

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

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

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

표로 보기

무엇을	가운데 값
퓨쳐인프라 MCP tools/list	14.1ms
Vercel /cli/mcp tools/list	219ms
Vercel 본 주소 initialize(401)	202ms

두 서버는 연결 방식이 달라서 빠르기를 줄 세울 값은 아니에요. 태평양을 오가는 데만 0.2초쯤 걸리니, 차이는 대부분 거리 차이예요. 실제로 쓸 때는 AI 가 생각하는 시간이 이보다 훨씬 길어요.

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

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

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

자주 묻는 질문

Vercel MCP 는 무료예요?

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

Vercel MCP 는 아직 읽기 전용이에요?

아니에요. 처음(2025년 8월)에는 읽기 전용이었지만, 2026년 7월부터 코드 배포와 도메인 구매가 돼요. 영어권 옛 글에 "읽기 전용"이라고 남아 있는 경우가 있어요.

Vercel MCP 주소는 뭐예요?

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

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

2026-10-26 공식 문서는 OAuth 로그인만 안내해요. 키를 헤더로 넣는 방법은 문서에 없어요. 터미널에서 토큰으로 다루고 싶으면 Vercel CLI 의 VERCEL_TOKEN 을 써요.

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

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

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

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

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

MCP 로 살 수 있는 건 도메인뿐이에요. 견적을 받고 사람이 승인한 뒤, 같은 값으로 확인해야 진행돼요. 견적은 5분 뒤 무효예요. AI 도구의 사람 확인을 켜 두면 한 번 더 물어요.

내가 만든 MCP 서버도 Vercel 에 올릴 수 있어요?

네. Next.js 에 mcp-handler 를 깔고 app/api/mcp/route.ts 에 도구를 적어 배포하면 돼요. Hobby 요금제는 요청 하나에 최대 300초까지 돌아요.

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

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

응답 시간 원자료(2026-10-26)

측정 방법이에요. 우리 서버에는 API 키를 넣고 tools/list 를 보냈어요. Vercel 은 로그인 없이 되는 요청만 보냈고, 상태 코드와 머리말만 봤어요. 10월 1일에는 Vercel 공개 연결이 가끔 3~5초 걸렸는데, 이번 20번에는 1초를 넘은 적이 없었어요. 로그인한 뒤 본 주소의 응답 시간은 재지 않았어요.

공식 도구 분류 27개(2026-10-26)