Geliştirici Bilgisi MCP sunucusuna bağlanma

Google Developer Knowledge MCP sunucusu, yapay zeka destekli geliştirme araçlarının Firebase, Google Cloud, Android, Google Haritalar Platformu ve daha birçok ürün için resmi Google geliştirici belgelerini doğrudan arayıp almasına olanak tanır. Kod yazma desteğinizi Google'ın yetkili doküman kitaplığına bağlayarak manuel web aramalarından, güncel olmayan bağlamlardan ve veri kazımadan kaçınabilirsiniz.

IDE yerine kendi uygulamanızdan veya temsilci kodunuzdan Developer Knowledge MCP sunucusuna bağlanmak için MCP SDK'larını kullanarak bağlanma bölümüne bakın.

MCP sunucusu özellikleri

Google Developer Knowledge MCP sunucusu, yapay zeka kod yazma desteğinize üç temel araç sağlar:

Araç adı	Açıklama
search_documents	Google geliştirici belgelerinde arama yapar ve en alakalı sayfa alıntılarını belge adlarıyla birlikte döndürür.
get_documents	search_documents tarafından döndürülen adları kullanarak dokümanların tam Markdown içeriğini alır.
answer_query	Geliştirici Bilgisi derlemesinden alınan yapılandırılmış yanıtlar oluşturur.

search_documents aracı, sorgunuzla en alakalı bölümleri bulmak için Google'ın dokümanlarında arama yapar. Soru sorduğunuzda araç, kısa metin pasajları döndürür. Aracınızın bir pasajla ilgili tam sayfa bağlamına ihtiyacı varsa tüm sayfayı almak için dokümanın kaynak adını get_documents'ya iletebilir.

Ham arama sonuçları veya tam Markdown dosyaları yerine Geliştirici Bilgi Kitaplığı'ndan alınan bir sorunun doğrudan yanıtını almak istediğinizde answer_query aracını kullanın.

İpucu: Developer Knowledge MCP sunucusunu retrieving-developer-knowledge temsilci becerisiyle eşleyin. Bu beceri, yapay zeka kod yazma desteğinize hangi aracı seçeceği, hataları nasıl ele alacağı ve MCP sunucusu kullanılamıyorsa REST API'yi nasıl çağıracağı konusunda yerleşik talimatlar verir. Daha fazla bilgi edinmek için Use the Developer Knowledge agent skill (Geliştirici Bilgisi aracısı becerisini kullanma) başlıklı makaleyi inceleyin.

Kimlik doğrulama yönteminizi seçin

Developer Knowledge MCP sunucusu, geliştirme ortamınıza ve yapay zeka asistanınıza bağlı olarak iki kimlik doğrulama yaklaşımını destekler:

• API anahtarı: Claude Code, Cursor, GitHub Copilot, Codex ve diğer uzak MCP istemcileri gibi üçüncü taraf IDE'ler ve CLI aracıları için en iyisidir. API anahtarını HTTPS üzerinden X-Goog-Api-Key başlığında iletin.
• OAuth ve ADC: Uygulama Varsayılan Kimlik Bilgileri (ADC) için yerleşik desteğe sahip olan Google Antigravity veya API anahtarı yerine OAuth 2.0 hamiline ait jeton ya da bağımsız OAuth 2.0 istemci kimliği gerektiren kurumsal iş akışları için en iyisidir.

Yapay zeka asistanınızın veya kodlama temsilcinizin, Developer Knowledge MCP sunucu hizmetiyle isteklerin kimliğini doğrulamasına izin vermek için seçtiğiniz kimlik doğrulama yöntemi için gereken kimlik bilgilerini oluşturun.

Kimlik bilgilerinizi oluşturmak için bir sekme seçin:

API anahtarı

Ön koşullar

API anahtarı oluşturmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Google Cloud projesi.
• gcloud CLI'nin yüklü olması (komut satırından yapılandırıyorsanız).

API'yi etkinleştirme ve API anahtarı oluşturma

Google Cloud Console'u veya gcloud CLI'yı kullanarak API anahtarı oluşturabilirsiniz:

Google Cloud Console

1. Google Cloud Console'da Developer Knowledge API sayfasını açın.
2. Google Cloud projenizi seçin ve Etkinleştir'i tıklayın.
3. Kimlik bilgileri sayfasına gidin.
4. Kimlik bilgileri oluştur'u tıklayın ve API anahtarı'nı seçin.
5. Kısıtlamaları yapılandırmak için API anahtarını düzenle işlemini tıklayın:
   • API restrictions (API kısıtlamaları) bölümünde Restrict key'i (Anahtarı kısıtla) seçin.
   • Developer Knowledge API'yi seçin.
   • Bu anahtarı model çağrıları (ör. GEMINI_API_KEY) için de kullanmayı planlıyorsanız Generative Language API'yi de seçin.
