Google Drive MCP 서버 설정 방법 (2026)
Model Context Protocol을 통해 Google Drive를 AI 어시스턴트에 연결하기
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
2026년 Google Drive MCP 서버 설정 방법
문서, 사양서 또는 참고 자료가 Google Drive에 저장되어 있다면, MCP를 통해 이를 AI 코딩 어시스턴트에 연결하여 내용을 일일이 복사해서 붙여넣을 필요 없이 AI가 해당 문서를 직접 읽게 할 수 있습니다. 이 가이드에서는 Google Drive MCP 서버를 설정하고, 인증을 구성하며, Claude Desktop, Claude Code, Cursor 및 기타 MCP 호환 도구에 연결하는 방법을 다룹니다.
Google Drive MCP로 할 수 있는 작업
연결이 완료되면 AI 어시스턴트는 다음 작업을 수행할 수 있습니다.
- 검색: 이름이나 내용으로 Google Drive 파일 검색
- 읽기: Google Docs, Sheets, Slides 및 업로드된 파일(PDF, 텍스트 파일, 이미지) 읽기
- 목록 조회: 특정 폴더의 파일 목록 확인
- 스프레드시트 데이터 읽기: 분석을 위해 Google Sheets 데이터 추출
- 공유 드라이브 액세스: 공유 드라이브 및 팀 폴더 접근
실용적인 활용 사례
| 활용 사례 | 예시 |
|---|---|
| 사양서 기반 코딩 | "공유 드라이브의 API 사양서를 읽고 TypeScript 타입을 생성해줘" |
| 데이터 분석 | "Google Sheet에서 4분기 지표를 가져와서 트렌드를 요약해줘" |
| 문서 작업 | "Drive에 있는 스타일 가이드를 확인하고 이 컴포넌트 문서를 다시 작성해줘" |
| 회의록 관리 | "어제 스탠업 미팅 노트를 읽고 Jira 티켓을 생성해줘" |
| 디자인 리뷰 | "제품 요구 사양서(PRD)를 읽고 내 구현 내용과 비교해줘" |
사전 요구 사항
시작하기 전에 다음이 필요합니다.
- Google Cloud Platform 계정 (무료 티어 가능)
- Drive 접근 권한이 있는 Google Workspace 또는 개인 Gmail 계정
- Node.js 18+ 설치
- MCP 호환 AI 클라이언트 (Claude Desktop, Claude Code, Cursor 등)
1단계: Google Cloud 프로젝트 생성
- Google Cloud 콘솔로 이동합니다.
- 상단의 프로젝트 선택을 클릭한 다음 새 프로젝트를 클릭합니다.
- 프로젝트 이름을
mcp-drive-server와 같이 입력합니다. - 만들기를 클릭합니다.
2단계: Google Drive API 활성화
- 새 프로젝트에서 API 및 서비스 > 라이브러리로 이동합니다.
- **"Google Drive API"**를 검색합니다.
- 해당 API를 클릭하고 사용 설정을 누릅니다.
- 스프레드시트 접근이 필요한 경우 **"Google Sheets API"**도 검색하여 활성화합니다.
3단계: OAuth 2.0 사용자 인증 정보 생성
MCP 서버는 사용자를 대신하여 Drive에 접근하기 위해 OAuth 인증 정보가 필요합니다.
- API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 안내가 뜨면 먼저 OAuth 동의 화면을 구성합니다.
- **외부(External)**를 선택합니다 (Workspace 사용자는 내부 선택 가능).
- 앱 이름을 입력합니다:
MCP Drive Server - 본인의 이메일을 테스트 사용자로 추가합니다.
- 동의 화면에서 범위(scope)를 추가할 필요는 없습니다 (실행 시 요청됨).
- 다시 사용자 인증 정보로 돌아가서 애플리케이션 유형으로 **데스크톱 앱(Desktop app)**을 선택합니다.
- 이름을
MCP Drive Server로 입력합니다. - 만들기를 클릭합니다.
- JSON 파일을 다운로드하여
gcp-oauth.keys.json으로 저장합니다.
# 다운로드한 파일을 안전한 위치로 이동
mkdir -p ~/.config/mcp
mv ~/Downloads/client_secret_*.json ~/.config/mcp/gcp-oauth.keys.json
4단계: Google Drive MCP 서버 설치
공식 Google Drive MCP 서버를 설치합니다.
npm install -g @anthropic/mcp-server-gdrive
또는 npx를 통해 설치 없이 사용합니다.
npx -y @anthropic/mcp-server-gdrive
5단계: Google 인증
서버를 처음 실행할 때 Google Drive 접근 권한을 얻기 위해 OAuth 흐름을 완료해야 합니다.
# 인증 흐름 실행
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json
이 명령어를 실행하면:
- 브라우저에서 Google 로그인 페이지가 열립니다.
- MCP 서버에 Drive 접근 권한을 부여할지 묻는 메시지가 나타납니다.
- 승인하면 추후 사용을 위해 리프레시 토큰(refresh token)이 로컬에 저장됩니다.
토큰은 ~/.config/mcp/gdrive-credentials.json에 저장됩니다. 이 파일을 안전하게 보관하세요.
# 토큰 저장 여부 확인
ls -la ~/.config/mcp/gdrive-credentials.json
6단계: AI 클라이언트에 연결
Claude Desktop
Claude Desktop 설정 파일을 편집합니다.
# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
code %APPDATA%\Claude\claude_desktop_config.json
Google Drive 서버 설정을 추가합니다.
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
}
}
}
}
Claude Desktop을 재시작합니다. 도구 메뉴(망치 아이콘)에서 Google Drive 도구가 활성화된 것을 볼 수 있습니다.
Claude Code (CLI)
Claude Code 설정에 MCP 서버를 추가합니다.
claude mcp add gdrive \
--command "npx" \
--args "-y" "@anthropic/mcp-server-gdrive" \
--env "GDRIVE_OAUTH_KEYS_FILE=/Users/yourname/.config/mcp/gcp-oauth.keys.json" \
--env "GDRIVE_CREDENTIALS_FILE=/Users/yourname/.config/mcp/gdrive-credentials.json"
또는 ~/.claude/mcp.json 파일에서 직접 편집할 수 있습니다.
{
"servers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
}
}
}
}
Cursor
Cursor 설정에서 MCP 서버를 추가합니다.
- Settings (
Cmd+,)를 엽니다. - **"MCP"**를 검색합니다.
- Edit in settings.json을 클릭하거나 MCP 구성 섹션으로 이동합니다.
- Google Drive 서버를 추가합니다.
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/yourname/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/yourname/.config/mcp/gdrive-credentials.json"
}
}
}
}
7단계: Google Drive MCP 사용하기
서버가 연결되면 자연어를 통해 Google Drive와 상호작용할 수 있습니다.
파일 검색
사용자: 내 Google Drive에서 "API 사양서"를 검색해줘.
AI: [gdrive 도구 사용: search_files]
일치하는 파일 3개를 찾았습니다:
1. "API Specification v3.2" (Google Docs, 공유 드라이브)
2. "API Specification - Draft" (Google Docs, 내 드라이브)
3. "api-spec-old.pdf" (PDF, 내 드라이브)
이 중 어떤 파일을 읽어드릴까요?
문서 읽기
사용자: "API Specification v3.2" 문서를 읽고 사용자 엔드포인트에 대한 TypeScript 인터페이스를 생성해줘.
AI: [gdrive 도구 사용: read_file]
문서를 읽었습니다. 사양에 기반한 TypeScript 인터페이스는 다음과 같습니다:
interface User {
id: string;
email: string;
name: string;
role: 'admin' | 'user' | 'viewer';
createdAt: string;
...
}
스프레드시트 데이터 읽기
사용자: "Q4 Metrics" 스프레드시트를 읽고 주요 트렌드를 요약해줘.
AI: [gdrive 도구 사용: read_spreadsheet]
4분기 지표 요약은 다음과 같습니다:
- 월간 활성 사용자(MAU) 23% 증가 (45K -> 55K)
- 매출 15% 증가 ($120K -> $138K)
- 이탈률(Churn rate) 4.2%에서 3.8%로 감소
...
폴더 내용 나열
사용자: "Engineering/Design Docs" 폴더에 어떤 파일들이 있어?
AI: [gdrive 도구 사용: list_files]
Engineering/Design Docs 폴더의 파일 목록입니다:
- Architecture Overview.gdoc (1월 15일 업데이트)
- Database Schema.gdoc (1월 22일 업데이트)
- API Design Principles.gdoc (12월 3일 업데이트)
- Deployment Runbook.gdoc (1월 28일 업데이트)
사용 가능한 MCP 도구
Google Drive MCP 서버는 다음과 같은 도구들을 노출합니다.
| 도구 | 설명 | 파라미터 |
|---|---|---|
search_files |
이름이나 내용으로 파일 검색 | query (string) |
read_file |
파일 내용 읽기 | fileId (string) |
list_files |
폴더 내 파일 목록 조회 | folderId (string, 선택 사항) |
read_spreadsheet |
Google Sheet 데이터 읽기 | spreadsheetId, range |
문제 해결
"Token has been expired or revoked" (토큰 만료 또는 취소)
다시 인증을 수행하세요.
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json
"Access Not Configured" 에러
GCP 프로젝트에서 Google Drive API가 활성화되어 있는지 확인하세요.
- console.cloud.google.com/apis/library로 이동합니다.
- "Google Drive API"를 검색합니다.
- 상태가 **사용 설정됨(Enabled)**인지 확인합니다.
서버는 시작되었지만 도구가 보이지 않음
MCP 서버 로그를 확인하세요. Claude Desktop의 경우 다음 경로에서 확인할 수 있습니다.
# macOS
~/Library/Logs/Claude/mcp-gdrive.log
# 또는 Claude Desktop 개발자 콘솔 확인
# View > Developer > Developer Tools
브라우저에서 "이 앱은 검증되지 않음" 경고 발생
OAuth 인증 과정 중 앱이 테스트 모드인 경우 Google에서 경고를 표시할 수 있습니다. **고급 > MCP Drive Server(으)로 이동(안전하지 않음)**을 클릭하여 진행하세요. 이는 개인용 OAuth 앱에서 발생하는 정상적인 절차입니다.
파일을 찾을 수 없음
MCP 서버는 인증된 Google 계정이 모니터링할 권한이 있는 파일만 접근할 수 있습니다. 파일을 찾을 수 없는 경우 다음을 확인하세요.
- 파일이 내 Google 계정과 공유되어 있는지 확인
- 본인이 접근 권한이 있는 공유 드라이브에 파일이 있는지 확인
- 정확한 파일 이름으로 검색 시도
보안 고려 사항
토큰 저장
OAuth 토큰은 로컬 장치에 저장됩니다. 보안을 위해 권한을 제한하세요.
# 권한 제한 설정
chmod 600 ~/.config/mcp/gdrive-credentials.json
chmod 600 ~/.config/mcp/gcp-oauth.keys.json
권한 범위(Scope) 제한
MCP 서버는 기본적으로 Drive에 대한 읽기 전용(read-only) 권한을 요청합니다. 서버 구현이 해당 기능을 명시적으로 지원하지 않는 한 파일을 수정, 삭제 또는 생성할 수 없습니다.
공유 드라이브
공유 드라이브(팀 드라이브)에 접근해야 하는 경우, OAuth 동의 화면에 drive.readonly 범위가 포함되어 있고 Google Workspace 관리자가 공유 드라이브에 대한 API 접근을 차단하지 않았는지 확인하세요.
문서 접근 그 이상의 활용
Google Drive를 AI 어시스턴트에 연결하는 것은 더 큰 워크플로우의 한 조각입니다. Drive에서 사양을 읽는 동시에 시각적 콘텐츠, 비디오 또는 오디오를 생성해야 하는 AI 기반 애플리케이션을 구축하고 있다면, Hypereal AI는 MCP 지원 개발 환경과 잘 어울리는 통합 미디어 생성 API를 제공합니다.
요약
Google Drive MCP 서버를 설정하려면 GCP 프로젝트 생성, Drive API 활성화, OAuth 사용자 인증 정보 생성, AI 클라이언트 구성 단계를 거쳐야 합니다. 연결이 완료되면 AI 어시스턴트는 드라이브의 모든 파일을 검색하고, 읽고, 분석할 수 있게 됩니다. 초기 설정 과정에서 OAuth 구성이 다소 까다로울 수 있지만, 한 번 인증되면 토큰이 유지되어 원활하게 사용할 수 있습니다. 이 기능을 활용하여 문서와 코드 사이의 간극을 좁혀보세요.
