소프트웨어 개발 환경은 빠르게 진화하고 있으며, 인공지능(AI)이 점점 더 핵심적인 역할을 하고 있습니다. AI가 특히 복잡한 코딩 작업에서 진정으로 효과적이려면 관련 데이터와 컨텍스트에 접근할 수 있어야 합니다. 여기서 모델 컨텍스트 프로토콜(MCP) 서버가 등장하여 AI 모델과 다양한 데이터 소스를 연결하는 다리 역할을 합니다. AI가 특정 정보에 접근할 수 있도록 함으로써 MCP 서버는 AI의 역량을 크게 향상시키고, 더 정확하고 컨텍스트를 인지하는 지원을 제공합니다.
이 글에서는 그러한 MCP 서버 두 가지를 자세히 살펴보겠습니다. 먼저, AI 코딩 노력을 보강할 수 있는 일반 파일 접근 도구인 Google Drive MCP 서버를 살펴보겠습니다. 그런 다음, API 사양을 AI에 직접 연결하여 API 개발을 혁신하고 강력한 API 지원 개발의 길을 열도록 설계된 Apidog의 전문 솔루션인 Apidog MCP 서버를 소개하겠습니다.
버튼
Google Drive MCP 서버 이해 및 활용을 통한 AI 코딩 향상
Google Drive MCP 서버는 Google Drive 파일을 AI 기반 IDE와 통합하려는 개발자에게 유용한 도구입니다. 주요 기능은 AI 에이전트가 Google Drive에 저장된 파일을 나열하고 읽고 검색할 수 있도록 하여 다양한 AI 코딩 작업에 풍부한 컨텍스트 소스를 제공하는 것입니다.
Google Drive MCP 서버의 주요 구성 요소 및 기능
Google Drive MCP 서버는 간단하지만 효과적인 구성 요소를 제공합니다.
도구:
search
: 제공되는 주요 도구입니다. 검색어(문자열)를 입력하면 서버는 Google Drive 내에서 일치하는 파일의 파일 이름과 MIME 유형을 반환합니다. 이는 AI가 필요할 수 있는 특정 문서, 코드 스니펫 또는 데이터 파일을 찾는 데 매우 유용합니다.
리소스:
- 파일 (
gdrive:///<file_id>
): 서버는 Google Drive에 저장된 모든 파일 유형에 대한 접근 권한을 부여합니다.
중요한 장점은 Google Workspace 파일 처리에 있습니다.
- Google Docs는 자동으로 Markdown으로 내보내집니다.
- Google Sheets는 CSV로 변환됩니다.
- Google Presentations는 일반 텍스트가 됩니다.
- Google Drawings는 PNG 이미지로 내보내집니다.
- 다른 파일 유형은 기본 형식으로 제공됩니다.
다양한 파일 유형에 접근하고 처리하는 이러한 기능은 Google Drive MCP 서버를 AI 지원 개발을 위한 다재다능한 자산으로 만들며, AI가 프로젝트 계획, 문서, 데이터셋 등에서 정보를 가져올 수 있도록 합니다.
단계별: Google Drive MCP 서버 시작하기
Google Drive MCP 서버 설정은 주로 Google Cloud Platform 구성에 중점을 둔 몇 가지 예비 단계를 포함합니다.
1. Google Cloud 프로젝트 설정:
- Google Cloud Console을 통해 새 Google Cloud 프로젝트를 만듭니다.
- 프로젝트에 대해 Google Drive API를 사용 설정합니다.
- OAuth 동의 화면을 구성합니다. 테스트용으로는 "내부" 화면으로 충분합니다.
- 중요하게, OAuth 범위:
https://www.googleapis.com/auth/drive.readonly
를 추가합니다. 이렇게 하면 서버가 Drive에 대한 읽기 전용 접근 권한만 갖게 됩니다. - 애플리케이션 유형 "데스크톱 앱"에 대해 OAuth 클라이언트 ID를 만듭니다.
- 클라이언트의 OAuth 키가 포함된 JSON 파일을 다운로드합니다. 이 파일의 이름을
gcp-oauth.keys.json
으로 변경합니다. 참조 자료에서는 리포지토리 구조 내에서 작업하는 경우servers/gcp-oauth.keys.json
에 배치할 것을 제안합니다.
2. 서버 빌드 (해당하는 경우):
- 소스에서 실행하는 경우
npm run build
또는npm run watch
를 사용하여 빌드해야 할 수 있습니다.
3. 인증 프로세스:
- 자격 증명을 인증하고 저장하려면
auth
인자와 함께 서버를 실행합니다 (예: 일반적인 위치에서 빌드된 버전을 실행하는 경우node ./dist auth
). - 이 작업은 시스템 브라우저에서 인증 흐름을 엽니다.
- Google 계정에 로그인하고 필요한 권한을 부여하여 인증 프로세스를 완료합니다.
- 인증에 성공하면 자격 증명이 로컬에 저장됩니다 (예:
servers/.gdrive-server-credentials.json
).
Google Drive MCP 서버를 IDE와 통합하기
설정 및 인증이 완료되면 Google Drive MCP 서버를 AI 기반 IDE에 통합할 수 있습니다. 다음은 일반적이고 간단한 방법인 NPX를 사용한 VS Code의 구성 예시입니다.
{
"mcp": {
"servers": {
"gdrive": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gdrive"
],
"env": {
"GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
}
}
}
}
}
"/path/to/.gdrive-server-credentials.json"
를 저장된 자격 증명 파일의 실제 경로로 바꾸는 것을 잊지 마세요.
이 통합을 통해 AI 비서는 Google Drive MCP 서버를 활용하여 프로젝트 문서에 접근하고, 저장한 코드 스니펫을 검색하거나, 스프레드시트의 데이터를 분석할 수 있어 AI 코딩 워크플로우에서 유용성을 크게 향상시킵니다.
API 개발 혁신: Apidog MCP 서버 소개
Google Drive MCP 서버가 파일 기반 AI 지원에 광범위한 유용성을 제공하는 반면, API 개발과 같은 전문 분야는 보다 맞춤화된 접근 방식이 필요합니다. 여기서 Apidog MCP 서버가 빛을 발하며, 상세한 API 사양을 AI에 직접 연결하여 API 지원 개발 프로세스를 강화하는 강력한 솔루션을 제공합니다.
버튼
Apidog MCP 서버란 무엇인가요?
Apidog MCP 서버는 올인원 API 개발 플랫폼인 Apidog의 강력한 도구입니다. 이를 통해 API 사양을 Cursor 또는 적절한 플러그인이 설치된 VS Code와 같은 AI 기반 IDE의 직접적인 데이터 소스로 사용할 수 있습니다. 이는 AI 비서가 API 디자인의 복잡성(엔드포인트, 스키마, 매개변수, 응답 등)에 접근하고 이해할 수 있음을 의미하며, 다음과 같은 이점을 가져옵니다.
- 개발 가속화: AI는 상용구 코드, DTO 및 서비스 구현을 훨씬 빠르게 생성할 수 있습니다.
- 효율적인 워크플로우: 사양 변경에 따른 DTO 업데이트와 같은 지루한 작업을 자동화할 수 있습니다.
- 향상된 코드 품질: AI 생성 코드는 실제 API 사양을 기반으로 하므로 정렬을 보장하고 오류를 줄입니다.
- API를 위한 간소화된 AI 코딩: AI가 정확한 컨텍스트를 갖게 됨에 따라 프롬프트가 더욱 효과적이 됩니다.
Apidog MCP 서버가 AI 지원 API 개발을 향상시키는 방법
Apidog MCP 서버가 구성되면 선택한 소스(예: Apidog 프로젝트, OpenAPI 파일)의 모든 API 사양 데이터를 로컬 머신에서 자동으로 읽고 캐시합니다. 그러면 AI가 이 데이터를 원활하게 검색하고 활용할 수 있습니다.
다음과 같은 프롬프트로 AI에게 지시하는 것을 상상해 보세요.
- "MCP를 사용하여 API 사양을 가져오고 'Product' 스키마 및 모든 관련 스키마에 대한 Java 레코드를 생성해 줘."
- "API 사양에 따라 'Product' DTO에 새로운 'price' 및 'stock' 필드를 추가해 줘."
- "API 사양의 설명을 기반으로 'Product' 클래스의 각 필드에 Javadoc 주석을 추가해 줘."
- "API 사양에 따라 엔드포인트 '/users'와 관련된 모든 Spring Boot MVC 코드(컨트롤러, 서비스, 리포지토리)를 생성해 줘."
Apidog MCP는 AI가 추측하는 것이 아니라 API 디자인의 단일 진실 소스를 기반으로 작업하기 때문에 이러한 상호 작용을 매우 효과적으로 만듭니다.
Apidog MCP 서버 설정: 단계별 가이드
Apidog MCP 서버 시작은 간단합니다. 다음은 Apidog 프로젝트를 데이터 소스로 사용하는 것에 초점을 맞춘 가이드로, Apidog 사용자에게 일반적인 시나리오입니다.
전제 조건:
- Node.js: 버전 18 이상 (최신 LTS 버전 권장).
- MCP를 지원하는 IDE: Cursor 또는 Cline 플러그인이 설치된 VS Code 등.
구성 단계:
Apidog에서 API 액세스 토큰 및 프로젝트 ID 얻기:
API 액세스 토큰:
- Apidog를 열고 프로필 사진 위로 마우스를 올립니다 (오른쪽 상단).
계정 설정
→API 액세스 토큰
을 선택합니다.새 API 액세스 토큰 생성
을 클릭합니다. 이 토큰을 복사합니다.