6. Kaydet'i tıklayın, ardından API anahtarınızı kopyalayın.

gcloud CLI

1. Projenizde Developer Knowledge API'yi etkinleştirin. PROJECT_ID yerine proje kimliğinizi yazın:

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

2. API anahtarı oluşturma:

   gcloud services api-keys create \
     --project=PROJECT_ID \
     --display-name="DK API Key"
   

   Bu komut, yeni anahtarınızla ilgili meta veri ayrıntılarını döndürür. Komut çıkışından aşağıdaki değerlerin ikisini de kopyalayıp kaydedin:

   • keyString: Bu, ham API anahtarıdır (örneğin, AIzaSy...). Bu değeri IDE yapılandırmanıza yapıştırırsınız.
   • name: Bu, anahtarın kaynak yoludur (örneğin, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Bu yolu, anahtarı sonraki adımda kısıtlamak için kullanacaksınız.

3. Yetkisiz kullanımı önlemek için anahtarı Developer Knowledge API ile kısıtlayın. KEY_NAME yerine önceki adımdan kopyalanan tam name yolunu yazın:

   gcloud services api-keys update KEY_NAME \
     --api-target=service=developerknowledge.googleapis.com
   

   Önemli: Bu anahtarı yapay zeka istemcinizin genel model çağrıları (ör. GEMINI_API_KEY) için kullanmayı planlıyorsanız Generative Language API'ye de izin vermeniz gerekir:

   gcloud services api-keys update KEY_NAME \
     --api-target=service=developerknowledge.googleapis.com \
     --api-target=service=generativelanguage.googleapis.com
   

OAuth ve ADC

Ön koşullar

OAuth veya ADC'yi yapılandırmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Google Cloud projesi.
• gcloud CLI'nın yüklü olması gerekir.

API'yi etkinleştirme

Projenizde Developer Knowledge API'yi etkinleştirmek için aşağıdaki komutu çalıştırın:

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

OAuth kimlik bilgisi türünüzü seçin

Aracınızın gerektirdiği kimlik bilgisi yaklaşımını seçin:

ADC

Google Antigravity, ADC için yerleşik desteğe sahiptir ve yenileme jetonlarını otomatik olarak yeniler. Diğer MCP istemcileri, Authorization üstbilgisinde kısa ömürlü bir hamiline ait jeton ileterek ADC'yi kullanabilir:

1. Google Hesabınızla kimlik doğrulaması yapın ve kota projenizi ayarlayın:

   gcloud auth application-default login \
     --project=PROJECT_ID
   

2. Tarayıcınız açıldığında Google Hesabınızla oturum açın ve istenen izinleri verin.

3. (İsteğe bağlı) Yerleşik ADC desteği olmayan bir üçüncü taraf MCP istemcisi yapılandırıyorsanız istemcinizin Authorization başlığında kullanmak üzere bir hamiline ait jeton (bir saat geçerli) oluşturun:

   gcloud auth application-default print-access-token
   

OAuth istemci kimliği

Google uzak MCP sunucuları, OAuth Dynamic Client Registration (DCR) desteklemediği için yapay zeka asistanınız etkileşimli bir OAuth akışı kullanıyorsa OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun.

1. Markalama sayfasına gidip projenizi seçin. Uygulama adı ve Kullanıcı destek e-postası girip Kaydet'i tıklayın.
2. Kitle sayfasına gidin ve Kullanıcı türü'nü Harici olarak ayarlayın.
3. Aynı sayfada, Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın, Google e-posta adresinizi girin ve Kaydet'i tıklayın.
4. İstemciler sayfasına gidin, İstemci oluştur'u tıklayın ve MCP istemciniz için gereken uygulama türünü seçin:
   • İstemci kimliği ve gizli anahtar isteyen masaüstü istemcileri (ör. VS Code) için Masaüstü uygulaması'nı seçin.
   • Statik OAuth yönlendirme geri çağırmaları gerektiren istemciler (ör. Cursor veya Claude Code özel bağlayıcıları) için Web uygulaması'nı seçin ve istemcinizin yönlendirme URI'sini ekleyin. İstemcinizin belgelediği yönlendirme URI'sini tam olarak kullanın. Özel yönlendirme URI'leri desteklenmez. İstemciye özel yönlendirme URI'leri için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.
5. Create'i (Oluştur) tıklayın, ardından Client ID (İstemci Kimliği) ve Client secret (İstemci gizli anahtarı) bilgilerinizi kopyalayın (veya JSON istemci kimlik bilgileri dosyasını indirin).

OAuth kapsamları

Developer Knowledge MCP sunucusu aşağıdaki OAuth kapsamlarını kabul eder:

• https://www.googleapis.com/auth/cloud-platform: Uygulama Varsayılan Kimlik Bilgileri (ADC) ve gcloud CLI tarafından kullanılan varsayılan kapsam.
• https://www.googleapis.com/auth/devprofiles.full_control: OAuth 2.0 istemci kimliği rıza akışları ve MCP sunucu keşfi için kullanılan kapsam.
• https://www.googleapis.com/auth/developerprofiles.readonly: Son kullanıcı OAuth kullanıcı rızası ekranı gerektirmeyen hizmet hesapları ve kimlik bilgileri için salt okuma kapsamı desteklenir.

IDE'nizi veya kodlama aracınızı yapılandırma

Kimlik bilgilerinizi aldıktan sonra kodlama ortamınızın kurulum talimatlarını uygulayın. Her kodlama ortamıyla ilgili talimatlar aşağıdaki kimlik doğrulama yöntemlerini destekler:

Kodlama ortamı	Kimlik doğrulama yöntemleri
Google Antigravity	Yerleşik Google kimlik bilgileri (ADC) veya API anahtarı
Claude Code, Cursor, GitHub Copilot, Codex	API anahtarı
Diğer	API anahtarı, ADC hamiline ait jeton veya OAuth 2.0 istemci kimliği

Claude Code, Cursor, GitHub Copilot veya Codex ile ADC hamiline ait jeton ya da OAuth 2.0 istemci kimliği kullanmak için Diğer sekmesindeki talimatları uygulayın.

Kullandığınız şablona bağlı olarak aşağıdaki yer tutucuları değiştirin:

• API anahtarı (YOUR_API_KEY): Ham API anahtarı dizenizle değiştirin.
• Proje kimliği (PROJECT_ID): Google Cloud proje kimliğinizle değiştirin.

• Erişim jetonu (ACCESS_TOKEN): gcloud auth application-default print-access-token adresinden aldığınız hamiline ait jetonla değiştirin.

Google Antigravity

Antigravity IDE ve uzantıları

Antigravity IDE'de veya Antigravity uzantısında (ör. VS Code'da) MCP sunucusunu yapılandırmak için kimlik doğrulama yönteminizi seçin:

