Blog

Vercel에서 MCP 서버 실행 방법

Young-jae

Young-jae

13 November 2025

Vercel에서 MCP 서버 실행 방법

Apidog 엔터프라이즈

온프레미스 배포

SSO & RBAC

SOC 2 준수

Apidog Enterprise 살펴보기

빠르게 발전하는 소프트웨어 개발 환경에서, 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 서버는 API 개발의 게임 체인저로 떠오르고 있습니다. 이러한 전문화된 서버는 AI 어시스턴트와 구조화된 데이터 소스를 연결하여 복잡한 API 사양과 자연어로 상호작용할 수 있게 해줍니다.

MCP 서버는 AI 도구의 지식 제공자로 기능하여 API 사양에 직접 접근하고 이해하며 활용할 수 있게 합니다. 이 기능은 개발자가 API와 작업하는 방식을 변화시키며:

Vercel에 배포할 경우, MCP 서버는 글로벌 가용성, 자동 스케일링 및 간소화된 배포 프로세스의 추가 장점을 얻습니다. 이러한 클라우드 기반 접근은 AI 도구가 어디에서나 API 사양에 접근할 수 있도록 하여 진정으로 현대적인 개발 환경을 만듭니다.

💡
Vercel에서 MCP 서버를 배포하는 것은 훌륭한 클라우드 기능을 제공하지만, Apidog MCP Server와 함께 사용할 경우 완전한 개발 생태계를 만듭니다. Apidog MCP Server는 AI 어시스턴트가 API 사양에 직접 접근할 수 있도록 하여, 생성된 코드가 API 디자인과 완벽하게 일치하도록 하며, Vercel이 클라우드 배포를 처리합니다. 이 강력한 조합은 API 디자인과 구현 간의 간격을 없애고 개발 시간과 오류를 극적으로 줄여줍니다.
버튼

향상된 API 개발을 위한 Vercel 기반 MCP 서버 설정

Vercel에 MCP 서버를 배포하기 위해서는 최적의 성능과 API 개발 워크플로우와의 통합을 보장하기 위한 신중한 구성이 필요합니다. 이 섹션에서는 서버 설정에 대한 포괄적인 가이드를 제공합니다.

Vercel MCP 배포를 위한 필수 요건

배포 프로세스를 시작하기 전에 다음을 준비하세요:

단계별 Vercel MCP 서버 구성

프로젝트 구조 초기화

새로운 프로젝트 디렉토리를 만들고 초기화하는 것부터 시작하세요:

mkdir vercel-mcp-server
cd vercel-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk @vercel/redis express

서버 구현 생성

귀하의 MCP 서버 구현을 포함한 api/server.ts 파일을 만듭니다:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
import { z } from "zod";

// MCP 서버 인스턴스 생성
const server = new McpServer({
 name: "API-개발-서버",
 version: "1.0.0"
});

// API 사양 리소스 추가
server.resource(
 "api-spec",
 "api-spec://main",
 async (uri) => ({
   contents: [{
     uri: uri.href,
     text: "여기에 API 사양 내용 입력"
   }]
 })
);

// 엔드포인트 생성 도구 추가
server.tool(
 "generate-endpoint",
 { 
   path: z.string(),
   method: z.enum(["GET", "POST", "PUT", "DELETE"]),
   description: z.string()
 },
 async ({ path, method, description }) => ({
   content: [{
     type: "text",
     text: `${method} 엔드포인트 ${path}에 대한 설명: ${description}로 생성됨`
   }]
 })
);

export default server;

Vercel 설정 구성

프로젝트 루트에 vercel.json 파일을 만듭니다:

{
 "version": 2,
 "builds": [
   {
     "src": "api/server.ts",
     "use": "@vercel/node",
     "config": { 
       "maxDuration": 800,
       "memory": 3008
     }
   }
 ],
 "routes": [
   { "src": "/api/(.*)", "dest": "/api/server.ts" }
 ]
}

Redis 통합 설정

Vercel 대시보드를 통해 Redis 통합을 추가합니다:

Vercel에 배포

MCP 서버를 Vercel에 배포합니다:

vercel --prod

