Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Google Workspace MCP sunucularını yapılandırma

Google Workspace, yapay zeka ajanlarının Google Workspace verileriyle güvenli bir şekilde etkileşim kurmasını sağlayan uzak Model Context Protocol (MCP) sunucuları sunar. Google Workspace MCP sunucularını yapılandırarak Google Antigravity ve Claude gibi yapay zeka uygulamalarının Gmail, Google Drive, Google Dokümanlar, Google E-Tablolar, Google Slaytlar, Google Takvim, Google Chat ve Google Classroom gibi Google Workspace uygulamalarında işlem yapmasına olanak tanırsınız. Her Google Workspace ürününün kendi özel MCP sunucusu vardır.

Google Workspace MCP sunucuları, yapay zeka ajanlarının aşağıdakileri yapması için standart bir yöntem sunar:

Verileri okuma: E-postaları arama, dosyaları alma ve takvim etkinliklerini listeleme.
Harekete geçin: E-posta taslakları oluşturma, dosya yükleme ve toplantı planlama.
Güvenliğe saygı: Kullanıcıyla aynı izinleri ve veri yönetimi kontrollerini devralır.

Ön koşullar

Google Workspace Geliştirici Önizleme Programı üyeliği
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 aşağıdaki adımları uygulayarak gcloud CLI'yı yerel bir geliştirme ortamında ayarlayın:
1. Google Cloud KSA'yı yükleyin. gcloud CLI'yı daha önce yüklediyseniz gcloud components update komutunu çalıştırarak en yeni sürüme sahip olduğunuzdan 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 Birleştirilmiş kimliğinizle gcloud CLI'da oturum açma başlıklı makaleyi inceleyin.
3. gcloud CLI'yı başlatın.
Google Classroom MCP sunucusunu yapılandırıyorsanız en az bir test öğrenci hesabı içeren bir Google Classroom test sınıfı. Test için kullanabileceğiniz bir Google Classroom sınıfınız yoksa kullanıcı arayüzünde bir sınıf oluşturun ve test öğrencisi ekleyin.

Google Workspace MCP sunucularını yapılandırma

Google Workspace MCP sunucularını kullanmak için bunları Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi bunlara bağlanacak şekilde yapılandırmanız gerekir.

API'leri etkinleştirme

Google Workspace MCP sunucularını kullanmak için Google Cloud projenizde aşağıdaki API'leri etkinleştirmeniz gerekir:

Gmail API
Google Drive API
Google Docs API
Google Sheets API
Google Slides API
Google Calendar API
Google Chat API
People API
Google Classroom API

KSA

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.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

MCP hizmetlerini etkinleştirme

Her Google Workspace ürünü için MCP bileşenlerini etkinleştirmek istiyorsanız Google Cloud projenizde aşağıdaki hizmetleri etkinleştirmeniz gerekir:

Gmail MCP API
Google Drive MCP API
Google Docs MCP API
Google Sheets MCP API
Google Slaytlar MCP API'si
Google Calendar MCP API
Google Chat MCP API
People MCP API
Google Classroom MCP API

KSA

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

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

Konsol

Google Cloud Console'da 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.

Google Cloud Console'da Google Chat API'yi arayın ve Google Chat API > Yönet > Yapılandırma'yı tıklayın.

Google Chat API'ye gidin
Chat uygulamasını ayarlama:
1. Uygulama adı alanına Chat MCP yazın.
2. Avatar URL alanına https://developers.google.com/chat/images/quickstart-app-avatar.png değerini girin.
3. Description (Açıklama) alanına Chat MCP server yazın.
4. İşlevsellik bölümünde, Etkileşimli özellikleri etkinleştir ayarını kapatarak etkileşimli özellikleri devre dışı bırakın.
5. Günlükler bölümünde Hataları Günlük Kaydı'na kaydet'i seçin.
Kaydet'i tıklayın.

Chat uygulaması oluşturma hakkında daha fazla bilgi edinmek için Google Chat uygulaması mimarisi seçme başlıklı makaleyi inceleyin.

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

Google Cloud Console'da Google Auth Platform > Branding'e (Markalama) gidin.

