Google Workspace MCP ve Gemini KSA'yı kullanmaya başlama

1. Giriş

Not: Gemini KSA'yı kullanmaya devam ediyor musunuz? Google Workspace MCP sunucularını Antigravity CLI ile ayarlama hakkında bilgi edinmek için bu codelab'e göz atın. Geçişle ilgili daha fazla bilgiyi bu resmi blog yayınında bulabilirsiniz.

Bu codelab'de, Gemini CLI'yı Google Workspace verilerinize bağlamak için Model Context Protocol'ü (MCP) nasıl kullanacağınızı öğreneceksiniz. MCP, yapay zeka modellerinin uzak sunucular tarafından sağlanan araçları güvenli bir şekilde kullanmasını sağlayan açık bir standarttır. Gmail, Google Drive, Google Takvim, Google Chat ve People API ile etkileşim kurmak için istemci olarak Gemini CLI'yı kullanacaksınız. Üstelik kod yazmanız gerekmeyecek.

Yapacaklarınız

• Google Cloud projenizde Google Workspace MCP hizmetlerini etkinleştirin.
• Gemini CLI'yı bu MCP hizmetlerini kullanacak şekilde yapılandırın.
• Google Workspace verilerinizle etkileşim kuran eğlenceli ve faydalı istemlerle entegrasyonu test edin.

İhtiyacınız olanlar

• Chrome gibi bir web tarayıcısı
• Google Cloud projesi
• Google Workspace hesabı
• Yerel makinenizde Gemini CLI yüklü olmalıdır.

Bu codelab'in tamamlanması yaklaşık 30 dakika sürer.

Bu codelab'e kolay erişim

2. Başlamadan önce

Google Workspace Geliştirici Önizleme Programı: Google Workspace MCP sunucularına erişim, Herkese Açık Geliştirici Önizleme Programı'nın bir parçasıdır. Henüz kaydolmadıysanız lütfen https://developers.google.com/workspace/preview adresinden kaydolun ve hesabınızın programa kabul edildiğinden emin olun.

Google Cloud projesi oluşturma veya seçme

Google Cloud Console'da bir Google Cloud projesi seçin veya oluşturun.

API'leri etkinleştirme

Google Workspace MCP sunucularını kullanmak için standart Google Workspace API'lerini etkinleştirmeniz gerekir. Bazı MCP sunucuları bağımsız olarak çalışırken diğerleri temel standart API'nin etkinleştirilmesini gerektirir:

• Gmail ve Chat için standart API'leri gerekir.
• Drive, belirli araçlar için standart API'yi gerektirir.
• Takvim'de standart API'nin etkinleştirilmesi gerekmez.
• People API hem standart erişimi hem de MCP işlevini yönettiğinden etkinleştirilecek ayrı bir MCP hizmeti yoktur.

API'leri etkinleştirme

MCP hizmetlerini etkinleştirme

Ardından, ürünler için özel MCP hizmetlerini etkinleştirin.

MCP hizmetlerini etkinleştirme

Chat uygulamasını yapılandırma

Google Chat MCP sunucusunu kullanmak için Google Cloud projenizde bir Chat uygulaması yapılandırmanız gerekir.

