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

1. Giriş

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 kod yazmadan etkileşim kurmak için istemciniz olarak Gemini CLI'yı kullanacaksınız.

Yapacaklarınız

• Google Cloud projenizde Google Workspace MCP hizmetlerini etkinleştirin.
• Bu MCP hizmetlerini kullanmak için Gemini CLI'yı 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 makinenize Gemini KSA'nın yüklenmiş olması

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

Bu codelab'e kolayca erişebilirsiniz.

2. Başlamadan önce

Google Workspace Geliştirici Önizlemesi Programı: Google Workspace MCP sunucularına erişim, herkese açık Geliştirici Önizlemesi Programı'nın bir parçasıdır. Henüz yapmadı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ışsa da diğerleri için temel standart API'nin etkinleştirilmesi gerekir:

• Gmail ve Chat için standart API'ler gereklidir.
• Drive, belirli araçlar için standart API'yi gerektirir.
• Takvim'in standart API'nin etkinleştirilmesini gerektirmez.
• 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 git
2. Chat uygulamasını kurun:
   • Uygulama adı alanına Chat MCP girin.
   • Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
   • Açıklama bölümüne Chat MCP server girin.
   • İşlevsellik bölümünde, Etkileşimli özellikleri etkinleştir seçeneğini devre dışı bırakarak etkileşimli özellikleri kapatın.
   • Günlükler bölümünde Günlük hatalarını Logging'e seçeneğini belirleyin.
3. Kaydet'i tıklayın.

3. OAuth iznini ve istemcisini yapılandırma

Google Workspace MCP sunucuları, güvenli kimlik doğrulama için OAuth 2.0'ı kullanır. Bir OAuth kullanıcı rızası ekranı yapılandırmanız ve bir masaüstü uygulaması 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. Öncelikle kullanıcı rızası ekranını yapılandırmanız gerekir.

1. Google Cloud Console'da Google Auth Platform > Markalama'ya 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ı destek e-postası: E-postanızı seçin.
3. Kitle'yi yapılandırın: Dahili'yi (veya Dahili kullanılamıyorsa Harici'yi) seçin.
4. İletişim bilgilerini 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 Ekleme veya Kaldırma'ya gidin. Kapsamları manuel olarak ekleme 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

1. Google Auth Platform > Clients > Create Client'a (İstemci Oluştur) gidin.
2. Uygulama türü olarak Masaüstü uygulaması'nı seçin.
3. Gemini CLI olarak adlandırın.
4. Oluştur'u tıklayın ve İstemci Kimliği ile İstemci Gizli Anahtarı'nı kopyalayın. Bu bilgilere bir sonraki adımda ihtiyacınız olacak.

4. Gemini KSA'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ı bölümüne 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 ve 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 KSA'da ilgili komutu çalıştırarak test etmek istediğiniz hizmetlerin kimliğini doğrulayın. Yalnızca bu codelab'de kullanmayı planladığınız hizmetlerle kimliğinizi doğrulamanız gerekir.

Takvim

/mcp auth calendar

Sohbet

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Kişiler

/mcp auth people

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

Bağlantıyı doğrulama

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

/mcp list

Araçlarının listelendiği hizmetlerin Ready olduğunu belirten bir çıktı görmeniz gerekir.

6. MCP sunucularını test etme

Artık doğal dil kullanarak Google Workspace verilerinizle etkileşim kurabilirsiniz. Her hizmet için bazı örnek istemleri aşağıda bulabilirsiniz.

Not: Aşağıdaki istemlerdeki 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 soru sorun:

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

Google Chat

Gemini'dan mesaj aramasını isteyebilirsiniz:

• "Look for messages containing ‘[KEYWORD]' in ‘[SPACE_NAME]'" ([SPACE_NAME] alanında "[KEYWORD]" anahtar kelimesini içeren mesajları ara)

Google Drive

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

• "Google Drive'ımda "[ANAHTAR KELİME]" kelimesini içeren dosyaları ara."
• "Düzenlediğim en son belgeleri listele."
• "[FILE_NAME] adlı 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 isteğinde bulunan 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?"
• "Find contact info for ‘[NAME]'." ([AD] için iletişim bilgilerini bul.)

Birden Fazla Hizmeti Birleştirme

MCP'nin gerçek gücü, Gemini'ın birden fazla hizmetteki görevleri düzenlediğinde ortaya çıkar. Hizmetler arası özellikleri gösteren aşağıdaki istemleri deneyin:

• "Drive'da "[PROJECT_NAME] dönüm noktası güncellemeleri" ile ilgili dosyaları ara, içeriklerini özetle, "[NAME]" adlı kişinin e-posta adresini bul ve özetle ilgili bir Gmail taslağı oluşturup bu kişiye gönder."

Diğer Araçları Keşfedin

Bunlar, yapabileceklerinizden yalnızca birkaç örnektir. 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 her birini (ör. Takvim MCP, Chat MCP) ve API'yi devre dışı bırak'ı tıklayın.

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ırdınız ve test ettiniz.

Öğrendikleriniz

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

Referans belgeleri

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