Markalama'ya gidin
Google Auth Platform'u zaten yapılandırdıysanız aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını Markalama, Kitle ve Veri Erişimi'nde yapılandırabilirsiniz. Google Auth Platform not configured yet (Google Auth Platform henüz yapılandırılmadı) mesajını görürseniz Get Started'ı (Başlayın) tıklayın:
1. App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına Workspace MCP Servers yazın.
2. Kullanıcı destek e-postası bölümünde e-posta adresinizi veya uygun bir Google grubunu seçin.
3. İleri'yi tıklayın.
4. Kitle bölümünde Şirket içi'ni seçin. Dahili'yi seçemiyorsanız Harici'yi seçin.
5. İleri'yi tıklayın.
6. İletişim Bilgileri bölümünde, projenizle ilgili değişiklikler hakkında bildirim alabileceğiniz bir E-posta adresi girin.
7. İleri'yi tıklayın.
8. Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
9. Devam'ı tıklayın.
10. Oluştur'u tıklayın.
11. Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
  1. Kitle'yi tıklayın.
  2. Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın.
  3. E-posta adresinizi ve diğer yetkili test kullanıcılarını girip Kaydet'i tıklayın.
Veri Erişimi > Kapsam Ekle veya Kaldır'ı tıklayın. Google Cloud projenizde etkinleştirdiğiniz her API'nin kapsam listesini içeren bir panel görünür.
1. Kapsamları manuel olarak ekleyin bölümünde, kullanmak istediğiniz MCP sunucularının kapsamlarını yapıştırın:
  - Gmail:
    - https://www.googleapis.com/auth/gmail.readonly
    - https://www.googleapis.com/auth/gmail.compose
  - Google Drive:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
  - Google Dokümanlar:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/documents.readonly
    - https://www.googleapis.com/auth/documents
  - Google E-Tablolar:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/spreadsheets.readonly
    - https://www.googleapis.com/auth/spreadsheets
  - Google Slaytlar:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/presentations.readonly
    - https://www.googleapis.com/auth/presentations
  - 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.messages.create
    - https://www.googleapis.com/auth/chat.users.readstate
  - People API:
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Classroom:
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.readonly
2. Tabloya ekle'yi tıklayın.
3. Güncelle'yi tıklayın.
4. Uygulamanız için gereken kapsamları seçtikten sonra Veri Erişimi sayfasında Kaydet'i tıklayın.

MCP istemcinizi yapılandırma

Google Workspace uzak MCP sunucusunu MCP istemcinize eklemek için istemcinizin talimatlarını uygulayın.

Antigravity

Google Workspace uzak MCP sunucularını 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.

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:
1. Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.
  
  İstemci Oluştur'a gidin
2. Uygulama türü olarak Web uygulaması'nı seçin.
3. Bir Ad girin.
4. 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 değerini ekleyin.
5. Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.
6. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerinizi kopyalayın.
~/.gemini/config/mcp_config.json yapılandırma dosyasını açın veya oluşturun.

mcpServers yapılandırmasını mcp_config.json hizmetine ekleyin:

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.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ı.

mcp_config.json tasarruf edin.
MCP sunucularının kimliğini doğrulayın. Kimlik doğrulama için GUI ayarlarını veya CLI'yı kullanabilirsiniz:
- 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. Listelenen her sunucu (gmail, drive, docs, sheets, slides, calendar, chat, people ve classroom) için 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şlatma:
```
agy
```
  2. Aşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:
```
/mcp
```
  3. Her MCP sunucusunun kimliğini doğrulayın:
    1. Ok tuşlarını kullanarak sunucuyu 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'a basın.
    2. Yapılandırdığınız her sunucu (gmail, drive, docs, sheets, slides, calendar, chat, people ve classroom) için bu adımları tekrarlayın.
Sunucuların 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 her sunucunun 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 herhangi bir sunucuyu seçebilirsiniz.

Uzak MCP sunucuları Antigravity'de kullanıma hazır.

Claude

Google Workspace uzaktan MCP sunucularını Claude.ai veya Claude Desktop ile kullanmak için Claude Enterprise, Pro, Max veya Team planınızın olması gerekir.

Google Workspace uzak MCP sunucularını Claude'a eklemek için OAuth istemci kimliği ve gizli anahtarı içeren özel bir bağlayıcı yapılandırın.

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:
1. Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.
  
  İstemci Oluştur'a gidin