1. Google Cloud konsolunda Google Chat API'yi arayın ve Google Chat API > Yönet > Yapılandırma'yı tıklayın.Google Chat API'ye gidin
2. Chat uygulamasını ayarlayın:
   • Uygulama adı alanına Chat MCP yazın.
   • Avatar URL (Avatar URL'si) alanına https://developers.google.com/chat/images/quickstart-app-avatar.png değerini girin.
   • Description (Açıklama) alanına Chat MCP server yazın.
   • İşlevsellik bölümünde Etkileşimli özellikleri etkinleştir'i kapatın.
   • Günlükler bölümünde Hataları Günlük Kaydı'na kaydet'i seçin.
3. Kaydet'i tıklayın.

3. OAuth kullanıcı rızası ve istemcisini yapılandırma

Google Workspace MCP sunucuları, güvenli kimlik doğrulama için OAuth 2.0 kullanır. OAuth kullanıcı rızası ekranı yapılandırmanız ve masaüstü uygulama istemcisi oluşturmanız gerekir.

OAuth kullanıcı rızası ekranını ayarlama

Google Workspace MCP sunucuları, kimlik doğrulama için OAuth 2.0'ı kullanır. Önce kullanıcı rızası ekranını yapılandırmanız gerekir.

1. Google Cloud Console'da Google Auth Platform > Branding'e (Markalama) gidin. Yapılandırılmamışsa Başlayın'ı tıklayın.
2. Uygulama Bilgileri'ni yapılandırın:
   • Uygulama adı: Google Workspace MCP Servers
   • Kullanıcı desteği e-postası: E-posta adresinizi seçin.
3. Kitle'yi yapılandırın: Dahili'yi (veya Dahili seçeneği kullanılamıyorsa Harici'yi) seçin.
4. İletişim Bilgileri'ni yapılandırın: E-posta adresinizi girin.
5. Kullanıcı Verileri Politikası'nı inceleyip kabul edin, ardından Oluştur'u tıklayın.
6. Harici'yi seçtiyseniz Kitle'ye gidin ve Test kullanıcıları bölümüne e-posta adresinizi ekleyin.
7. Veri Erişimi > Kapsam Ekle veya Kaldır'a gidin. Kapsamları manuel olarak ekleyin bölümünde, kullanmak istediğiniz sunucular için aşağıdakileri ekleyin:
   • Google Takvim: 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
8. Tabloya ekle'yi, ardından Güncelle'yi ve son olarak Kaydet'i tıklayın.

OAuth istemci kimliği oluşturma

Google Workspace MCP sunucuları için OAuth 2.0 istemcisi yapılandırırken Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçerek temsilci sınıflandırma ayarını (is_agentic) etkinleştirmeniz gerekir. Bu ayarın etkinleştirilmediği OAuth istemcilerinin Google Workspace MCP uç noktalarını çağırması engellenir.

1. Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) (veya APIs & Services (API'ler ve Hizmetler) > Credentials (Kimlik Bilgileri) > Create Credentials (Kimlik Bilgileri Oluştur) > OAuth client ID'ye (OAuth istemci kimliği)) gidin.
2. Uygulama türü olarak Masaüstü uygulaması'nı seçin.
3. Gemini CLI olarak adlandırın.
4. OAuth istemcisinde is_agentic sınıflandırma işaretini etkinleştirmek için Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.
5. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerini kopyalayın. Bir sonraki adımda bunlara ihtiyacınız olacak.

4. Gemini CLI'yı yapılandırma

Şimdi Gemini KSA'yı bu uç noktaları kullanacak şekilde yapılandıralım. Gemini CLI yüklü değilse Gemini CLI web sitesindeki yükleme talimatlarını uygulayın.

Yerel Ortam Gerekli: Bu adım için Cloud Shell'i kullanmayın. Gemini CLI, OAuth kimlik doğrulaması için yerel bir tarayıcı gerektirir. Lütfen yerel makinenizin terminalini kullanın. Daha fazla bilgi için Tarayıcı yönlendirme koşulları'na bakın.

Yapılandırma dosyasını oluşturma

Ana dizininizde ~/.gemini/settings.json dosyasını açın veya oluşturun ve aşağıdaki yapılandırmayı ekleyin. Yer tutucuları OAuth kimlik bilgilerinizle değiştirin.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. MCP sunucularının kimliğini doğrulama

MCP sunucularını kullanabilmek için kimliklerini doğrulamanız ve bağlı olduklarını onaylamanız gerekir.

Gemini KSA'yı başlatma

Gemini KSA'yı başlatmak için terminalinizde aşağıdaki komutu çalıştırın:

gemini

Kimliği doğrula

Gemini CLI'da ilgili komutu çalıştırarak test etmek istediğiniz hizmetlerle kimlik doğrulaması yapın. Yalnızca bu codelab'de kullanmayı planladığınız hizmetlerle kimlik doğrulaması yapmanız gerekir.

Takvim

/mcp auth calendar

Sohbet

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Kişiler

/mcp auth people

Her bir hizmeti yetkilendirmek için tarayıcınızdaki talimatları uygulayın.

Bağlantıyı Doğrula

Araçların yüklendiğini ve hazır olduğunu doğrulayın:

/mcp list

Hizmetlerin Ready olduğunu ve araçlarının listelendiğini gösteren bir çıkış görürsünüz.

6. MCP sunucularını test etme

Artık doğal dili kullanarak Google Workspace verilerinizle etkileşim kurabilirsiniz. Her hizmet için bazı istem örnekleri aşağıda verilmiştir.

Not: Aşağıdaki istemlerde köşeli parantez içindeki yer tutucuları (ör. [NAME], [FILE_NAME]) kendi Google Workspace verilerinizdeki gerçek değerlerle değiştirin.

Google Takvim

Gemini'a programınızla ilgili sorular sormayı deneyin:

• "Bu hafta yaklaşan toplantılarım neler?"
• "Yarın öğleden sonra boş vaktim var mı?"

Google Chat

Gemini'dan mesajları aramasını isteyebilirsiniz:

• "'[SPACE_NAME]' alanında '[KEYWORD]' ifadesini içeren mesajları ara"

Google Drive

Gemini'dan dosyaları bulmasını veya okumasını isteyin:

• "Google Drive'ımda '[ANAHTAR_KELİME]' ifadesini içeren dosyaları ara."
• "Düzenlediğim en son dokümanları listele."
• "[DOSYA_ADI]' dokümanımın içeriğini oku ve ana hedefleri özetle."

Gmail

Gemini'dan e-postalarınızı aramasını veya yönetmesini isteyebilirsiniz:

• "Aldığım son 5 e-postayı özetle."
• "[EMAIL_ADDRESS] adresine '[PROJECT_NAME]' projesiyle ilgili güncelleme isteyen bir e-posta taslağı oluştur."

People API

Gemini'a profiliniz veya kişileriniz hakkında soru sormayı deneyin:

• "Google profilime göre adım ne?"
• "[AD] için iletişim bilgilerini bul."

Birden Fazla Hizmeti Birleştirme

MCP'nin gerçek gücü, Gemini'ın birden fazla hizmette görevleri yönetmesiyle ortaya çıkar. Hizmetler arası özellikleri gösteren şu istemleri deneyin:

• "Drive'da '[PROJE_ADI] ara hedef güncellemeleri' ile ilgili dosyaları ara, içeriklerini özetle, '[AD]' adlı kişinin e-posta adresini bul ve bu kişiye özeti içeren bir Gmail taslağı oluştur."

Diğer araçları keşfedin

Bunlar, yapabileceklerinizden yalnızca birkaçıdır. Her hizmet için kullanılabilen araçların tam listesini görmek ve bunları denemek için resmi belgelerin Desteklenen Ürünler bölümüne bakın.

7. Temizleme

Projenizi silmeden temizlemek için etkinleştirdiğiniz API'leri ve MCP hizmetlerini devre dışı bırakabilirsiniz:

1. Google Cloud Console'da API ve Hizmetler Kontrol Paneli'ne gidin.
2. Etkinleştirdiğiniz Google Workspace ve MCP API'lerinin (ör. Takvim MCP, Chat MCP) her birini tıklayın ve API'yi devre dışı bırak'ı seçin.

Artık kullanmayı planlamıyorsanız Google Auth Platform konsolundaki OAuth istemci kimlik bilgilerini silin.

8. Tebrikler

Tebrikler! Gemini CLI'yı kullanarak resmi Google Workspace MCP sunucularını başarıyla yapılandırıp test ettiniz.

Öğrendikleriniz

• Google Cloud'da Google Workspace MCP hizmetlerini etkinleştirme
• MCP için OAuth istemcisi yapılandırma
• Standart araçları kullanarak Google Workspace verileriyle etkileşim kurmak için Gemini CLI'ı kullanma

Referans belgeler

• Model Context Protocol'e (MCP) giriş
• Google Workspace MCP sunucularını yapılandırma
• OAuth kullanıcı rızasını yapılandırma