Google Workspace MCP 및 Gemini CLI 시작하기

1. 소개

이 Codelab에서는 모델 컨텍스트 프로토콜 (MCP)을 사용하여 Gemini CLI를 Google Workspace 데이터에 연결하는 방법을 알아봅니다. MCP는 AI 모델이 원격 서버에서 제공하는 도구를 안전하게 사용할 수 있도록 지원하는 개방형 표준입니다. Gemini CLI를 클라이언트로 사용하여 코드를 작성하지 않고도 Gmail, Google Drive, Google Calendar, Google Chat, People API와 상호작용합니다.

Google Workspace MCP 아키텍처

실습할 내용

Google Cloud 프로젝트에서 Google Workspace MCP 서비스를 사용 설정합니다.
이러한 MCP 서비스를 사용하도록 Gemini CLI를 구성합니다.
Google Workspace 데이터와 상호작용하는 재미있고 유용한 프롬프트로 통합을 테스트합니다.

필요한 항목

웹브라우저(예: Chrome)
Google Cloud 프로젝트
Google Workspace 계정
로컬 머신에 설치된 Gemini CLI

이 Codelab을 완료하는 데 약 30분이 소요됩니다.

이 Codelab에 쉽게 액세스

이 Codelab에 액세스하는 QR 코드

2. 시작하기 전에

Google Cloud 프로젝트 만들기 또는 선택

Google Cloud 콘솔에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

API 사용 설정

Google Workspace MCP 서버를 사용하려면 표준 Google Workspace API를 사용 설정해야 합니다. 일부 MCP 서버는 독립적으로 작동하지만 다른 서버는 여전히 기본 표준 API를 사용 설정해야 합니다.

Gmail 및 Chat에는 여전히 표준 API가 필요합니다.
Drive에는 특정 도구에 표준 API가 필요합니다.
Calendar에서는 표준 API를 사용 설정하지 않아도 됩니다.
People API는 일반 액세스와 MCP 기능을 모두 처리하므로 사용 설정할 별도의 MCP 서비스가 없습니다.

MCP 서비스 사용 설정

그런 다음 제품에 전용 MCP 서비스를 사용 설정합니다.

Chat 앱 구성

Google Chat MCP 서버를 사용하려면 Google Cloud 프로젝트에서 Chat 앱을 구성해야 합니다.

Google Cloud 콘솔에서 Google Chat API를 검색하고 Google Chat API > 관리 > 구성을 클릭합니다.
Chat 앱 설정:
- 앱 이름 필드에 Chat MCP를 입력합니다.
- 아바타 URL 필드에 https://developers.google.com/chat/images/quickstart-app-avatar.png를 입력합니다.
- 설명에 Chat MCP server을 입력합니다.
- 기능에서 대화형 기능 사용 설정을 사용 중지로 전환하여 대화형 기능을 사용 중지합니다.
- 로그에서 Logging에 오류 로깅을 선택합니다.
저장을 클릭합니다.

3. OAuth 동의 및 클라이언트 구성

Google Workspace MCP 서버는 보안 인증에 OAuth 2.0을 사용합니다. OAuth 동의 화면을 구성하고 데스크톱 애플리케이션 클라이언트를 만들어야 합니다.

Google Workspace MCP 서버는 인증에 OAuth 2.0을 사용합니다. 먼저 동의 화면을 구성해야 합니다.

Google Cloud 콘솔에서 Google 인증 플랫폼 > 브랜딩으로 이동합니다. 구성되지 않은 경우 시작하기를 클릭합니다.
앱 정보를 구성합니다.
- 앱 이름: Google Workspace MCP Servers
- 사용자 지원 이메일: 이메일을 선택합니다.
대상 구성: 내부를 선택합니다 (내부를 사용할 수 없는 경우 외부 선택).
연락처 정보 구성: 이메일 주소를 입력합니다.
사용자 데이터 정책을 검토하고 동의한 후 만들기를 클릭합니다.
외부를 선택한 경우 잠재고객으로 이동하여 테스트 사용자에 이메일을 추가합니다.
데이터 액세스 > 범위 추가 또는 삭제로 이동합니다. 범위 수동 추가에서 사용하려는 서버에 다음을 추가합니다.
- Google Calendar: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
- Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.users.readstate.readonly
- Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
- Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
- People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
표에 추가, 업데이트, 저장을 차례로 클릭합니다.

OAuth 클라이언트 ID 만들기

Google 인증 플랫폼 > 클라이언트 > 클라이언트 만들기로 이동합니다.
애플리케이션 유형으로 데스크톱 앱을 선택합니다.
파일 이름을 Gemini CLI로 지정합니다.
만들기를 클릭하고 클라이언트 ID와 클라이언트 보안 비밀번호를 복사합니다. 다음 단계에서 이 정보가 필요합니다.

4. Gemini CLI 구성

이제 이러한 엔드포인트를 사용하도록 Gemini CLI를 구성해 보겠습니다. Gemini CLI가 설치되어 있지 않으면 Gemini CLI 웹사이트의 설치 안내를 따르세요.

구성 파일 만들기

