초보자도 쉽게 사용 가능! Cursor+Apidog MCP Server로 하는 AI 기반 개발의 모든 것
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
개발 툴
대상자 대상자_정보 출력
- 초보 프로그래머 및 API 개발자
- 난이도: 중간 (AI 도구 활용 기초 지식 필요)
핵심 요약
- Cursor와 Apidog MCP Server의 결합으로 AI가 API 문서를 자동으로 분석 및 코드 생성 가능
- MCP(Model Context Protocol)를 통해 AI와 API 문서 간 실시간 연동 지원
- Node.js 18 이상, 최신 Cursor 버전, Apidog 프로젝트가 필수 사전 조건
섹션별 세부 요약
###1. MCP 프로토콜 기능
- AI 애플리케이션과 외부 데이터 소스를 연결하는 표준 인터페이스 제공
- API 명세서 기반의 자동 코드 생성, 검색, 업데이트 기능 지원
- MCP(Model Context Protocol): AI와 API 문서 간 데이터 흐름 관리
###2. Apidog MCP Server 사용 방법
- 3가지 주요 사용 시나리오
- Apidog 프로젝트 API 문서 활용 (개인 액세스 토큰 필요)
- 공개된 API 문서 활용 (토큰 불필요)
- OpenAPI/Swagger 문서 직접 활용 (프로젝트/토큰 불필요)
- Access Token 생성: Apidog 애플리케이션 → 계정 설정 → API 액세스 토큰 생성
- 프로젝트 ID 설정: 프로젝트 설정 → 기본 설정 → 프로젝트 ID 복사
###3. 설정 및 사용 예시
- 전역 설정 구성:
mcp.json
파일에"mcpServers"
설정 - 예:
"command": "npx", "args": ["apidog-mcp-server@latest", "--project-id=
"] - 프로젝트 설정 구성:
.cursor/mcp.json
파일 생성 후 동일 구성 사용 - AI와의 상호작용 예시:
"MCP를 통해 API 문서를 가져와서 제품 관련 API에 대한 TypeScript 인터페이스 생성해 주세요"
"API 문서가 업데이트되었습니다. MCP 캐시를 새로고침하고 Product 인터페이스를 업데이트해 주세요"
###4. 활용 사례 및 이점
- Spring Boot MVC 코드 자동 생성: AI에게 "사용자 관리 모듈 코드 생성" 요청 시 Controller/Service/Repository 자동 생성
- 테스트 코드 자동 생성:
"Jest 프레임워크 기반 제품 생성 인터페이스 테스트 코드 생성"
요청 시 정상/경계 조건 포함 - 다중 프로젝트 지원:
"mcpServers"
에 여러 서비스 구성 가능 (예: 마켓플레이스 API, CRM API)
###5. 팀 협업 및 보안 고려사항
- Access Token 공유 방지: 구성 파일에서
"APIDOG_ACCESS_TOKEN"
제거 후 개발자별 환경 변수 설정 - 코드 스타일 맞춤:
"우리 팀의 TypeScript 명명 규칙에 따라 코드 생성"
요청 시 적용 - 주석 추가 요청:
"JSDoc 주석 추가"
요청 시 메서드별 설명 포함
결론
- AI와 Apidog MCP Server 연동 시 API 개발 시간 50% 이상 단축 가능
- Node.js 18+ 환경에서 실행, Access Token/Project ID 설정 필수
- 팀 협업 시 환경 변수 분리 및 코드 스타일 맞춤 설정 권장