Google kimlik bilgileri

Tek tıklamayla kurulumu kullanarak MCP sunucusunu yüklemek için:

1. Temsilci panelinde Ek seçenekler () menüsünü tıklayıp MCP Sunucuları'nı seçin.
2. Google Developer Knowledge'ı arayın.
3. Yükle simgesini () tıklayın. Antigravity, sunucuyu otomatik olarak yapılandırır ve etkin Google kimlik bilgilerinizi kullanarak bağlanır.

API anahtarı

Antigravity IDE veya Antigravity uzantısında API anahtarı yapılandırmak için:

1. Temsilci panelinde Ek seçenekler () menüsü > MCP Sunucuları > MCP Sunucularını Yönet > Ham yapılandırmayı görüntüle'yi tıklayın (veya .agents/mcp_config.json dosyasını açın).

2. Aşağıdaki sunucu yapılandırmasını ekleyin:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "serverUrl": "https://developerknowledge.googleapis.com/mcp",
         "headers": {
           "X-Goog-Api-Key": "YOUR_API_KEY"
         }
       }
     }
   }
   

Antigravity CLI

Projenizin .agents/mcp_config.json dosyasında (veya ~/.gemini/config/mcp_config.json içinde genel olarak) MCP sunucusunu yapılandırın:

Google kimlik bilgileri

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

API anahtarı

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

İpucu: Bağımsız Antigravity 2.0 uygulamasını kullanıyorsanız yapılandırmanızı eklemek için Ayarlar > Özelleştirmeler'e gidin ve Yüklü MCP Sunucuları bölümünde MCP Yapılandırmasını Aç'ı tıklayın.

Claude Code

Terminalinizde aşağıdaki komutu çalıştırın:

claude mcp add google-developer-knowledge \
  --transport http https://developerknowledge.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

İmleç

