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

Google Workspace için Universal Search MCP Sunucusu, yapay zeka ajanlarının Workspace yapılarınızı aramasına olanak tanımak için Model Context Protocol (MCP) standardını kullanır. Bu sunucu, tek bir araç kullanarak Gmail iletileri, Google Drive dosyaları, Google Takvim etkinlikleri ve Google Chat alanları ile mesajları dahil olmak üzere birden fazla Google Workspace ürününde arama yapma imkanı sunar.

Universal Search MCP sunucusu, yapay zeka ajanlarının ürüne özel araçları ayrı ayrı çağırmasına gerek kalmadan tüm Google Workspace hesabınızda bilgi araması için standart bir yöntem sunar.

Ön koşullar

Evrensel Arama MCP sunucusunu yapılandırma

Universal Search MCP sunucusunu kullanmak için Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi 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 etkinleştirin:

KSA

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

PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.

Konsol

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

API'leri etkinleştirme

Universal Search MCP sunucusu, kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth istemci kimliği oluşturabilmek için 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 zaten yapılandırdıysanız Universal Search MCP sunucusu için gerekli kapsamları eklediğinizden emin olun.

Universal Search MCP sunucusu ile kimlik doğrulaması yaptığınızda, istenen tüm kapsamların veya yalnızca bir alt kümesinin kimliğini doğrulamayı 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ğrulaması yaparsanı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
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.memberships.readonly

Universal Search MCP Server; Gmail, Google Drive, Google Takvim ve Google Chat'te arama yapar.

Ancak https://www.googleapis.com/auth/gmail.readonly kapsamını atlar ve yalnızca 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/chat.spaces.readonly ve https://www.googleapis.com/auth/chat.memberships.readonly kapsamlarına erişim izni verirseniz evrensel arama yalnızca Google Drive, Google Takvim ve Google Chat'ten sonuç döndürür. E-postalarınızda arama yapmaz veya Gmail sonuçlarını döndürmez.

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

  3. Aşağıdaki kapsamlardan birini veya daha fazlasını 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
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly

    Sunucunun her Google Chat görüşmesinde kimlerin olduğunu anlayabilmesi için https://www.googleapis.com/auth/chat.spaces.readonly ve https://www.googleapis.com/auth/chat.memberships.readonly ekleyin. Bu başlıklar olmadan Google Chat sonuçları, harici olarak paylaşılmış gibi değerlendirilir ve kullanıcı onayı gerektirebilir veya filtrelenebilir.

  4. Güncelle'yi ve ardından Kaydet'i tıklayın.

Kullanıcı rızası ekranını ayarlamayla ilgili ayrıntılı talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

MCP istemcinizi yapılandırma

Universal Search MCP sunucusunu MCP istemcinize eklemek için istemcinizle ilgili talimatları uygulayın.

Universal Search MCP sunucusunu çağıran, kullanıcı tarafından yetkilendirilmiş OAuth 2.0 istemci kimliklerinde Google Auth Platform > Clients (İstemciler) bölümünde Use this client for an AI-powered agent (Bu istemciyi yapay zeka destekli bir temsilci için kullan) seçeneği belirlenmiş olmalıdır. Mevcut bir OAuth 2.0 istemci kimliğini güncellemek için Google Auth Platform > İstemciler'de bu ayarı seçin. Bu işlem, OAuth istemcilerini yönetme bölümünde açıklanmıştır. Mevcut bir istemcide bu ayarı değiştiremiyorsanız veya istemci, temsilci olmayan özellikleri de destekliyorsa yapay zeka temsilciniz için yeni bir OAuth 2.0 istemci kimliği oluşturun. Reddedilen istekler, alan genelinde yetki sahibi hizmet hesapları veya Google Apps Komut Dosyası için Sorun giderme bölümüne bakın.

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 URI'ler alanına https://antigravity.google/oauth-callback değerini ekleyin. Yapay zeka destekli bir temsilci için bu istemciyi kullan'ı seçin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

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

  3. workspace-universal yapılandırmasını mcp_config.json uygulamasına 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. GUI ayarlarını veya KSA'yı kullanarak kimlik doğrulaması yapabilirsiniz:

    • 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 öğesini bulun, Authenticate'i (Kimlik doğrula) 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 seçeneğini belirleyin, 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'a 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ı bölümünde workspace-universal simgesinin yanında Oturumu kapat düğmesi gösterilir.
    • Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek için /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucuların adlarının yanında, etkileşimli TUI panelinde Authed (Kimliği Doğrulandı) ifadesi gösterilir. Durumunu incelemek ve mevcut 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 ve Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

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

    • Sunucu adı: Universal Search MCP Server
    • Uzak MCP sunucu URL'si: https://workspacemcp.googleapis.com/mcp/v1
    • OAuth istemci kimliği ve OAuth istemci gizli anahtarı: Kimlik bilgilerinizi girin.
    • Kapsamlar: Şunları 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, https://www.googleapis.com/auth/chat.spaces.readonly ve https://www.googleapis.com/auth/chat.memberships.readonly.

Evrensel Arama MCP sunucusunu test etme

MCP istemcinize farklı ürünlerde arama yapmayı gerektiren sorular sormayı deneyin:

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

Araçlar başarıyla çalıştırılırsa ve birden fazla üründen alakalı yanıtlar alırsanız Universal Search MCP sunucunuz doğru şekilde yapılandırılmış demektir.

Desteklenen araçlar

Universal Search MCP sunucusu aşağıdaki aracı sunar. Giriş ve çıkış şemaları için Universal Search MCP referansına bakın.

  • search_corpus: Sağlanan sorguya göre Drive, Gmail, Takvim ve Chat gibi birden fazla Google Workspace ürününde arama yapar.