프로젝트 ID:
- Apidog에서 대상 프로젝트를 엽니다.
- 왼쪽 사이드바에서 "프로젝트 설정"을 클릭합니다.
- "기본 설정" 탭에서
프로젝트 ID
를 복사합니다.

IDE에서 MCP 구성 (예: Windows의 Cursor):
- Cursor (또는 호환되는 IDE)에서 MCP 설정으로 이동합니다. 이는 종종 설정 아이콘을 통해 "MCP" 또는 "모델 컨텍스트 프로토콜"을 선택하여 찾을 수 있습니다.
- "+ 새 전역 MCP 서버 추가"를 클릭합니다.

- 일반적으로 JSON 구성 파일(예:
mcp.json
)이 표시됩니다. 다음 구성을 붙여넣고 플레이스홀더를 바꿉니다.
{
"mcpServers": {
"API specification": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"apidog-mcp-server@latest",
"--project=<project-id>"
],
"env": {
"APIDOG_ACCESS_TOKEN": "<access-token>"
}
}
}
}
macOS/Linux 사용자의 경우, cmd
및 /c
가 필요 없으므로 구성이 약간 더 간단합니다.
{
"mcpServers": {
"API specification": {
"command": "npx",
"args": [
"-y",
"apidog-mcp-server@latest",
"--project=<project-id>"
],
"env": {
"APIDOG_ACCESS_TOKEN": "<access-token>"
}
}
}
}
구성 확인:
- 구성을 저장한 후 연결을 테스트합니다. 좋은 방법은 AI와 채팅을 열고 (해당하는 경우 에이전트 모드에서) 다음과 같이 묻는 것입니다: MCP를 통해 API 사양을 가져와서 프로젝트에 몇 개의 엔드포인트가 있는지 알려줘.
- AI가 Apidog 프로젝트의 API에 대한 정보를 성공적으로 반환하면 연결이 설정된 것입니다!
PRO TIP: Apidog MCP 서버를 사용하면 어떤 OpenAPI 파일이든 AI에 연결할 수 있습니다.
API 중심 AI 코딩을 위한 Apidog MCP의 주요 장점
Apidog MCP 서버는 API 개발에 대한 뚜렷한 장점을 제공합니다.
- 심층 API 컨텍스트: 엔드포인트, 스키마, 매개변수, 요청/응답 본문 및 설명 등 풍부한 API 사양 데이터에 대한 직접적인 접근을 AI에 제공합니다.
- 정확한 코드 생성: AI 생성 코드(DTO, 클라이언트 라이브러리, 서버 스텁)가 API 디자인과 완벽하게 일치하도록 보장하여 재작업을 최소화합니다.
- 다재다능한 데이터 소스: Apidog 프로젝트 외에도 Apidog가 게시한 온라인 API 문서 및 로컬 또는 온라인 Swagger/OpenAPI 파일을 데이터 소스로 사용하는 것을 지원합니다.
- 효율성 향상: API 계약과 관련된 반복적인 코딩 작업을 자동화하여 개발자가 더 복잡한 로직에 집중할 수 있도록 합니다.
Apidog MCP 서버 vs Google Drive MCP 서버: 필요에 맞는 AI 코딩 도우미 선택하기
Google Drive MCP 서버와 Apidog MCP 서버 모두 중요한 컨텍스트를 제공하여 AI 코딩을 향상시키지만, 주요 목적은 다릅니다. 차이점을 이해하면 특정 API 지원 개발 또는 일반 코딩 작업에 적합한 도구를 선택하는 데 도움이 됩니다.
기능 | Google Drive MCP 서버 | Apidog MCP 서버 |
---|---|---|
주요 사용 사례 | Google Drive의 일반 파일 접근 및 검색 | API 사양을 사용한 AI 지원 API 개발 |
데이터 초점 | 문서, 스프레드시트, 프레젠테이션, 일반 파일 | API 엔드포인트, 스키마, 매개변수, 응답 등 |
AI 지원 | 파일 검색, 요약, Drive 파일의 컨텍스트 | 코드 생성, DTO 업데이트, API 사양 작업 |
이상적인 대상 | Google Drive에서 광범위한 파일 컨텍스트가 필요한 AI 코딩 | API를 구축/소비하는 개발자, AI 기반 API 워크플로우 |
특수성 | 범용 | API 특화 |
Google Drive MCP 서버는 일반 문서나 Drive에 저장된 파일을 포함하는 AI 작업에 탁월하지만, API 개발에 있어서는 Apidog MCP 서버가 더 전문적이고 강력한 선택입니다. 이는 AI에 API 사양에 대한 깊고 구조화된 이해를 부여하며, 이는 정확하고 관련성 있는 API 관련 코드를 생성하는 데 가장 중요합니다.
결론
모델 컨텍스트 프로토콜(MCP) 서버는 AI를 소프트웨어 개발에서 더 효과적인 파트너로 만드는 데 있어 중요한 진전을 나타냅니다. AI 모델에 특정 관련 데이터 소스에 대한 직접적인 접근을 제공함으로써 새로운 수준의 생산성과 정확성을 확보합니다.
Google Drive MCP 서버가 Google Drive에 저장된 파일에 접근해야 하는 일반적인 AI 코딩 작업에 유용한 도구가 될 수 있음을 살펴보았습니다. 문서, 스프레드시트 및 기타 파일을 AI의 컨텍스트로 가져오는 편리한 방법을 제공합니다.
그러나 전문적이고 종종 복잡한 API 개발 영역에서는 Apidog MCP 서버가 게임 체인저로 등장합니다. Apidog 프로젝트, Apidog가 게시한 온라인 문서, 또는 로컬/원격 OpenAPI 파일 등 출처에 관계없이 API 사양을 AI의 작업 환경에 직접 원활하게 통합함으로써, Apidog는 개발자들이 이전에 수동적이고 오류 발생 가능성이 높거나 시간이 많이 소요되었던 작업에 AI를 활용할 수 있도록 지원합니다.
버튼