Antigravity의 Google Workspace MCP 서버

1. 소개

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

Google Workspace MCP 아키텍처

실습할 내용

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

필요한 항목

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

이 Codelab에 쉽게 액세스

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 인증 플랫폼 > 클라이언트 > 클라이언트 만들기 로 이동합니다.
애플리케이션 유형으로 웹 애플리케이션 을 선택합니다.
이름을 Antigravity로 지정합니다.
승인된 리디렉션 URI에서 + URI 추가를 클릭한 다음 https://antigravity.google/oauth-callback을 입력합니다.
만들기 를 클릭하고 클라이언트 ID 와 클라이언트 보안 비밀번호 를 복사합니다. 다음 단계에서 필요합니다.

4. Antigravity 구성

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

맞춤 MCP 서버 추가

편집기의 에이전트 패널 상단에 있는 ... 드롭다운을 통해 MCP 서버 를 엽니다.

MCP 서버 관리 를 클릭한 다음 원시 구성 보기 를 클릭합니다.

새로 열린 파일 mcp_config.json을 다음 맞춤 MCP 서버 구성으로 수정합니다. 이렇게 하기 전에 <YOUR_CLIENT_ID> 및 <YOUR_CLIENT_SECRET> 자리표시자를 이전 단계에서 만든 OAuth 클라이언트 ID와 보안 비밀로 바꿉니다.

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

MCP 서버 관리 로 돌아간 다음 새로고침 을 클릭합니다.

맞춤 MCP 서버 인증

창 상단에 있는 편집기별 설정 메뉴 드롭다운을 통해 Antigravity 사용자 설정 을 엽니다.

맞춤설정 으로 이동합니다.

**설치된 MCP 서버** 아래에 나열된 각 서버의 경우 다음 단계를 따르세요.
1. 인증 을 클릭합니다.

새 브라우저 창에서 열리는 인증 흐름을 진행합니다.
완료되면 클립보드에 복사 를 클릭합니다.

브라우저 창을 닫습니다.
방금 복사한 승인 코드를 Antigravity 설정에 표시되는 텍스트 필드에 붙여넣습니다.
제출 을 클릭합니다.

5. 테스트 도구

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

Google Calendar

일정을 검색해 보세요.

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

Google Chat

메일을 검색해 보세요.

"‘[SPACE_NAME]’에서 ‘[KEYWORD]'가 포함된 메일 찾아 줘"

Google Drive

파일을 검색하거나 읽어 보세요.

"내 Google Drive에서 ‘[KEYWORD]'가 포함된 파일 검색해 줘."
"내가 가장 최근에 수정한 문서 나열해 줘."
"내 ‘[FILE_NAME]' 문서의 콘텐츠를 읽고 주요 목표를 요약해 줘."

Gmail

이메일을 검색하거나 관리해 보세요.

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

People API

프로필 또는 연락처를 검색해 보세요.

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

여러 서비스 결합

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

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

도구 더보기

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

6. 정리

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

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

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

7. 축하합니다

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