Cursor'ı yapılandırmak için proje kökünüzdeki .cursor/mcp.json dosyasını veya genel erişim için ~/.cursor/mcp.json dosyasını düzenleyin:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

Not: GitHub Copilot yerine VS Code'da Antigravity uzantısını kullanıyorsanız Google Antigravity sekmesini seçin.

Çalışma alanı ayarları

VS Code'da GitHub Copilot'ı belirli bir çalışma alanı için yapılandırmak üzere .vscode/mcp.json oluşturun veya düzenleyin:

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Genel kullanıcı ayarları

Sunucuyu tüm VS Code çalışma alanlarında kullanılabilir hale getirmek için Komut Paleti'ni açın, MCP: Open User Configuration komutunu çalıştırın ve mcp.json dosyanıza kullanıcı profilinizde aşağıdakileri ekleyin:

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Codex

Codex KSA'yı veya Codex aracısını yapılandırmak için sunucu yapılandırmasını ~/.codex/config.toml (veya projenizin .codex/config.toml) dosyasına ekleyin:

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

Not: Yapılandırmayı değiştirdikten sonra sunucu, giriş yapılmadı durumunu gösterebilir. Bu durum normaldir ve erişiminizi etkilemez.

Diğer

Başka bir uzak MCP istemcisini (ör. JetBrains AI Assistant, Windsurf, Cline, Zed, Continue veya Claude Desktop) yapılandırmak ya da üçüncü taraf istemcide ADC hamiline ait jeton veya OAuth 2.0 istemci kimliği kullanmak için kimlik doğrulama yönteminizi seçin:

API anahtarı

Bir HTTP aktarım sunucusunu aşağıdaki ayarlarla yapılandırın:

• Sunucu URL'si: https://developerknowledge.googleapis.com/mcp
• HTTP üstbilgisi: X-Goog-Api-Key: YOUR_API_KEY

Standart JSON yapılandırma şablonu:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

ADC hamiline ait jeton

MCP istemcinizde yerleşik ADC desteği yoksa istek başlıklarında gcloud auth application-default print-access-token'ten gelen hamiline ait jetonu ve Google Cloud proje kimliğinizi ileterek ADC ile kimlik doğrulaması yapabilirsiniz:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

X-Goog-User-Project üstbilgisi için projede serviceusage.services.use izni gerekir. Proje sahipleri ve düzenleyiciler bu izne sahiptir. Diğer kullanıcıların, bu izni içeren bir role (ör. Hizmet Kullanımı Tüketicisi (roles/serviceusage.serviceUsageConsumer)) sahip olması gerekir.

Not: ADC hamiline ait jetonlarının geçerlilik süresi bir saattir. Jetonunuzun süresi dolduğunda yeni bir jeton oluşturmak için gcloud auth application-default print-access-token komutunu tekrar çalıştırın.

OAuth istemci kimliği

Bağımsız bir OAuth 2.0 istemci kimliği ve gizli anahtarı kullanarak kimlik doğrulaması yapmak için:

1. MCP sunucusu uç noktasını, API anahtarı üstbilgisi olmadan istemci yapılandırmanıza ekleyin:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "url": "https://developerknowledge.googleapis.com/mcp"
       }
     }
   }
   

   Not: VS Code, mcpServers yerine üst düzey bir servers anahtarı kullanır. Sunucuyu, çalışma alanınız olarak açtığınız klasördeki .vscode/mcp.json dosyasına ekleyin veya tüm çalışma alanlarında kullanılabilir hale getirmek için Komut Paleti'nden MCP: Open User Configuration (MCP: Kullanıcı Yapılandırmasını Aç) komutunu çalıştırın. VS Code dosya yapısı için GitHub Copilot sekmesine bakın ve headers bölümünü atlayın.

2. Müşteriniz için OAuth kurulumunu tamamlayın:

   • Etkileşimli istem (ör. VS Code): Aracıyı test etmek için bir istem gönderin. Dynamic Client Registration'ın desteklenmediği uyarısı gösterildiğinde devam edin ve İstemci kimliğinizi ve İstemci gizli anahtarınızı girin, ardından Google Hesabınızla oturum açın.
   • Statik OAuth yapılandırması (ör. Cursor veya Claude Code): İstemcinizin OAuth ayarlarında OAuth istemci kimliğinizi, istemci gizli anahtarınızı ve yönlendirme URI'nizi belirtin. İstemciye özel talimatlar için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.

   İstemciniz OAuth kapsamlarını belirtmenizi isterse https://www.googleapis.com/auth/devprofiles.full_control kapsamını kullanın.

