Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 Calendar, Google Chat, People API와 상호작용하도록 Antigravity를 설정합니다.

실습할 내용

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

필요한 항목

웹브라우저(예: Chrome)
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 서버는 독립적으로 작동하지만 다른 서버는 여전히 기본 표준 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 2.0, IDE, CLI가 설치되어 있지 않으면 Antigravity 웹사이트의 안내를 따르세요.

맞춤 MCP 서버 추가

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

선호하는 텍스트 편집기에서 엽니다.
참고: 다음 단계에 따라 Antigravity IDE를 설치한 경우 IDE에서 직접 파일에 액세스할 수 있습니다.
1. 편집기의 에이전트 패널 상단에 있는 ... 드롭다운을 통해 MCP Servers를 엽니다.
2. MCP 서버 관리를 클릭한 다음 원시 구성 보기를 클릭합니다.
다음 맞춤 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 서버(gws-calendar, gws-chat, gws-drive, gws-gmail, gws-people)가 Antigravity에 설치된 것으로 표시됩니다. OAuth 토큰이 중앙 집중화되어 있지 않으므로 각 Antigravity 표면에 대해 인증해야 합니다.

Antigrativity 2.0

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

나열된 설치된 각 MCP 서버에 대해 다음을 실행합니다.
1. 인증을 클릭합니다.
1. 새 브라우저 창에서 인증 흐름을 진행합니다.
2. 완료되면 클립보드로 복사를 클릭합니다.
1. 방금 복사한 승인 코드를 Antigravity 2.0 설정에 표시된 텍스트 필드에 붙여넣고 제출을 클릭합니다.
1. 이제 인증이 로그아웃으로 대체되어 표시됩니다.

Antigrativity IDE

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

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

나열된 설치된 각 MCP 서버에 대해 다음을 실행합니다.
1. 인증을 클릭합니다.
1. 새 브라우저 창에서 인증 흐름을 진행합니다.
2. 완료되면 클립보드로 복사를 클릭합니다.
1. 방금 복사한 승인 코드를 Antigravity IDE 설정에 표시된 텍스트 입력란에 붙여넣고 제출을 클릭합니다.
1. 이제 인증이 로그아웃으로 대체되어 표시됩니다.

Antigrativity CLI

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

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

5. 테스트 도구

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