홈 디렉터리에서 ~/.gemini/settings.json을 열거나 만들고 다음 구성을 추가합니다. 자리표시자를 OAuth 사용자 인증 정보로 바꿉니다.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/chat.spaces.readonly",
          "https://www.googleapis.com/auth/chat.memberships.readonly",
          "https://www.googleapis.com/auth/chat.messages.readonly",
          "https://www.googleapis.com/auth/chat.users.readstate.readonly"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. MCP 서버 인증 및 확인

MCP 서버를 사용하려면 연결되어 있는지 인증하고 확인해야 합니다.

Gemini CLI 시작

터미널에서 다음 명령어를 실행하여 Gemini CLI를 시작합니다.

gemini

인증

Gemini CLI에서 해당 명령어를 실행하여 테스트할 서비스로 인증합니다. 이 Codelab에서 사용할 서비스로만 인증하면 됩니다.

캘린더

/mcp auth calendar

채팅

/mcp auth chat

드라이브

/mcp auth drive

Gmail

/mcp auth gmail

사용자

/mcp auth people

브라우저의 메시지에 따라 각 서비스를 승인합니다.

연결 확인

도구가 로드되어 준비되었는지 확인합니다.

/mcp list

서비스가 Ready이고 도구가 나열되어 있음을 나타내는 출력이 표시됩니다.

6. MCP 서버 테스트

이제 자연어를 사용하여 Google Workspace 데이터와 상호작용할 수 있습니다. 다음은 각 서비스에 대한 프롬프트의 예입니다.

Google Calendar

Gemini에게 일정에 관해 물어보세요.

"이번 주에 예정된 회의는 뭐야?"
"내일 오후에 시간이 있나?"

Google Chat

Gemini에게 메시지를 검색해 달라고 요청해 보세요.

'[SPACE_NAME]'에서 '[KEYWORD]'가 포함된 메시지를 찾아줘'

Google Drive

Gemini에게 파일을 찾거나 읽어 달라고 요청해 보세요.

'내 Google Drive에서 '[키워드]'가 포함된 파일을 검색해 줘.'
'내가 수정한 가장 최근 문서를 나열해 줘.'
'[FILE_NAME]' 문서의 내용을 읽고 주요 목표를 요약해 줘.

Gmail

Gemini에게 이메일을 검색하거나 관리해 달라고 요청해 보세요.

'내가 받은 최근 이메일 5개를 요약해 줘.'
'[EMAIL_ADDRESS]'에 '[PROJECT_NAME]' 프로젝트의 업데이트를 요청하는 이메일을 작성해 줘.'

People API

Gemini에게 내 프로필 또는 연락처에 관해 물어보세요.

'내 Google 프로필에 따르면 내 이름은 뭐야?'
"[이름]의 연락처 정보를 찾아 줘."

여러 서비스 결합

MCP의 진정한 힘은 Gemini가 여러 서비스에서 작업을 오케스트레이션할 때 발휘됩니다. 크로스 서비스 기능을 보여주는 다음 프롬프트를 사용해 보세요.

'[PROJECT_NAME] 마일스톤 업데이트'와 관련된 파일을 Drive에서 검색하고, 콘텐츠를 요약하고, '[NAME]'의 이메일 주소를 찾아 요약이 포함된 Gmail 초안을 작성해 줘.'

도구 더보기

이는 몇 가지 예일 뿐입니다. 각 서비스에서 사용할 수 있는 도구의 전체 목록을 확인하고 사용해 보려면 공식 문서의 지원되는 제품 섹션을 참고하세요.

7. 삭제

프로젝트를 삭제하지 않고 정리하려면 사용 설정한 API와 MCP 서비스를 사용 중지하면 됩니다.

Google Cloud 콘솔에서 API 및 서비스 대시보드로 이동합니다.
사용 설정한 각 Google Workspace 및 MCP API (예: Calendar MCP, Chat MCP)를 클릭하고 API 사용 중지를 클릭합니다.

더 이상 OAuth 클라이언트 사용자 인증 정보를 사용하지 않을 계획이라면 Google 인증 플랫폼 콘솔에서 OAuth 클라이언트 사용자 인증 정보를 삭제합니다.

8. 축하합니다

축하합니다. Gemini CLI를 사용하여 공식 Google Workspace MCP 서버를 구성하고 테스트했습니다.

학습한 내용

Google Cloud에서 Google Workspace MCP 서비스를 사용 설정하는 방법
MCP용 OAuth 클라이언트를 구성하는 방법
표준 도구를 사용하여 Gemini CLI로 Google Workspace 데이터와 상호작용하는 방법

Google Workspace MCP 및 Gemini CLI 시작하기

1. 소개

실습할 내용

필요한 항목

이 Codelab에 쉽게 액세스

2. 시작하기 전에

Google Cloud 프로젝트 만들기 또는 선택

API 사용 설정

MCP 서비스 사용 설정

Chat 앱 구성

3. OAuth 동의 및 클라이언트 구성

OAuth 동의 화면 설정

OAuth 클라이언트 ID 만들기

4. Gemini CLI 구성

구성 파일 만들기

5. MCP 서버 인증 및 확인

Gemini CLI 시작

인증

캘린더

채팅

드라이브

Gmail

사용자

연결 확인

6. MCP 서버 테스트

Google Calendar

Google Chat

Google Drive

Gmail

People API

여러 서비스 결합

도구 더보기

7. 삭제

8. 축하합니다

학습한 내용

참조 문서