Bu yapılandırmada Google Cloud proje kimliği belirtmeniz gerekmez. İstekler, OAuth istemci kimliğinizin sahibi olan projeyle ilişkilendirilir.

Bağlantıyı doğrulama

Yapılandırma tamamlandıktan sonra yapay zeka asistanınızı yeniden başlatın veya MCP sunucularını yeniden yükleyin. Ardından, araç entegrasyonunun çalıştığını doğrulamak için bir test istemi gönderin:

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

Temsilci search_documents veya answer_query aracını çağırıp Google belgelerinden bilgi döndürüyorsa sunucunuz bağlı ve etkindir.

Geliştirici Bilgisi aracısı becerisini kullanma

Asistanınıza, Developer Knowledge MCP sunucusu tarafından sunulan temel araçları ne zaman ve nasıl kullanacağını öğretmek için resmi retrieving-developer-knowledge aracısı becerisini yükleyin.

Temsilci becerisi, yapay zeka kod yazma desteğinizin bir göreve başlamadan önce okuduğu talimatlar dizisidir. retrieving-developer-knowledge becerisi, açık Agent Skills standardını destekleyen tüm asistanlarla çalışır ve asistanınızın aşağıdakileri yapmasına yardımcı olur:

• Doğru aracı seçme: Asistanınıza, genel "nasıl yapılır" soruları ve karşılaştırmalar için answer_query, tam CLI işaretleri, IAM izinleri veya kod söz dizimi ararken ise search_documents (iki ila beş odaklanmış anahtar kelimeyle) kullanması talimatını verir.
• Yanıt vermeden önce hataları kontrol et: Asistanınıza, yanıt yazmadan önce doküman aramasının gerçekten başarılı olduğundan emin olmasını söyler. Böylece, API anahtarı veya kota hatasını eksik doküman olarak algılamaz ya da eski eğitim verilerinden tahmin etmeye geri dönmez.
• REST API'ye geri dönme: Düzenleyiciniz MCP sunucularını desteklemiyorsa veya MCP bağlantısı başarısız olursa asistanınıza Developer Knowledge API'yi doğrudan çağırması için curl komut verir.

Ajan becerisini yükleme

retrieving-developer-knowledge becerisini proje dizininize yüklemek için kod yazma desteğinizi seçin:

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

İmleç

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

Diğer

Açık Agent Skills standardını destekleyen diğer yapay zeka asistanları için şu komutu çalıştırın:

npx skills add google/skills --skill retrieving-developer-knowledge

Yüklü becerilerinizi en yeni sürüme güncellemek için şu komutu çalıştırın:

npx skills update

Beceri talimatlarının ve referans kılavuzlarının tamamını görüntülemek için GitHub'daki retrieving-developer-knowledge dizinine göz atın.

Bağlam penceresini ve jeton kullanımını optimize etme

Belge sayfalarının tamamını yapay zeka modelinin bağlam penceresine almak, önemli miktarda jeton tüketir. Birden fazla büyük dokümanı alma, yüksek jeton maliyetlerine, gecikmenin artmasına ve bağlam penceresinin taşmasına neden olabilir.

Hızlı ve uygun maliyetli yanıtlar almak için aşağıdaki istem mühendisliği en iyi uygulamalarını takip edin:

• Temsilci becerisini yükleyin (önerilir): Asistanınızın doğru arama aracını (answer_query veya search_documents) otomatik olarak seçmesi, kısa anahtar kelime aramaları kullanması ve yalnızca gerektiğinde tam sayfaları indirmesi için retrieving-developer-knowledge temsilci becerisini yükleyin.

• İki adımlı erişimden yararlanın: Temsilcinin search_documents aracını çağırarak başlamasına izin verin. Bu işlev, tüm sayfa için jeton tüketmeden genellikle ihtiyacınız olan tam söz dizimini veya API imzasını içeren odaklanmış snippet'ler (parçalar) döndürür. Ajanınıza, get_documents işlevini yalnızca bağlam kesinlikle gerekli olduğunda kullanmasını söyleyin.

• Kavramsal sorular için answer_query'ı tercih edin: Üretilmiş bir açıklamaya veya tasarım karşılaştırmasına ihtiyacınız olduğunda aracınızı answer_query'ı kullanmaya yönlendirin. Bu araç, ham Markdown sayfalarının tamamını döndürmeden doğrudan Geliştirici Bilgi Tabanı'ndan yanıt oluşturur.

