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

Workspace용 유니버설 검색 MCP 서버를 사용하여 AI 에이전트가 Workspace 전체를 검색하도록 허용

Google Workspace용 범용 검색 MCP 서버는 모델 컨텍스트 프로토콜 (MCP) 표준을 사용하여 AI 에이전트가 Workspace 아티팩트를 검색할 수 있도록 합니다. 이 서버에서는 단일 도구를 사용하여 Gmail 메시지, Google Drive 파일, Google Calendar 일정, Google Chat 스페이스 및 메시지 등 여러 Google Workspace 제품을 검색할 수 있는 방법을 제공합니다.

범용 검색 MCP 서버는 AI 에이전트가 개별 제품별 도구를 호출할 필요 없이 전체 Google Workspace 계정에서 정보를 검색할 수 있는 표준화된 방법을 제공합니다.

기본 요건

Google Workspace 개발자 프리뷰 프로그램 멤버십
Google Cloud 프로젝트 프로젝트를 만들려면 프로젝트 만들기를 참조하세요.
Google Antigravity와 같은 MCP 클라이언트
이 페이지에서 명령어를 실행하려면 다음 개발 환경 중 하나에서 gcloud CLI를 설정하세요.
Cloud Shell
gcloud CLI로 이미 설정된 온라인 터미널을 사용하려면 Cloud Shell을 활성화하세요.

