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

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

Universal Search MCP 서버는 AI 에이전트가 개별 제품별 도구를 호출하지 않고도 전체 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를 초기화합니다.

Universal Search MCP 서버 구성

Universal Search MCP 서버를 사용하려면 Google Cloud 프로젝트에서 사용 설정한 후 MCP 클라이언트가 연결되도록 구성해야 합니다.

API 사용 설정

Universal Search MCP 서버를 사용하려면 Google Cloud 프로젝트에서 Google Workspace MCP API와 검색하려는 제품의 API를 사용 설정하세요.

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
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 동의 화면을 이미 구성한 경우 Universal Search MCP 서버에 필요한 범위를 추가했는지 확인합니다.

Universal Search 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

Universal Search 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 결과를 반환하지 않습니다.

  1. Google Cloud 콘솔에서 Google 인증 플랫폼 > 데이터 액세스 로 이동합니다.
  2. 범위 추가 또는 삭제 를 클릭합니다.

  3. 다음 범위 중 하나 이상을 추가합니다.

    • 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

  4. 업데이트 를 클릭한 다음 저장 을 클릭합니다.

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

MCP 클라이언트 구성

Universal Search MCP 서버를 MCP 클라이언트에 추가하려면 클라이언트의 안내를 따르세요.

Antigravity

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

  1. 웹 애플리케이션 유형의 OAuth 2.0 클라이언트 ID 및 보안 비밀번호를 만듭니다. 승인된 리디렉션 URI 섹션에서 + URI 추가를 클릭한 후 https://antigravity.google/oauth-callback을(를) URI 필드에 추가합니다. 자세한 내용은 Google Workspace MCP 서버 구성을 참고하세요.

  2. 구성 파일 ~/.gemini/antigravity/mcp_config.json을 열거나 만듭니다.

  3. 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: 만든 클라이언트 보안 비밀번호입니다.

  4. mcp_config.json을 저장합니다.

  5. 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 를 누릅니다.

  6. 서버가 올바르게 구성되고 실행 중인지 확인합니다.

    • Antigravity IDE 또는 GUI의 경우: 맞춤설정 > 설치된 MCP 서버 아래의 workspace-universal 옆에 로그아웃 버튼이 표시됩니다.
    • Antigravity CLI의 경우: /mcp 패널을 열어 구성된 MCP 서버를 확인합니다. 인증된 서버는 대화형 TUI 패널 내의 이름 옆에 인증됨 을 표시합니다. 대시보드 뷰에서 workspace-universal 서버를 선택하여 상태를 검사하고 사용 가능한 모든 도구를 나열할 수 있습니다.

Claude

Universal Search MCP 서버를 Claude에 추가하려면 커스텀 커넥터를 구성하세요.

  1. 웹 애플리케이션 유형의 OAuth 2.0 클라이언트 ID 및 보안 비밀번호를 만듭니다. 자세한 내용은 Google Workspace MCP 서버 구성을 참고하세요.

  2. 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를 포함합니다.

Universal Search MCP 서버 테스트

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

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

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

지원되는 도구

Universal Search MCP 서버는 다음 도구를 제공합니다.

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