• Spesifik ve kapsamlı istemler yazın: "Firebase'in tamamını açıkla" gibi aşırı geniş kapsamlı istemlerden kaçının. Bunun yerine, hedef ürünü, platformu ve dili belirtin:

  How do I write a Firestore transaction in Dart with error handling?
  

• Özel temsilci kuralları ekleyin: retrieving-developer-knowledge becerisini kullanmıyorsanız otomatik tam sayfa getirme işlemlerini kısıtlamak için asistanınızın talimat dosyalarına (ör. .cursorrules, CLAUDE.md veya .github/copilot-instructions.md) proje düzeyinde yönergeler ekleyin:

  When searching Google developer documentation, inspect search_documents
  snippets first. Do not call get_documents unless the snippet lacks
  necessary code context.
  

İsteğe bağlı güvenlik yapılandırmaları

MCP, MCP araçlarıyla yapabileceğiniz çok çeşitli işlemler nedeniyle yeni güvenlik riskleri ve dikkat edilmesi gereken noktalar ortaya çıkarır. Google Cloud, bu riskleri en aza indirmek ve yönetmek için Google Cloud kuruluşunuzda veya projenizde MCP araçlarının kullanımını kontrol etmenize olanak tanıyan varsayılan ayarlar ve özelleştirilebilir politikalar sunar.

MCP güvenliği ve yönetimi hakkında daha fazla bilgi için Yapay zeka güvenliği ve emniyeti başlıklı makaleyi inceleyin.

Model Armor'ı kullanma

Model Armor, yapay zeka uygulamalarınızın güvenliğini artırmak için tasarlanmış bir Google Cloud hizmetidir. LLM istemlerini ve yanıtlarını proaktif olarak tarayarak çeşitli risklere karşı koruma sağlar ve sorumlu yapay zeka uygulamalarını destekler. Yapay zekayı ister bulut ortamınızda ister harici bulut sağlayıcılarda dağıtın, Model Armor kötü amaçlı girişleri önlemenize, içerik güvenliğini doğrulamanıza, hassas verileri korumanıza, uyumluluğu sürdürmenize ve yapay zeka güvenliği ve güvenlik politikalarınızı çeşitli yapay zeka ortamınızda tutarlı bir şekilde uygulamanıza yardımcı olabilir.

Model Armor, günlük kaydı etkinleştirilmiş şekilde etkinleştirildiğinde tüm yükü günlüğe kaydeder. Bu durum, günlüklerinizdeki hassas bilgilerin açığa çıkmasına neden olabilir.

MCP isteği Model Armor'a yönlendiriliyor

Model Armor, belirli bölgelerde kullanılabilir. Model Armor etkinleştirildiğinde ve Model Armor'un desteklemediği bir yargı alanında MCP sunucusu kullandığınızda, çağrının yönlendirme davranışı farklı MCP sunucularında farklı olabilir ve kullanımda olan ve aktarım halindeki veriler için veri yerleşimi uyumluluğunu bozabilir. Ayrı MCP sunucularının davranışı hakkında daha fazla bilgi için Model Armor destekli ürünler başlıklı makaleyi inceleyin.

Model Armor'ı etkinleştirme

Model Armor'ı etkinleştirmek için Google ve Google Cloud MCP sunucularıyla entegrasyon başlıklı makaledeki adımları uygulayın.

Uzak MCP sunucuları için korumayı yapılandırma

MCP aracı çağrılarınızı ve yanıtlarınızı korumak için Model Armor taban ayarlarını kullanabilirsiniz. Alt sınır ayarı, proje genelinde geçerli olan minimum güvenlik filtrelerini tanımlar. Bu yapılandırma, projedeki tüm MCP aracı çağrılarına ve yanıtlarına tutarlı bir filtre grubu uygular.

İpucu: MCP trafiğiniz doğal dil verileri taşımıyorsa istem enjeksiyonu ve jailbreak filtresini etkinleştirmeyin.

MCP temizleme etkinleştirilmiş bir Model Armor taban ayarı oluşturun. Daha fazla bilgi için Model Armor taban ayarlarını yapılandırma başlıklı makaleyi inceleyin.

Not: Temsilci ve MCP sunucusu farklı projelerdeyse her iki projede de (istemci projesi ve kaynak projesi) kat ayarları oluşturabilirsiniz. Bu durumda Model Armor, her proje için bir kez olmak üzere iki kez çağrılır.

Aşağıdaki örnek komuta bakın:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

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

