Workspace için Evrensel Arama MCP Sunucusu ile yapay zeka temsilcilerinin Workspace'te arama yapmasına izin verme

Google Workspace için Evrensel Arama MCP Sunucusu, yapay zeka ajanlarının Workspace öğelerinizde arama yapmasına olanak tanımak için Model Bağlam Protokolü (MCP) standardını kullanır. Bu sunucu, Gmail mesajları, Google Drive dosyaları, Google Takvim etkinlikleri ve Google Sohbet alanları ve mesajları da dahil olmak üzere birden fazla Google Workspace ürününde tek bir araç kullanarak arama yapmanın bir yolunu sunar.

Evrensel Arama MCP Sunucusu, yapay zeka aracılarına, bireysel ürüne özgü araçları çağırmaya gerek kalmadan, tüm Google Workspace hesabınızda bilgi aramak için standartlaştırılmış bir yol sağlar.

Ön koşullar

  • Google Cloud projesi. Proje oluşturmak için Proje oluşturma başlıklı makaleyi inceleyin.

  • Google Antigravity gibi bir MCP istemcisi.

  • Bu sayfadaki komutları çalıştırmak için gcloud CLI'yı aşağıdaki geliştirme ortamlarından birinde ayarlayın:

    Cloud Shell

    gcloud KSA'nın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin:

    Cloud Shell'i etkinleştirin.

    Yerel kabuk

    Yerel bir geliştirme ortamı kullanmak için şu adımları izleyin:

    1. Google Cloud KSA'yı yükleyin. gcloud CLI'yi daha önce yüklediyseniz gcloud components update komutunu çalıştırarak en son sürümü kullandığınızdan emin olun.
    2. Harici bir kimlik sağlayıcı (IdP) kullanıyorsanız birleştirilmiş kimliğinizle gcloud CLI'da oturum açın. Daha fazla bilgi için bkz. Federasyon kimliğinizle gcloud CLI'ye giriş yapın.
    3. gcloud CLI'yı başlatın.

Evrensel Arama MCP sunucusunu yapılandırma

Evrensel Arama MCP Sunucusu'nu kullanmak için Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi bu sunucuya bağlanacak şekilde yapılandırmanız gerekir.

API'leri etkinleştirme

Universal Search MCP Sunucusu'nu kullanmak için Google Cloud projenizde Google Workspace MCP API'yi ve arama yapmak istediğiniz ürünlerin API'lerini etkinleştirin:

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

  • Google Workspace MCP API

KSA

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

PROJECT_ID kısmını Google Cloud proje kimliğinizle değiştirin.

Konsol

Google Cloud Console'da API'leri etkinleştirin:

API'leri etkinleştirme

Evrensel Arama MCP Sunucusu, kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth istemci kimliği oluşturabilmeniz için önce OAuth kullanıcı rızası ekranını yapılandırmanız gerekir.

OAuth kullanıcı rızası ekranını diğer MCP sunucuları için daha önce yapılandırdıysanız Evrensel Arama MCP sunucusu için gerekli kapsamları eklediğinizden emin olun.

Universal Search MCP Sunucusu ile kimlik doğrulaması yaparken, istenen tüm kapsamların veya yalnızca bir alt kümesinin kimlik doğrulamasını yapmayı seçebilirsiniz. Sunucu bu seçimlere uyar ve yalnızca erişim izni verilen ürünlerde arama yapar.

Örneğin, aşağıdaki kapsamların tümüyle kimlik doğrulama yapıyorsanız:

  • 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

Evrensel Arama MCP Sunucusu; Gmail, Google Drive, Google Takvim ve Google Chat'te arama yapar.

Ancak yalnızca https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly ve https://www.googleapis.com/auth/chat.messages.readonly'a erişim izni verirseniz (https://www.googleapis.com/auth/gmail.readonly'ı çıkarırsanız) evrensel arama yalnızca Google Drive, Google Takvim ve Google Chat'teki sonuçları döndürür. E-postanızı aramaz veya Gmail sonuçları döndürmez.

  1. Google Cloud Console'da Google Auth Platform > Data Access'e (Veri Erişimi) gidin.
  2. Kapsam Ekle veya Kaldır'ı tıklayın.

  3. Aşağıdaki kapsamları ekleyin:

    • 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. Güncelle'yi ve ardından Kaydet'i tıklayın.

Onay ekranının kurulumuna ilişkin ayrıntılı talimatlar için bkz. Google Workspace MCP sunucularını yapılandırma.

MCP istemcinizi yapılandırma

