Vercel MCP 서버 🚀

🔥 Cursor의 Composer와 Codeium의 Cascade를 통해 Vercel 배포에 대한 완벽한 관리 제어 기능을 제공하는 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 도구는 배포, 도메인, 환경 변수 등에 대한 포괄적인 기능을 제공하여 원활한 프로젝트 관리를 지원합니다.

📚 목차

Related MCP server: Context Manager MCP Server

🔧 필수 조건

노드.js >= 16.x
npm >= 8.x
다음이 포함된 Vercel 계정:
- 액세스 토큰
- 팀 ID(선택 사항)
- 프로젝트 ID(선택 사항)
커서 IDE 또는 Codeium의 Cascade(유료 사용자용)

🚀 빠른 시작

📥 설치

지엑스피1

⚙️ 구성

종속성을 설치하고 프로젝트를 빌드합니다.
npm install npm run build
Vercel 액세스 토큰을 설정하세요:
- https://vercel.com/account/tokens 로 이동하여 액세스 토큰을 생성하세요.
- 다음 두 파일의 토큰을 업데이트하세요.
  src/config/constants.ts 에서:
  export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
  src/index.ts 에서:
  export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
커서의 MCP 설정에서 다음 명령을 사용하여 서버를 추가합니다.
macOS의 경우:
# Default installation /usr/local/bin/node /path/to/vercel-mcp/dist/index.js # Homebrew installation /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
Windows의 경우:
# Default installation C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # NVM for Windows C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # Scoop installation C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
Linux의 경우:
# Default installation /usr/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
/path/to/vercel-mcp 또는 C:\path\to\vercel-mcp 실제 설치 경로로 바꾸세요.
Node.js 경로를 찾으려면:
# macOS/Linux which node # Windows where node

참고: Vercel 액세스 토큰을 안전하게 보관하고 버전 제어에 커밋하지 마세요.

🎯 특징

🎯 사용 가능한 도구

팀 관리

팀: create_team , delete_team , get_team , list_teams , update_team
팀 구성원: list_team_members , invite_team_member , remove_team_member , update_team_member

프로젝트 관리

프로젝트: list_projects , create_project , delete_project , update_project , pause_project
프로젝트 멤버: add_project_member , list_project_members , remove_project_member
프로젝트 이전: request_project_transfer , accept_project_transfer

배포 관리

배포: create_deployment , cancel_deployment , get_deployment , delete_deployment , list_deployment
배포 이벤트: get_deployment_events , update_deployment_integration
배포 파일: list_deployment_files , upload_deployment_files , get_deployment_file
프로모션: promote_deployment , get_promotion_aliases

도메인 및 DNS 관리

도메인: add_domain , remove_domain , get_domain , list_domains , get_project_domain
도메인 작업: domain_check , domain_price , domain_config , domain_registry , domain_get , domain_list , domain_buy , domain_register , domain_remove , domain_update
DNS: create_dns_record , delete_dns_record , list_dns_records , update_dns_record
인증서: get_cert , issue_cert , remove_cert , upload_cert

환경 및 구성

환경 변수: add_env , update_env , delete_env , get_env , list_env
Edge 구성: create_edge_config , update_edge_config , delete_edge_config , get_edge_config , list_edge_configs
Edge 구성 항목: list_edge_config_items , get_edge_config_item , update_edge_config_items
Edge Config 스키마: get_edge_config_schema , update_edge_config_schema , delete_edge_config_schema
Edge Config 토큰: create_edge_config_token , get_edge_config_token , list_edge_config_tokens , delete_edge_config_tokens
Edge Config 백업: list_edge_config_backups , get_edge_config_backup

출입 통제 및 보안

액세스 그룹: create_access_group , delete_access_group , update_access_group , get_access_group , list_access_groups
그룹 프로젝트 액세스: create_access_group_project , delete_access_group_project , get_access_group_project , list_access_group_projects
액세스 그룹 구성원: list_access_group_members
인증: create_auth_token , delete_auth_token , get_auth_token , list_auth_tokens , sso_token_exchange
방화벽: create_firewall_bypass , delete_firewall_bypass , get_firewall_bypass , get_attack_status , update_attack_mode , get_firewall_config , update_firewall_config , put_firewall_config

모니터링 및 로깅

로그 드레인: logdrain_create , logdrain_createIntegration , logdrain_delete , logdrain_deleteIntegration , logdrain_get , logdrain_list , logdrain_listIntegration
웹훅: create_webhook , delete_webhook , list_webhooks , get_webhook
분석: send_web_vitals

사용자 관리

사용자: delete_user , get_user , list_user_events

마켓플레이스 및 통합

마켓플레이스: create_marketplace_event , get_marketplace_account , get_marketplace_invoice , get_marketplace_member , import_marketplace_resource , submit_marketplace_billing , submit_marketplace_invoice , update_marketplace_secrets , marketplace_sso_token_exchange , submit_marketplace_balance , marketplace_invoice_action
통합: int_delete , int_list , int_gitns , int_searchRepo , int_get , int_updateAction

환경과 비밀

환경: create_environment , delete_environment , get_environment , list_environments , update_environment
비밀: create_secret , update_secret_name , delete_secret , get_secret , list_secrets

아티팩트 및 별칭

아티팩트: check_artifact , download_artifact , get_artifact_status , query_artifacts , record_artifact_events , upload_artifact
별칭: assign_alias , delete_alias , get_alias , list_aliases , list_deployment_aliases

💡 사용법

MCP 서버는 구성이 완료되면 Cursor's Composer를 통해 모든 Vercel 관리 도구를 제공합니다. Vercel 프로젝트에서 무엇을 할지 간단히 설명하면 AI가 적절한 명령을 실행합니다.

예:

📋 "내 모든 프로젝트 나열"
🚀 "새로운 Next.js 프로젝트를 만드세요"
🌐 "내 프로젝트에 사용자 지정 도메인 추가"
🔑 "환경 변수 설정"

🔒 보안 참고 사항

🔐 Vercel 액세스 토큰을 안전하게 보관하세요
⚠️ 민감한 자격 증명을 버전 제어에 커밋하지 마십시오.
👮 적절한 액세스 제어 및 권한을 사용하세요
🛡️ Vercel의 보안 모범 사례를 따르세요

🛠️ 문제 해결

일반적인 문제

Node.js 경로 문제
- 올바른 Node.js 경로를 사용하고 있는지 확인하세요.
- Mac/Linux에서: 올바른 경로를 찾는 데 which node 사용하세요
- Windows에서: where node 사용하여 올바른 경로를 찾으세요.
액세스 토큰 문제
- Vercel 액세스 토큰이 유효한지 확인하세요
- 토큰에 필요한 권한이 있는지 확인하세요
- 토큰이 만료되지 않았는지 확인하세요
MCP가 도구를 감지하지 못함
- 커서의 MCP 설정에서 새로 고침 버튼을 클릭하세요.
- 서버가 실행 중인지 확인하세요(오류 메시지 없음)
- Vercel 자격 증명이 유효한지 확인하세요

디버그 모드

자세한 로그를 보려면 명령 앞에 DEBUG=true 추가하세요.

# macOS/Linux DEBUG=true /usr/local/bin/node /path/to/vercel-mcp/dist/index.js # Windows set DEBUG=true && "C:\Program Files\nodejs\node.exe" "C:\path\to\vercel-mcp\dist\index.js"

여전히 문제가 발생하는 경우 다음 주소로 문제를 제기해 주세요.

귀하의 운영 체제
Node.js 버전( node --version )
전체 오류 메시지
재현 단계

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

Vercel MCP Server