Aşağıdaki ayarları göz önünde bulundurun:

• INSPECT_AND_BLOCK: Google MCP sunucusundaki içerikleri inceleyen ve filtrelere uyan istemleri ve yanıtları engelleyen yaptırım türü.
• ENABLED: Filtre veya zorunlu kılma özelliğini etkinleştiren ayar.
• MEDIUM_AND_ABOVE: Sorumlu Yapay Zeka - Tehlikeli filtre ayarları için güven düzeyi. Bu ayarı değiştirebilirsiniz ancak daha düşük değerler daha fazla yanlış pozitif sonuç verebilir. Daha fazla bilgi için Model Armor güven düzeyleri başlıklı makaleyi inceleyin.

Model Armor ile MCP trafiğini taramayı devre dışı bırakma

Model Armor'un, projenin kat ayarlarını temel alarak Google MCP sunucularına ve bu sunuculardan gelen trafiği otomatik olarak taramasını durdurmak için aşağıdaki komutu çalıştırın:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

PROJECT_ID yerine Google Cloud proje kimliğini yazın. Model Armor, bu projenin taban ayarlarında tanımlanan kuralları Google MCP sunucu trafiğine otomatik olarak uygulamaz.

Model Armor taban ayarları ve genel yapılandırma, MCP'den daha fazlasını etkileyebilir. Model Armor, Vertex AI gibi hizmetlerle entegre olduğundan taban ayarlarında yaptığınız değişiklikler yalnızca MCP'de değil, tüm entegre hizmetlerde trafik taramayı ve güvenlik davranışlarını etkileyebilir.

Model Armor ayarlarını yapma

Uygulamanızı korumak için Model Armor'u kullanıyorsanız bazı sorgularda 403 PERMISSION_DENIED hatalarıyla karşılaşabilirsiniz. Developer Knowledge MCP sunucusu yalnızca güvenilir Google kaynaklarından herkese açık dokümanlar döndürdüğünden, yanlış pozitifleri azaltmak için istem enjeksiyonu ve jailbreak (PIJB) filtrelerini HIGH_AND_ABOVE güven düzeylerine ayarlamanızı öneririz. Kullanım alanınız özel veya hassas verilere erişen başka araçlar içermiyorsa PIJB filtrelerini devre dışı bırakmayı da düşünebilirsiniz.

Sorun giderme

Developer Knowledge MCP sunucusuna bağlanırken veya sunucuyu sorgularken sorun yaşarsanız aşağıdaki tablolarda belirtinizi veya hata mesajınızı bulun.

Kurulum ve bağlantı hataları

Belirti veya hata	Olası neden	Çözünürlük
/mcp uç noktasında 404 NOT_FOUND	API, projeniz için etkinleştirilmemiş.	Google Cloud Console'da Developer Knowledge API'yi etkinleştirin veya gcloud services enable developerknowledge.googleapis.com komutunu çalıştırın.
403 PERMISSION_DENIED:Developer Knowledge API has not been used	Developer Knowledge API, Google Cloud projesinde etkinleştirilmemiş.	API'yi Google Cloud Console'da etkinleştirin veya gcloud services enable developerknowledge.googleapis.com komutunu çalıştırın.
MCP araçları eksik veya bağlantı başarısız oluyor	Kodlama aracınız, uzak HTTP MCP sunucularını desteklemiyor veya sunucuya bağlanamıyor.	Asistanınıza, MCP araçları kullanılamadığında curl kullanarak Developer Knowledge API REST uç noktalarına nasıl geri döneceğini söyleyen retrieving-developer-knowledge agent becerisini yükleyin.

API anahtarı hataları

Belirti veya hata	Olası neden	Çözünürlük
400 Bad Request: API key not valid	API anahtarı dizesi eksik, geçersiz veya yanlış biçimlendirilmiş.	API anahtarının doğru şekilde kopyalandığını ve headers nesnesinde X-Goog-Api-Key anahtarıyla yapılandırıldığını doğrulayın. API anahtarını URL'de sorgu parametresi olarak iletmeyin.
403 PERMISSION_DENIED: API target restriction	API anahtarı kısıtlama listesi, Developer Knowledge API'yi hariç tutar.	Developer Knowledge API'yi eklemek için Google Cloud Console'daki Kimlik Bilgileri sayfasında API anahtarı kısıtlamalarınızı güncelleyin.

OAuth ve ADC hataları