Cloud Shell 활성화
로컬 셸
로컬 개발 환경을 사용하려면 다음 단계를 수행합니다.
1. Google Cloud CLI를 설치합니다. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인합니다.
2. 외부 ID 공급업체 (IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인합니다. 자세한 내용은 제휴 ID로 gcloud CLI에 로그인을 참조하세요.
3. gcloud CLI를 초기화합니다.

범용 검색 MCP 서버 구성

범용 검색 MCP 서버를 사용하려면 Google Cloud 프로젝트에서 사용 설정한 후 MCP 클라이언트를 구성하여 연결해야 합니다.

API 사용 설정

범용 검색 MCP 서버를 사용하려면 Google Cloud 프로젝트에서 Google Workspace MCP API를 사용 설정하세요.

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

콘솔

Google Cloud 콘솔에서 API를 사용 설정합니다.

API 사용 설정

Universal Search MCP 서버는 인증 및 승인에 OAuth 2.0을 사용합니다. OAuth 클라이언트 ID를 만들려면 먼저 OAuth 동의 화면을 구성해야 합니다.

다른 MCP 서버에 대해 OAuth 동의 화면을 이미 구성한 경우 범용 검색 MCP 서버에 필요한 범위를 추가했는지 확인하세요.

범용 검색 MCP 서버로 인증할 때 요청된 모든 범위 또는 일부 범위만 인증하도록 선택할 수 있습니다. 서버는 이러한 선택을 준수하고 액세스 권한이 부여된 제품만 검색합니다.

예를 들어 다음 범위로 모두 인증하는 경우:

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

범용 검색 MCP 서버는 Gmail, Google Drive, Google Calendar, Google Chat을 검색합니다.

하지만 https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly에만 액세스 권한을 부여하고 https://www.googleapis.com/auth/gmail.readonly는 생략하면 범용 검색은 Google Drive, Google Calendar, Google Chat의 결과만 반환합니다. 이메일을 검색하거나 Gmail 결과를 반환하지 않습니다.

Google Cloud 콘솔에서 Google 인증 플랫폼 > 데이터 액세스로 이동합니다.
범위 추가 또는 삭제를 클릭합니다.
다음 범위 중 하나 이상을 추가합니다.
- 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
업데이트를 클릭한 다음 저장을 클릭합니다.

동의 화면 설정에 관한 자세한 안내는 Google Workspace MCP 서버 구성하기를 참고하세요.

MCP 클라이언트 구성

MCP 클라이언트에 범용 검색 MCP 서버를 추가하려면 클라이언트 안내를 따르세요.

Antigravity

Antigravity에 범용 검색 MCP 서버를 추가하려면 mcp_config.json 파일에 서버 구성을 추가합니다. 이 안내는 Antigravity 2.0, Antigravity IDE, Antigravity CLI를 지원합니다.

웹 애플리케이션 유형의 OAuth 2.0 클라이언트 ID 및 보안 비밀을 만듭니다. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 후 URI 필드에 https://antigravity.google/oauth-callback를 추가합니다. AI 기반 에이전트에 이 클라이언트 사용을 선택합니다. 자세한 내용은 Google Workspace MCP 서버 구성하기를 참고하세요.
구성 파일 ~/.gemini/config/mcp_config.json을 열거나 만듭니다.

workspace-universal 구성을 mcp_config.json에 추가합니다.

{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

다음을 바꿉니다.

OAUTH_CLIENT_ID: 생성한 클라이언트 ID입니다.
OAUTH_CLIENT_SECRET: 생성한 클라이언트 보안 비밀번호입니다.

mcp_config.json 할인을 받으세요.
MCP 서버를 인증합니다. GUI 설정 또는 CLI를 사용하여 인증할 수 있습니다.
- Antigravity IDE 또는 GUI (Antigravity 2.0):
  1. 설정 화면을 엽니다 (예: 왼쪽 하단의 설정을 클릭하거나 Antigravity 사용자 설정을 엽니다).
  2. 맞춤설정으로 이동합니다.
  3. 설치된 MCP 서버에서 새로고침을 클릭합니다.
  4. 목록에서 workspace-universal를 찾아 인증을 클릭하고 Google 계정에 로그인한 후 승인 코드를 복사하여 입력 대화상자에 붙여넣고 제출을 클릭합니다.
- Antigravity CLI:
  1. Antigravity CLI를 시작합니다.
```
agy
```
  2. 다음을 실행하여 대화형 MCP 관리 패널을 엽니다.
```
/mcp
```
  3. 화살표 키를 사용하여 workspace-universal를 선택하고 인증 작업으로 이동한 후 Enter를 누릅니다. 브라우저에서 로그인 과정을 완료하고 승인 코드를 복사하여 터미널 프롬프트에 붙여넣은 다음 Enter를 누릅니다.
서버가 올바르게 구성되고 실행 중인지 확인합니다.
- Antigravity IDE 또는 GUI: 맞춤설정 > 설치된 MCP 서버의 workspace-universal 옆에 로그아웃 버튼이 표시됩니다.
- Antigravity CLI: /mcp 패널을 열어 구성된 MCP 서버를 확인합니다. 확인 및 인증된 서버는 대화형 TUI 패널 내에서 이름 옆에 Authed를 표시합니다. 대시보드 뷰에서 workspace-universal 서버를 선택하여 상태를 검사하고 사용 가능한 모든 도구를 나열할 수 있습니다.

Claude

Claude에 범용 검색 MCP 서버를 추가하려면 커스텀 커넥터를 구성합니다.

웹 애플리케이션 유형의 OAuth 2.0 클라이언트 ID 및 보안 비밀을 만들고 AI 기반 에이전트에 이 클라이언트 사용을 선택합니다. 자세한 내용은 Google Workspace MCP 서버 구성하기를 참고하세요.
Claude 설정에서 커스텀 커넥터를 추가합니다.
- 서버 이름: Universal Search MCP Server
- 원격 MCP 서버 URL: https://workspacemcp.googleapis.com/mcp/v1
- OAuth 클라이언트 ID 및 OAuth 클라이언트 보안 비밀번호: 사용자 인증 정보를 입력합니다.
- 범위: 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를 포함합니다.

범용 검색 MCP 서버 테스트

여러 제품을 검색해야 하는 질문을 MCP 클라이언트에 해보세요.

"내 이메일, 문서, 채팅 메시지에서 프로젝트 X와 관련된 모든 항목을 찾아 줘."
"마케팅 계획에 관한 다음 회의는 언제이고, 이와 관련된 최신 메모와 채팅 메시지는 무엇인가요?"

도구가 성공적으로 실행되고 여러 제품에서 관련 응답을 받으면 Universal Search MCP 서버가 올바르게 구성된 것입니다.

지원되는 도구

범용 검색 MCP 서버는 다음 도구를 제공합니다.

search_corpus: 제공된 쿼리를 기반으로 여러 Google Workspace 제품 (Google Drive, Gmail, Google Calendar, Google Chat)에서 검색을 수행합니다.

Workspace용 유니버설 검색 MCP 서버를 사용하여 AI 에이전트가 Workspace 전체를 검색하도록 허용 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

기본 요건

Cloud Shell

로컬 셸

범용 검색 MCP 서버 구성

API 사용 설정

CLI

콘솔

OAuth 동의 화면 설정

MCP 클라이언트 구성

Antigravity

Claude

범용 검색 MCP 서버 테스트

지원되는 도구

Workspace용 유니버설 검색 MCP 서버를 사용하여 AI 에이전트가 Workspace 전체를 검색하도록 허용