2. Uygulama türü olarak Web uygulaması'nı seçin.
3. Bir Ad girin.
4. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve ardından URI'ler alanına https://claude.ai/api/mcp/auth_callback değerini ekleyin.
5. Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.
6. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerinizi kopyalayın.
Claude'da MCP sunucusunu yapılandırın:
1. Claude.ai veya Claude Masaüstü'nde Ayarlar (veya Yönetici ayarları) > Bağlayıcılar'a gidin.
2. Özel bağlayıcı ekle'yi tıklayın.
3. Eklemek istediğiniz Google Workspace ürününün bağlantı ayrıntılarını girin:
  - Sunucu adı: Sunucu için Gmail gibi bir ad.
  - Uzak MCP sunucusu URL'si: Google Workspace ürününün URL'si. Örneğin:
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive: https://drivemcp.googleapis.com/mcp/v1
    - Google Dokümanlar: https://docsmcp.googleapis.com/mcp/v1
    - Google E-Tablolar: https://sheetsmcp.googleapis.com/mcp/v1
    - Google Slaytlar: https://slidesmcp.googleapis.com/mcp/v1
    - Google Takvim: https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat: https://chatmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
    - Google Classroom: https://classroommcp.googleapis.com/mcp/v1
4. Gelişmiş ayarlar'da OAuth istemci kimliğinizi ve OAuth istemci gizli anahtarınızı girin.
5. Ekle'yi tıklayın.
6. Eklemek istediğiniz her Google Workspace ürünü için bu adımları tekrarlayın.

Diğer

Birçok yapay zeka uygulamasında uzak MCP sunucusuna bağlanma yöntemleri bulunur. Genellikle sunucuyla ilgili adı, uç noktaları, aktarım protokolü ve kimlik doğrulama yöntemi gibi bilgileri girmeniz gerekir. Google Workspace uzak MCP sunucuları için aşağıdakileri girin:

Sunucu adı: googleworkspace
Sunucular: Her Google Workspace ürününün kendi sunucu URL'si vardır:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Google Drive: https://drivemcp.googleapis.com/mcp/v1
- Google Dokümanlar: https://docsmcp.googleapis.com/mcp/v1
- Google E-Tablolar: https://sheetsmcp.googleapis.com/mcp/v1
- Google Slaytlar: https://slidesmcp.googleapis.com/mcp/v1
- Google Takvim: https://calendarmcp.googleapis.com/mcp/v1
- Google Chat: https://chatmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
- Google Classroom: https://classroommcp.googleapis.com/mcp/v1
Aktarım: Akış yapılabilir HTTP
Kimlik doğrulama: Google Workspace uzak MCP sunucusu OAuth 2.0 kullanır. OAuth 2.0 istemcinizi oluştururken Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin. Ayrıntılar için Kimlik doğrulama ve yetkilendirme hakkında bilgi başlıklı makaleyi inceleyin.

MCP istemcinizin, kullanıcıların yaklaşık her saatte bir tekrar oturum açmasını önlemek için yenileme jetonuna ihtiyacı var. Google'ın OAuth 2.0 sunucusu, yalnızca yetkilendirme isteği access_type=offline içerdiğinde yenileme jetonu verir. Yalnızca OpenID Connect (OIDC) offline_access kapsamı istendiğinde döndürülmez. MCP istemciniz özel yetkilendirme parametrelerini destekliyorsa yetkilendirme isteğine access_type=offline parametresini ekleyin. Erişim izni vermiş bir kullanıcı için yeni bir yenileme jetonu almak istiyorsanız prompt=consent parametresini de ekleyin. MCP istemciniz özel yetkilendirme parametrelerini desteklemiyorsa kullanıcıların, erişim jetonunun süresi her dolduğunda tekrar oturum açması gerekir. Ayrıntılı bilgi için Erişim jetonunu yenileme başlıklı makaleyi inceleyin.

Farklı istemci türlerini bağlama hakkında daha fazla bilgi için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.

Google Workspace MCP sunucularını test etme

MCP istemcisini yapılandırdıktan sonra bazı test istemleri çalıştırarak bağlantıyı doğrulayabilirsiniz.

MCP istemcinize aşağıdaki soruları sormayı deneyin:

"Ariel, pazarlama planımızla ilgili son e-postasında ne dedi?"

İstemci, gmail.search_threads kullanarak Ariel'den gelen e-postaları filtreler, gmail.get_thread ile en son mesaj dizisinin içeriğini alır ve ardından sizin için özetler.
"ariel@example.com adresine pazarlama planını onayladığımı belirten bir e-posta taslağı oluştur."

İstemci, taslaklar klasörünüzde e-posta oluşturmak için gmail.create_draft kullanır. Bu sayede e-postayı Gmail'den inceleyip gönderebilirsiniz.
"Pazarlama Planı dosyasını özetle."

İstemci, "Pazarlama Planı"nı bulmak için drive.search_files aracını çağırır, ardından içeriğini almak ve özetlemek için drive.read_file_content aracını kullanır.
"Google Dokümanlar'daki toplantı notlarının yapısal içeriğini göster."

İstemci, docs.read_doc kullanarak doküman yapısını ve içeriğini getirir.
"Üç Aylık Satışlar adlı Google E-Tablosu'ndaki Sayfa1 adlı sayfayı oku."

İstemci, sheets.get_values kullanarak kılavuz değerlerini getirir.
"Google Slaytlar'daki Ürün Özeti sunusunun sözlü düzenini göster."

İstemci, slides.read_presentation kullanarak sunu görsel düzen yapılarını getirir.
"Ariel ile bir sonraki toplantım ne zaman?"

Müşteri, calendar.list_events kullanarak programınızı kontrol eder ve Ariel ile yapacağınız bir sonraki toplantının ayrıntılarını verir.
"Google Profilime göre adım ne?"

İstemci, Google Workspace profil bilgilerinizi almak için people.get_user_profile kullanır.
"Şu anda hangi sınıflara ders veriyorum?"

İstemci, classroom.list_course_summaries aracını kullanarak programınızı kontrol eder ve öğretmen rolüne sahip olduğunuz etkin dersleri özetler.
"Jeoloji dersim için yaklaşan arazi gezisiyle ilgili bir duyuru taslağı hazırla."

İstemci, duyuru taslağı oluşturmak için classroom.create_announcement aracını kullanır. Bu taslağı inceleyip Google Classroom uygulamasında yayınlayabilirsiniz.

Araçlar başarıyla çalıştırılır ve alakalı yanıtlar alırsanız Google Workspace MCP sunucularınız doğru şekilde yapılandırılmış demektir.

Sorun giderme

MCP sunucularına bağlanırken sorun yaşarsanız OAuth günlüklerinde hata olup olmadığını kontrol edebilirsiniz. Yöneticinizden güvenlik incelemesi aracındaki OAuth günlüğü etkinliklerini kontrol etmesini isteyin.

MCP sunucularına gönderdiğiniz istekler reddedilirse OAuth 2.0 istemcinizin 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ğinin belirlendiğinden emin olun. Mevcut bir OAuth istemcisinde bu ayarı değiştiremiyorsanız Bu istemciyi yapay zeka destekli bir temsilci için kullan seçeneğini belirleyerek yeni bir OAuth istemcisi oluşturun ve uygulamanızı bu istemciyi kullanacak şekilde güncelleyin. Mevcut bir OAuth istemcisi hem yapay zeka ajanı hem de ajan olmayan özellikler için kullanılıyorsa yapay zeka ajanı için ayrı bir OAuth istemcisi oluşturun ve mevcut istemciyi ajan olmayan özellikleriniz için kullanmaya devam edin. Talimatlar için MCP istemcinizi yapılandırma ve OAuth istemcilerini yönetme başlıklı makaleleri inceleyin.

Uygulamanız alan genelinde yetki içeren bir hizmet hesabı kullanıyorsa hizmet hesapları Google Auth Platform > İstemciler bölümünde yönetilmediğinden bu hesap için Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçemezsiniz. Alan genelinde yetki kullanan hizmet hesaplarından MCP sunucularına gönderilen istekler bu nedenle reddedilmez. Erişim, Google Workspace yöneticinizin yönettiği alan genelinde yetki ayarları tarafından kontrol edilir. Ayrıntılı bilgi için Alan genelinde yetkiyle API erişimini kontrol etme başlıklı makaleyi inceleyin.

