Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Google Antigravity 2.0, IDE 또는 CLI의 Google Workspace MCP 서버

1. 소개

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

실습할 내용

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

필요한 항목

웹브라우저(예: Chrome)
Google Workspace 개발자 프리뷰 프로그램에 등록된 Google Cloud 프로젝트
Google Workspace 계정
로컬 머신에 설치된 Antigravity 2.0, IDE 또는 CLI. 자세한 내용과 설치 안내는 공식 웹사이트에서 확인할 수 있습니다.

이 Codelab에 쉽게 액세스

2. 시작하기 전에

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

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

API 사용 설정

Google Workspace MCP 서버를 사용하려면 표준 Google Workspace API를 사용 설정해야 합니다.

MCP 서비스 사용 설정

다음으로 Google Workspace 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 Cloud 콘솔에서 Google 인증 플랫폼 > 브랜딩 으로 이동합니다. 구성되지 않은 경우 시작하기 를 클릭합니다.
앱 정보를 구성합니다.
- 앱 이름: Google Workspace MCP Servers
- 사용자 지원 이메일: 이메일을 선택합니다.
대상 을 구성합니다. 내부 를 선택합니다 (내부를 사용할 수 없는 경우 외부).
연락처 정보를 구성합니다. 이메일 주소를 입력합니다.
사용자 데이터 정책을 검토하고 동의한 후 만들기 를 클릭합니다.
외부를 선택한 경우 대상으로 이동하여 테스트 사용자 아래에 이메일을 추가합니다.
데이터 액세스 > 범위 추가 또는 삭제 로 이동합니다. 범위 수동 추가에서 사용할 서버에 다음을 추가합니다.
- 범용: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
- Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
- Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
- Google Docs: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
- Google Sheets: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
- Google Slides: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
- 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.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
- 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 2.0, IDE 또는 CLI가 설치되어 있지 않은 경우 Antigravity 웹사이트의 안내를 따르세요.

커스텀 MCP 서버 추가

Antigravity 2.0, IDE, CLI는 ~/.gemini/config/mcp_config.json 파일에서 중앙 MCP 구성을 공유합니다.

선호하는 텍스트 편집기에서 엽니다.
참고: 다음 단계에 따라 Antigravity IDE에서 직접 파일에 액세스할 수 있습니다(설치된 경우).
1. 편집기 에이전트 패널 상단의 ... 드롭다운을 통해 MCP 서버 를 엽니다.
2. MCP 서버 관리 를 클릭한 다음 원시 구성 보기 를 클릭합니다.
다음 커스텀 MCP 서버 구성을 수정합니다. 이렇게 하기 전에 <YOUR_CLIENT_ID> 및 <YOUR_CLIENT_SECRET> 자리표시자를 이전 단계에서 만든 OAuth 클라이언트 ID와 보안 비밀로 바꿉니다.
저장합니다.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

커스텀 MCP 서버 인증

Antigravity에 설치된 것으로 구성한 모든 MCP 서버(gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat, gws-people)가 표시됩니다. OAuth 토큰이 중앙 집중식으로 관리되지 않으므로 각 Antigravity 화면에 대해 각 토큰을 인증해야 합니다.

Antigravity 2.0

왼쪽 하단에서 설정 을 클릭합니다.
맞춤설정 으로 이동합니다.
설치된 MCP 서버에서 새로고침을 클릭합니다.

나열된 각 설치된 MCP 서버의 경우 다음 단계를 따르세요.
1. 인증 을 클릭합니다.
1. 새 브라우저 창에서 인증 절차를 진행합니다.
2. 완료되면 클립보드에 복사 를 클릭합니다.
1. Antigravity 2.0 설정에 표시된 텍스트 입력란에 복사한 승인 코드를 붙여넣고 제출 을 클릭합니다.
1. 이제 인증 이 로그아웃 버튼으로 대체되어 표시됩니다.

Antigravity IDE

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

맞춤설정 으로 이동합니다.
설치된 MCP 서버에서 새로고침을 클릭합니다.

나열된 각 설치된 MCP 서버의 경우 다음 단계를 따르세요.
1. 인증 을 클릭합니다.
1. 새 브라우저 창에서 인증 절차를 진행합니다.
2. 완료되면 클립보드에 복사 를 클릭합니다.
1. Antigravity IDE 설정에 표시된 텍스트 필드에 복사한 승인 코드를 붙여넣고 제출 을 클릭합니다.
1. 이제 인증 이 로그아웃 버튼으로 대체되어 표시됩니다.

Antigravity CLI

/mcp를 입력하고 Enter 키를 누릅니다.

나열된 각 MCP 서버의 경우 다음 단계를 따르세요.
1. 위쪽 및 아래쪽 화살표 키를 사용하여 선택하고 Enter 키를 누릅니다.
2. 왼쪽 및 오른쪽 화살표 키를 사용하여 인증 을 선택하고 Enter 키를 누릅니다.
1. 새 브라우저 창에서 표시된 URL을 열고 인증 절차를 진행합니다.
1. 완료되면 클립보드에 복사 를 클릭합니다.
1. Antigravity CLI가 실행 중인 터미널에 표시된 텍스트 입력란에 방금 복사한 승인 코드를 붙여넣고 Enter 키를 누릅니다.
1. 이제 인증 필요 가 인증됨 상태로 대체되어 표시됩니다.

5. 테스트 도구

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

범용

여러 제품에서 검색해 보세요.

"내 Google Workspace 계정에서 마지막으로 발생한 일을 몇 문장으로 요약해 줘."
"내 이메일, Docs, Chat 메시지에서 [PROJECT_NAME] 과 관련된 모든 것을 찾아 줘."
"마케팅 계획에 관한 다음 회의는 언제이며, 최신 메모와 Chat 메시지는 무엇이야?"

Gmail

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

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

Google Drive

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

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

Google Docs, Sheets, Slides

Drive 리소스를 검색해 보세요.

"Google 문서 [DOCS_TITLE]의 구조적 콘텐츠를 보여 줘."
"Google Sheets [SHEETS_TITLE]에서 시트 Sheet1을 읽어 줘."
"Google Slides [SLIDES_TITLE]의 구어체 레이아웃을 보여 줘."

Google Calendar

일정을 검색해 보세요.

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

Google Chat

메일을 검색해 보세요.

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

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 서버를 구성하고 테스트했습니다.