Dokümanlar, yapay zeka ajanlarının Dokümanlar verileriyle güvenli bir şekilde etkileşim kurmasına olanak tanıyan uzak bir Model Context Protocol (MCP) sunucusu sunar. Dokümanlar MCP sunucusunu yapılandırarak Google Antigravity ve Claude gibi yapay zeka uygulamalarının Dokümanlar'da işlem yapmasına izin verirsiniz.
Dokümanlar MCP sunucusu, yapay zeka ajanlarının aşağıdaki işlemleri yapması için standart bir yöntem sunar:
- Verileri okuma: Dokümanın yapısal bilgilerini ve metin içeriğini okuma.
- Harekete geçin: Toplu güncellemeleri kullanarak doküman stilini ve yapısını güncelleyin.
- Güvenliğe saygı: Kullanıcıyla aynı izinleri ve veri yönetimi kontrollerini devralır.
Ön koşullar
Google Cloud projesi Proje oluşturmak için Proje oluşturma başlıklı makaleyi inceleyin.
Google Antigravity veya Claude gibi bir yapay zeka uygulaması olan MCP ana makinesi. Yapay zeka uygulaması, her MCP sunucusu için bir MCP istemci bağlantısı oluşturur.
Bu sayfadaki komutları çalıştırmak için gcloud CLI'yı aşağıdaki geliştirme ortamlarından birinde ayarlayın:
Cloud Shell
gcloud CLI'ın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin:
Yerel kabuk
Yerel bir geliştirme ortamı kullanmak için aşağıdaki adımları uygulayın:
- Google Cloud CLI'yı yükleyin.
gcloud CLI'yi daha önce yüklediyseniz
gcloud components updatekomutunu çalıştırarak en son sürüme sahip olduğunuzdan emin olun. - 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.
- gcloud CLI'yı başlatın.
- Google Cloud CLI'yı yükleyin.
gcloud CLI'yi daha önce yüklediyseniz
Dokümanlar MCP sunucusunu yapılandırma
Dokümanlar MCP sunucusunu kullanmak için Google Cloud projenizde etkinleştirin ve yapay zeka uygulamanızı bu sunucuya bağlanacak şekilde yapılandırın.
API'leri etkinleştirme
Docs MCP sunucusunu kullanmak için Google Cloud projenizde aşağıdaki API'yi etkinleştirin:
Google Docs API
KSA
gcloud services enable docs.googleapis.com --project=PROJECT_ID
PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.
Konsol
Google Cloud Console'da API'leri etkinleştirin:
MCP hizmetlerini etkinleştirme
Dokümanlar için MCP bileşenlerini etkinleştirmek istiyorsanız Google Cloud projenizde aşağıdaki hizmeti etkinleştirin:
Docs MCP API
KSA
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.
Konsol
Google Cloud Console'da MCP hizmetlerini etkinleştirin:
OAuth kullanıcı rızası ekranını ayarlama
Dokümanlar 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.
Google Cloud Console'da Google Auth Platform > 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:
- App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına
Docs MCP Serveryazın. - Kullanıcı destek e-postası bölümünde e-posta adresinizi veya uygun bir Google grubunu seçin.
- İleri'yi tıklayın.
- Kitle bölümünde Şirket içi'ni seçin. Dahili'yi seçemiyorsanız Harici'yi seçin.
- İleri'yi tıklayın.
- İletişim Bilgileri bölümünde, projenizle ilgili değişiklikler hakkında bilgilendirilebileceğiniz bir E-posta adresi girin.
- İleri'yi tıklayın.
- 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.
- Devam'ı tıklayın.
- Oluştur'u tıklayın.
- Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
- Kitle'yi tıklayın.
- Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın.
- E-posta adresinizi ve diğer yetkili test kullanıcılarını girip Kaydet'i tıklayın.
- App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına
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.
Kapsamları manuel olarak ekle bölümünde, Dokümanlar MCP sunucusunun kapsamlarını yapıştırın:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
Tabloya ekle'yi tıklayın.
Güncelle'yi tıklayın.
Uygulamanız için gereken kapsamları seçtikten sonra Veri Erişimi sayfasında Kaydet'i tıklayın.
Yapay zeka uygulamanızı yapılandırma
Dokümanlar uzak MCP sunucusunu yapay zeka uygulamanıza eklemek için uygulamanızın talimatlarını uygulayın.
Docs MCP sunucusunu çağıran, kullanıcı tarafından yetkilendirilmiş OAuth 2.0 istemci kimlikleri için 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 > Clients (İstemciler) bölümünde 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
Dokümanlar'ın uzak 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.
OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun:
Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.
Uygulama türü olarak Web uygulaması'nı seçin.
Bir Ad girin.
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-callbackdeğerini ekleyin.Yapay zeka destekli bir temsilci için bu istemciyi kullan'ı seçin.
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.jsonyapılandırma dosyasını açın veya oluşturun.mcpServersyapılandırmasınımcp_config.jsonhizmetine ekleyin:{ "mcpServers": { "docs": { "serverUrl": "https://docsmcp.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.jsontasarruf edin.MCP sunucusunun 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:
- Ayarlar ekranınızı açın (ör. sol alttaki Ayarlar'ı tıklayın veya Antigravity Kullanıcı Ayarları'nı açın).
- Özelleştirmeler'e gidin.
- Yüklü MCP Sunucuları bölümünde Yenile'yi tıklayın.
- Listede
docsuygulamasını bulun, Kimlik doğrula'yı tıklayın, Google Hesabınızda oturum açın, yetkilendirme kodunu kopyalayın, giriş iletişim kutusuna yapıştırın ve Gönder'i tıklayın.
Antigravity CLI için:
Antigravity CLI'yı başlatma:
agyAşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:
/mcpOk tuşlarını kullanarak
docsseç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.
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 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
/mcppanelini 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 sunucusu Antigravity'de kullanıma hazır.
Claude
Dokümanlar uzak MCP sunucusunu Claude.ai veya Claude Masaüstü ile kullanmak için Claude Enterprise, Pro, Max veya Team planınız olmalıdır.
Dokümanlar'ın uzak MCP sunucusunu 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:
Google Cloud Console'da Google Auth Platform > Clients (İstemciler) > Create Client'a (İstemci Oluştur) gidin.
Uygulama türü olarak Web uygulaması'nı seçin.
Bir Ad girin.
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_callbackdeğerini ekleyin.Yapay zeka destekli bir temsilci için bu istemciyi kullan'ı seçin.
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:
- Claude.ai veya Claude Masaüstü'nde Ayarlar > Bağlayıcılar veya Yönetici ayarları > Bağlayıcılar'a gidin.
- Özel bağlayıcı ekle'yi tıklayın.
- Dokümanlar ürünü için bağlantı ayrıntılarını girin:
- Sunucu adı:
Docs. - Uzak MCP sunucusu URL'si:
https://docsmcp.googleapis.com/mcp/v1
- Sunucu adı:
- Gelişmiş ayarlar'da OAuth istemci kimliğinizi ve OAuth istemci gizli anahtarınızı girin.
- Ekle'yi tıklayın.
Diğer
Birçok yapay zeka uygulamasında uzak MCP sunucusuna bağlanma yöntemleri vardır. Genellikle sunucuyla ilgili adı, uç noktaları, aktarım protokolü ve kimlik doğrulama yöntemi gibi bilgileri girmeniz gerekir. Dokümanlar'ın uzak MCP sunucusu için aşağıdakileri girin:
Sunucu adı:
docsSunucu URL'si:
https://docsmcp.googleapis.com/mcp/v1Aktarım: Akış yapılabilir HTTP
Kimlik doğrulama: Dokümanlar'ın 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.
Web uygulaması OAuth istemcisiyle saatlik oturum açma istemlerini önlemek için MCP istemcinizi
access_type=offlineveyaoffline_accesskapsamını kullanarak çevrimdışı erişim isteyecek şekilde yapılandırın. Ayrıntılar için Saatlik oturum açma istemlerinin tekrarlanması başlıklı makaleyi inceleyin.
Farklı yapay zeka uygulaması 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.
Dokümanlar MCP sunucusunu test etme
Yapay zeka uygulamanızı yapılandırdıktan sonra bazı test istemleri çalıştırarak bağlantıyı doğrulayabilirsiniz.
Yapay zeka uygulamanıza aşağıdaki soruları sormayı deneyin:
"Bana
abcd123adlı Google Dokümanı'nın yapısal içeriğini göster."İstemci,
docs.read_dockullanarak doküman yapısını ve içeriğini getirir."
abcd123adlı Google Dokümanı'na 'Pazarlama Planım' başlığını ekle."İstemci, yapısal öğeleri güncellemek ve metin eklemek için
docs.update_docişlemini gerçekleştirir.
Araçlar başarıyla çalıştırılır ve alakalı yanıtlar alırsanız Dokümanlar MCP sunucunuz doğru şekilde yapılandırılmış demektir.
Sorun giderme
Dokümanlar MCP sunucusuyla ilgili yaygın kimlik doğrulama ve bağlantı sorunlarını çözmek için aşağıdaki bölümleri kullanın.
OAuth günlüğü etkinliklerini kontrol etme
MCP sunucusuna bağlanırken sorun yaşarsanız OAuth günlüklerinde hata olup olmadığını kontrol edin. Google Workspace yöneticinizden güvenlik incelemesi aracındaki OAuth günlüğü etkinliklerini incelemesini isteyin.
Kullanıcı tarafından yetkilendirilmiş OAuth istemcilerinden gelen reddedilen istekler
MCP sunucusuna gönderdiğiniz istekler reddedilirse 3 aşamalı OAuth akışınız için kullanıcı tarafından yetkilendirilmiş OAuth 2.0 istemci kimliğinde, Google Auth Platform > İstemciler bölümünde Bu istemciyi yapay zeka destekli bir temsilci için kullan'ın seçili olduğunu doğrulayın:
- Mevcut istemci ayarı destekliyorsa: Mevcut OAuth istemcinizde Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin.
- Mevcut istemci güncellenemiyor: Bu istemciyi yapay zeka destekli bir temsilci için kullan seçeneği belirlenmiş yeni bir OAuth istemcisi oluşturun ve uygulamanızı bu istemciyi kullanacak şekilde güncelleyin.
- Mevcut istemci, temsilci olmayan özellikleri de destekliyor: Yapay zeka ajanı için ayrı bir OAuth istemcisi oluşturun ve mevcut istemciyi temsilci olmayan özellikleriniz için kullanın.
Talimatlar için Yapay zeka uygulamanızı yapılandırma ve OAuth istemcilerini yönetme başlıklı makaleleri inceleyin.
Alan genelinde yetki sahibi hizmet hesapları
Uygulamanız, 2 aşamalı OAuth için alan genelinde yetki içeren bir hizmet hesabı kullanıyorsa Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçemezsiniz. Bunun nedeni, hizmet hesaplarının Google Auth Platform > İstemciler'de yönetilmemesidir:
- Erişim denetimi: Bu hizmet hesaplarından MCP sunucusuna gönderilen istekler, temsilci ayarı eksik olduğu için reddedilmez. Bunun yerine erişim, Google Workspace yöneticinizin yönettiği alan genelinde yetki ayarları tarafından yönetilir. Yönetici ayarlarıyla ilgili ayrıntılar için Alan genelinde yetkiyle API erişimini kontrol etme başlıklı makaleyi inceleyin.
- Hassas işlemler: Google Workspace MCP sunucuları, alan genelinde yetki kullanıcı kimliğine bürünme yoluyla yapılan hassas araç çağrılarında insan müdahalesi gerektiren onay için form istemleri döndürmeye devam eder.
Apps Komut Dosyası'ndan gelen istekler
MCP sunucusunu Apps Komut Dosyası'ndan çağırırsanız Apps Komut Dosyası'nın komut dosyanız için oluşturup yönettiği varsayılan OAuth istemcisinde 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.
MCP sunucusunu Apps Komut Dosyası'ndan çağırmak için 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 sunucusunu çağırırken
ScriptApp.getOAuthTokenjetonu yerine kitaplığın döndürdüğü erişim jetonunu gönderin.
Google Workspace MCP sunucularını çağırmayan Apps Komut Dosyası projeleri etkilenmez.
Saatlik oturum açma istemlerinin tekrarlanması
Yaklaşık her saatte bir yeniden oturum açmanız isteniyorsa MCP istemciniz yenileme jetonu almıyor veya kullanmıyor demektir. Bu durum genellikle aşağıdaki durumlarda ortaya çıkar:
- Web uygulaması OAuth istemcisinde çevrimdışı erişim eksik: Masaüstü uygulaması OAuth istemcilerinin aksine, Web uygulaması OAuth istemcileri varsayılan olarak çevrimiçi erişime sahiptir. Yenileme jetonu istemek için
access_type=offlineparametresini ekleyin veya en az bir API kapsamıyla birlikte OpenID Connect (OIDC)offline_accesskapsamını ekleyin veaccess_type=onlineparametresini ayarlamayın. - Daha önce izin verilmiş bir uygulamayı yeniden yetkilendirme: Google'ın OAuth 2.0 sunucusu, kullanıcı çevrimdışı erişim izni verdiğinde ilk kez bir yenileme jetonu yayınlar. Bir kullanıcı, OAuth istemcinizi çevrimdışı erişim olmadan yetkilendirdiyse veya MCP istemciniz depolanan yenileme jetonunu kaybettiyse sonraki oturum açma işlemlerinde yeni bir yenileme jetonu döndürülmeyebilir. Yetkilendirme isteğine
prompt=consentkapsamını ekleyin veya Google Hesabı bağlantıları'nda uygulamanın erişimini kaldırıp tekrar oturum açın. - Statik hamiline ait jeton:
Authorizationbaşlığında ham erişim jetonu (ör.gcloud auth print-access-tokençıkışı) iletirseniz istemciniz yenilemediği sürece jetonun süresi bir saat sonra dolar.
Ayrıntılı bilgi için Erişim jetonunu yenileme başlıklı makaleyi inceleyin.
Araç referansı
Dokümanlar MCP sunucusu için aşağıdaki araçlar kullanılabilir. Giriş ve çıkış şemaları için Dokümanlar MCP referansına bakın:
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 vardır. Google Antigravity gibi yapay zeka uygulamaları, Dokümanlar MCP sunucusu üzerinden güçlü araçlara ve API'lere erişebildiği için Google Hesabınızdaki verileri okuyabilir, değiştirebilir ve silebilir.
Bu riskleri azaltmak için istemleri ve yanıtları kötü amaçlı içerik veya istem enjeksiyonu saldırılarına karşı taramanız gerekir. Google tarafından sağlanan Model Armor'ı kullanabilir veya kullanıcıların bu riski kabul edebilmesi için belgelediğiniz kendi çözümünüzü kullanabilirsiniz. Talimatlar için Google Workspace MCP sunucuları için güvenliği yapılandırma başlıklı makaleyi inceleyin.
Aşağıdaki en iyi uygulamaları izleyin:
- Yalnızca güvenilir araçları kullanın. Dokümanlar MCP sunucusunu hiçbir zaman güvenilmeyen veya doğrulanmamış uygulamalara bağlamayın.
- Güvenilmeyen girişlere karşı dikkatli olun. Yapay zeka uygulamanızdan, doğrulanmamış kaynaklardan gelen dokümanları veya diğer kaynakları işlemesini istemeyin. Bu girişler, oturumunuzu ele geçirebilecek ve saldırganın verilerinizi değiştirmesine, çalmasına veya silmesine olanak tanıyacak gizli talimatlar içerebilir.
- Tüm işlemleri inceleyin. Yapay zeka uygulamanızın sizin adınıza gerçekleştirdiği işlemleri her zaman dikkatlice inceleyerek doğru olduklarından ve niyetinizle eşleştiğinden emin olun.