MCP sunucularını Google Apps Komut Dosyası'ndan çağırırsanız Apps Komut Dosyası, komut dosyanız için varsayılan bir OAuth istemcisi oluşturur ve yönetir ancak bu istemci için Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçemezsiniz. Bu durum, komut dosyanız standart bir Google Cloud projesi kullansa bile geçerlidir. Bunun yerine aşağıdakileri yapın:

Google Cloud Console'da Google Auth Platform > Clients'a (İstemciler) gidin, bir OAuth istemcisi oluşturun ve Use this client for an AI-powered agent'ı (Bu istemciyi yapay zeka destekli bir temsilci için kullan) seçin.
Komut dosyanızda, kullanıcıları bu OAuth istemcisiyle yetkilendirmek için Apps Komut Dosyası için OAuth2 kitaplığını kullanın.
MCP sunucularını çağırırken ScriptApp.getOAuthToken jetonu yerine kitaplığın döndürdüğü erişim jetonunu gönderin.

MCP sunucularını çağırmayan Apps Komut Dosyası projeleri bu durumdan etkilenmez.

Yaklaşık her saatte bir yeniden oturum açmanız isteniyorsa MCP istemciniz yenileme jetonu almıyor demektir. Google'ın OAuth 2.0 sunucusu, yalnızca yetkilendirme isteği access_type=offline içerdiğinde yenileme jetonu verir. Yalnızca OpenID Connect (OIDC) offline_access kapsamı istenirse kimlik jetonu döndürülmez. MCP istemciniz özel yetkilendirme parametrelerini destekliyorsa yetkilendirme isteğine access_type=offline ekleyin. Daha önce erişim izni vermiş bir kullanıcı için yeni bir yenileme jetonu almak istiyorsanız prompt=consent parametresini de ekleyin. MCP istemciniz özel yetkilendirme parametrelerini desteklemiyorsa erişim jetonunun süresi her dolduğunda tekrar oturum açmanız gerekir. Ayrıntılı bilgi için Erişim jetonunu yenileme başlıklı makaleyi inceleyin.

Desteklenen ürünler

Aşağıdaki Google Workspace ürünleri, Google Workspace MCP sunucularını destekler ve aşağıdaki araçları sunar:

Güvenlikle ilgili önemli bir husus: Dolaylı istem enjeksiyonu

Bir dil modelini güvenilmeyen verilere maruz bıraktığınızda dolaylı istem enjeksiyonu saldırısı riski ortaya çıkar. Google Antigravity gibi MCP istemcileri, Google Workspace MCP sunucuları aracılığıyla güçlü araçlara ve API'lere erişebildiğinden Google Hesabınızdaki verileri okuyabilir, değiştirebilir ve silebilir.

Bu riskleri azaltmak için aşağıdaki en iyi uygulamaları izleyin:

Yalnızca güvenilir araçları kullanın. Google Workspace MCP sunucularını hiçbir zaman güvenilir olmayan veya doğrulanmamış uygulamalara bağlamayın.
Güvenilmeyen girişlere karşı dikkatli olun. MCP istemcinizden doğrulanmamış kaynaklardan gelen e-postaları, dokümanları veya diğer kaynakları işlemesini istemeyin. Bu girişler, oturumunuzu ele geçirebilecek gizli talimatlar içerebilir ve saldırganların verilerinizi değiştirmesine, çalmasına veya silmesine olanak tanıyabilir.
Tüm işlemleri inceleyin. Yapay zeka istemcinizin sizin adınıza gerçekleştirdiği işlemleri her zaman dikkatlice inceleyerek doğru olduklarından ve niyetinizle uyumlu olduklarından emin olun.

Google Workspace MCP sunucularını yapılandırma Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

Google Workspace MCP sunucularını yapılandırma

API'leri etkinleştirme

KSA

Konsol

MCP hizmetlerini etkinleştirme

KSA

Konsol

Chat uygulamasını yapılandırma

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

MCP istemcinizi yapılandırma

Antigravity

Claude

Diğer

Google Workspace MCP sunucularını test etme

Sorun giderme

Desteklenen ürünler

Güvenlikle ilgili önemli bir husus: Dolaylı istem enjeksiyonu

İlgili konular

Google Workspace MCP sunucularını yapılandırma