배포 후 서버 URL을 기록하세요 (예: https://your-mcp-server.vercel.app).

Vercel과 Apidog의 통합을 통한 포괄적인 API 개발

진정으로 강력한 API 개발 환경을 만들기 위해 Vercel에 배포된 MCP 서버와 Apidog MCP Server를 통합하는 것이 최선입니다. 이 조합은 AI 도구가 클라우드 기반 MCP 도구와 Apidog에서 관리되는 상세한 API 사양 모두에 접근할 수 있게 해줍니다.

Apidog MCP Server 설정

Apidog MCP Server 설치

npm install -g apidog-mcp-server

Apidog 프로젝트 정보 확보

Apidog에서 프로젝트 ID 복사
API 액세스 토큰 생성

결합된 MCP 설정 구성

IDE의 MCP 구성을 업데이트하여 두 서버를 포함합니다:

{
 "mcpServers": {
   "vercel-mcp": {
     "command": "curl",
     "args": [
       "https://your-mcp-server.vercel.app/api/server"
     ]
   },
   "apidog-mcp": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<your-project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<your-access-token>"
     }
   }
 }
}

이 구성은 AI 어시스턴트가 Vercel에 배포된 MCP 서버와 Apidog API 사양 모두에 접근할 수 있게 합니다.

Vercel과 Apidog 통합을 통한 AI 지원 API 개발 활용

Vercel에 배포된 MCP 서버와 Apidog MCP Server의 조합은 API 개발을 혁신하는 강력한 워크플로를 만듭니다. 두 MCP 서버가 구성되면, 개발자는:

AI 지원으로 API 기반 응용 프로그램 구축

설계 단계

"Apidog MCP를 사용하여 사용자 모델의 스키마를 보여주세요"

AI는 Apidog에서 직접 API 스키마를 가져와서 표시합니다.

구현 단계

"Vercel MCP를 사용하여 Apidog 사양에 기반한 사용자 엔드포인트의 컨트롤러를 생성하세요"

AI는 API 디자인과 완벽하게 일치하는 구현 코드를 생성할 수 있습니다.

테스트 단계

"Apidog 사양에 따라 사용자 API 엔드포인트에 대한 테스트 케이스를 생성하세요"

AI는 사양에 대해 구현을 검증하는 종합적인 테스트를 생성할 수 있습니다.

Vercel MCP 배포의 일반적인 문제 해결

MCP 서버를 Vercel에 배포할 때 다음과 같은 일반적인 문제를 겪을 수 있습니다:

Redis 연결 오류

함수 타임아웃 문제

Apidog와의 통합 문제

결론: Vercel과 Apidog MCP 통합을 통한 API 개발 혁신

Vercel에 배포된 MCP 서버와 Apidog MCP Server의 통합은 API 개발 방법론의 중요한 발전을 나타냅니다. AI 어시스턴트가 클라우드 기반 도구와 상세한 API 사양 모두에 접근할 수 있는 통합된 환경을 생성함으로써, 이 조합은 현대 API 개발의 지속적인 문제를 해결합니다.

이 통합된 접근법은 전체 개발 생애 주기에서 실질적인 이점을 제공합니다. 개발자는 문서와 구현 간 전환에 덜 시간을 소모하고, 더 많은 가치를 창출하는 데 더 많은 시간을 할애하게 됩니다. 코드 생성은 API 사양과 완벽한 정렬을 유지하여, 디자인과 구현 간의 이탈을 제거합니다.

API 기반 응용 프로그램을 구축하는 조직에 있어, 이 조합은 API의 구축 및 유지 관리 방식을 혁신합니다. Vercel의 클라우드 기반 특성은 귀하의 MCP 도구가 항상 사용 가능하도록 보장하며, Apidog는 귀하의 API 사양과의 중요한 연결을 유지합니다. 함께, 이들은 구성 요소의 합보다 더 뛰어난 개발 환경을 만듭니다.

Vercel에 배포된 MCP 서버와 Apidog MCP Server의 통합을 수용함으로써, 개발팀은 현대 API 개발 관행의 최전선에 자리잡으며, 더 나은 일관된 API를 짧은 시간 내에 제공할 준비가 되어 있습니다.

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드