Belirti veya hata	Olası neden	Çözünürlük
401 UNAUTHENTICATED veya eksik ADC kimlik bilgileri	Uygulama Varsayılan Kimlik Bilgileri veya ADC hamiline ait jetonların süresi dolmuş ya da başlatılmamış.	Yerel kimlik bilgilerini yenilemek için gcloud auth application-default login --project=PROJECT_ID komutunu, yeni bir hamiline ait jeton oluşturmak için gcloud auth application-default print-access-token komutunu çalıştırın.
403 PERMISSION_DENIED:API requires a quota project, which is not set by default	İstek, X-Goog-User-Project başlığı olmadan bir ADC hamiline ait jeton kullanıyor.	MCP istemci yapılandırmanıza Google Cloud proje kimliğinizle birlikte X-Goog-User-Project üstbilgisini ekleyin.
X-Goog-User-Project üstbilgisi içeren 403 PERMISSION_DENIED	Hesabınızda, başlıktaki proje için serviceusage.services.use izni eksik.	Bir proje yöneticisinden size Service Usage Consumer (Hizmet Kullanımı Tüketicisi) rolünü (roles/serviceusage.serviceUsageConsumer) vermesini isteyin.
403 access_denied / "Erişim engellendi: yetkilendirme hatası"	OAuth kullanıcı rızası ekranınız, test modunda Harici kullanıcı türünü kullanıyor ve hesabınız test kullanıcısı olarak listelenmiyor.	Google Cloud Console > Auth Platform > Audience bölümünde, Test kullanıcıları altına etkin Google e-posta adresinizi ekleyin.
OAuth istemci hatası veya geçersiz yönlendirme URI'si	OAuth istemcisi, desteklenmeyen bir uygulama türüyle veya eksik yönlendirme URI'siyle oluşturuldu.	Etkileşimli istemleri olan istemciler (ör. VS Code) için masaüstü uygulamasını, istemcinizin yetkili yönlendirme URI'si (ör. Cursor veya Claude Code) ile web uygulamasını kullanın.

Kota ve güvenlik filtresi hataları

Belirti veya hata	Olası neden	Çözünürlük
429 RESOURCE_EXHAUSTED	Projenizin kota sınırına ulaştınız.	Google Cloud Console'daki Developer Knowledge API kotaları sayfasında kullanımınızı kontrol edin. Sınırlar hakkında bilgi edinmek ve artış isteğinde bulunmak için Developer Knowledge API kotası başlıklı makaleyi inceleyin.
Model Armor ile 403 PERMISSION_DENIED	Model Armor PIJB filtresinin yanlış pozitif sonucu, güvenli bir sorguyu engelledi.	Model Armor şablonu ayarlarınızda PIJB filtresi güvenini HIGH_AND_ABOVE olarak ayarlayın.

Dahil olan belgeler

Sunucu tarafından dizine eklenen Google ürünleri ve doküman depolarının tam listesi için Corpus referansı bölümüne bakın.

Bilinen sınırlamalar

• Yalnızca herkese açık belgeler: Sunucu, yalnızca Corpus referansında listelenen herkese açık belgeleri dizine ekler. Dahili dokümanlar, gizli depolar ve üçüncü taraf kaynaklar dahil edilmez.
• İngilizce: Sunucu, dokümanları yalnızca İngilizce olarak dizine ekler ve döndürür.
• Ağ bağımlılığı ve VPC Hizmet Kontrolleri: Developer Knowledge MCP sunucusu, uzaktan barındırılan bir hizmet olduğundan istemcinizin https://developerknowledge.googleapis.com adresine erişmek için ağ bağlantısı olması gerekir.
  • Google Cloud VPC ağlarında: Genel internet çıkışı gerekli değildir. Trafiği Özel Google Erişimi (private.googleapis.com / 199.36.153.8/30) veya all-apis paketini hedefleyen bir Private Service Connect (PSC) uç noktası kullanarak yönlendirerek developerknowledge.googleapis.com hizmetine harici IP adresleri veya Cloud NAT olmadan özel olarak erişebilirsiniz.
  • VPC Hizmet Kontrolleri (VPC-SC): developerknowledge.googleapis.com Kısıtlanmış VIP (restricted.googleapis.com / 199.36.153.4/30) veya PSC vpc-sc uç noktalarında desteklenmez. VPC'niz *.googleapis.com adresini restricted.googleapis.com adresine yönlendiriyorsa developerknowledge.googleapis.com adresinin private.googleapis.com (199.36.153.8/30) olarak çözümlenmesi için belirli bir Cloud DNS yanıt politikası veya özel DNS kaydı yapılandırın.