Universal Search MCP Sunucusunu MCP istemcinize eklemek için, istemciniz için verilen talimatları izleyin.

Antigravity

Universal Search MCP Sunucusunu Antigravity'ye eklemek için, sunucu yapılandırmasını mcp_config.json dosyanıza ekleyin. Bu talimatlar Antigravity 2.0, Antigravity IDE ve Antigravity CLI'yı destekler.

  1. Web uygulaması türünde bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve ardından URI'ler alanına https://antigravity.google/oauth-callback ekleyin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

  2. Yapılandırma dosyasını açın veya oluşturun ~/.gemini/config/mcp_config.json.

  3. workspace-universal yapılandırmasını mcp_config.json'ye ekleyin:

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

    Aşağıdakini değiştirin:

    • OAUTH_CLIENT_ID: Oluşturduğunuz istemci kimliği.
    • OAUTH_CLIENT_SECRET: Oluşturduğunuz istemci gizli anahtarı.

  4. mcp_config.json tasarruf edin.

  5. MCP sunucusunun kimliğini doğrulayın. Kimlik doğrulama işlemini grafik arayüz ayarlarını veya komut satırı arayüzünü kullanarak gerçekleştirebilirsiniz:

    • Antigravity IDE veya GUI (Antigravity 2.0) için:

      1. Ayarlar ekranınızı açın (ör. sol alttaki Ayarlar'ı tıklayın veya Antigravity Kullanıcı Ayarları'nı açın).
      2. Özelleştirmeler'e gidin.
      3. Yüklü MCP Sunucuları bölümünde Yenile'yi tıklayın.
      4. Listede workspace-universal simgesini bulun, Authenticate'i (Kimlik doğrulama) tıklayın, Google Hesabınızda oturum açın, yetkilendirme kodunu kopyalayın, giriş iletişim kutusuna yapıştırın ve Submit'i (Gönder) tıklayın.

    • Antigravity CLI için:

      1. Antigravity CLI'yı başlatın:

        agy

      2. Aşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:

        /mcp

      3. Ok tuşlarını kullanarak workspace-universal simgesini seçin, Kimlik doğrulama işlemine gidin ve Enter tuşuna basın. Tarayıcınızda oturum açma akışını tamamlayın, yetkilendirme kodunu kopyalayın, terminal istemine yapıştırın ve Enter tuşuna basın.

  6. Sunucunun doğru şekilde yapılandırıldığını ve çalıştığını doğrulayın:

    • Antigravity IDE veya GUI için: Özelleştirmeler > Yüklü MCP Sunucuları altında workspace-universal'nin yanında bir Oturumu Kapat düğmesi görüntülenir.
    • Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek üzere /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucular, etkileşimli TUI panelinde adlarının yanında Authed (Kimliği Doğrulanmış) ifadesini gösterir. Durumunu incelemek ve kullanılabilir tüm araçlarını listelemek için kontrol paneli görünümünde workspace-universal sunucusunu seçebilirsiniz.

Claude

Universal Search MCP sunucusunu Claude'a eklemek için özel bir bağlayıcı yapılandırın.

  1. Web uygulaması türünde bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

  2. Claude ayarlarında özel bağlayıcı ekleyin:

    • Sunucu adı: Universal Search MCP Server
    • Uzak MCP sunucusu URL'si: https://workspacemcp.googleapis.com/mcp/v1
    • OAuth istemci kimliği ve OAuth istemci gizli anahtarı: Kimlik bilgilerinizi girin.
    • Kapsamlar: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly ve https://www.googleapis.com/auth/chat.messages.readonly kapsamlarını dahil edin.

Evrensel Arama MCP Sunucusunu Test Etme

MCP müşterinize farklı ürünlerde arama yapmayı gerektiren sorular sormayı deneyin:

  • "E-postam, dokümanlarım ve sohbet mesajlarımda X projesiyle ilgili her şeyi bul."
  • "Pazarlama planıyla ilgili bir sonraki toplantım ne zaman ve bu toplantıyla ilgili en son notlar ve sohbet mesajları neler?"

Araçlar başarıyla çalışırsa ve birden fazla üründen ilgili yanıtlar alırsanız, Universal Search MCP Sunucunuz doğru yapılandırılmıştır.

Desteklenen araçlar

Universal Search MCP Sunucusu aşağıdaki aracı sunmaktadır:

  • search_corpus: Belirtilen sorguya göre birden fazla Google Workspace ürününde (Google Drive, Gmail, Google Takvim ve Google Chat) arama yapar.