Microsoft Copilot Studio용 Vercel MCP 서버

제로 의존성 Model Context Protocol 서버로, Microsoft Copilot Studio와 함께 작동하도록 특별히 제작되었습니다(Streamable HTTP 전송을 요구하고 API 키 인증을 지원합니다).

존재 이유: Vercel의 공식 MCP 서버(https://mcp.vercel.com)는 동적 클라이언트 등록과 함께 OAuth를 사용하는데, Copilot Studio의 MCP 온보딩은 이를 완료할 수 없습니다. 이 서버는 그 격차를 메웁니다. Copilot Studio에 입력하는 API 키는 Vercel 액세스 토큰이며, 요청별로 Vercel REST API에 전달됩니다. 서버 자체는 상태 비저장이며 아무것도 저장하지 않습니다.

도구

배포

옵션 A — Vercel에 배포 (권장, 약 1분)

또는 CLI 사용:

vercel deploy --prod

MCP 엔드포인트는 다음과 같습니다: https://<your-deployment>.vercel.app/mcp

옵션 B — 자체 호스팅 (Node 18+ 호스트)

node server.js        # listens on PORT (default 3000), endpoint /mcp

npm install 불필요 — 의존성이 없습니다.

Copilot Studio에서 연결

1. **https://vercel.com/account/settings/tokens**에서 Vercel 액세스 토큰 생성 (에이전트가 관리할 팀/프로젝트로 범위 지정).

2. Copilot Studio에서 에이전트 열기 → 도구 → 도구 추가 → Model Context Protocol (MCP).

3. 다음 항목 입력:

   • 이름: Vercel

   • 설명: Vercel 프로젝트, 배포, 빌드 로그, 도메인 및 환경 변수 관리.

   • 서버 URL: https://<your-deployment>.vercel.app/mcp

   • 인증: API 키

     • 헤더 이름 / 위치: x-api-key (헤더)

     • 값: Vercel 액세스 토큰

4. 추가 클릭 → Copilot Studio가 MCP 핸드셰이크를 수행하고 13개 도구를 모두 나열합니다.

5. 연결 생성, 연결 관리자에서 활성화한 다음 미리 보기 창에서 테스트, 예:

   • "내 Vercel 프로젝트 목록"

   • "my-site의 최신 실패한 배포에 대한 빌드 로그 표시"

   • "미리 보기 전용으로 my-site에 환경 변수 API_URL=https://api.example.com 추가"

서버는 Authorization: Bearer <token> 또는 x-vercel-token 헤더를 통한 토큰도 허용하며, 단일 테넌트 자체 호스팅 배포의 경우 VERCEL_TOKEN 환경 변수로 대체됩니다(이 경우 Copilot Studio에서 인증 없음을 선택 — 서버 URL 자체가 보호되는 경우에만 수행).

아키텍처

Copilot Studio ──POST /mcp (JSON-RPC, Streamable HTTP)──▶ this server ──REST──▶ api.vercel.com
                     x-api-key: <vercel access token>          (stateless, no storage)

• 전송: MCP Streamable HTTP, 상태 비저장 모드 (프로토콜 버전 2024-11-05 → 2025-06-18). 세션 불필요, SSE 불필요 — 서버리스에 이상적.

• 인증: 패스스루. 서버는 토큰을 저장하지 않으며, 모든 요청은 호출자의 Vercel 토큰을 전달합니다.

• 제로 의존성: 순수 Node.js ≥18. 설치할 것 없음, 공급망 없음.

개발 및 테스트

node test/mcp.test.js

테스트 스위트는 실제 HTTP 서버를 부팅하고, api.vercel.com을 모킹하며, 전체 MCP 핸드셰이크(initialize → initialized → tools/list → tools/call)와 오류 경로(잘못된 토큰, 알 수 없는 도구/메서드, 잘못된 형식의 JSON, 배치)를 구동합니다.

보안 참고 사항

• 범위가 지정된 Vercel 토큰을 사용하고, 이상적으로는 최소 권한의 전용 팀에서 사용하세요.

• 비밀 환경 변수 값은 list_env_vars에서 반환되지 않습니다.

• HTTPS로만 배포하세요 (Vercel에서는 자동). Copilot Studio는 HTTPS를 요구합니다.

• 배포를 보호하는 경우 Vercel Deployment Protection 우회 헤더를 고려하세요.

라이선스

MIT