Terhubung ke server MCP Pengetahuan Developer

Server MCP Google Developer Knowledge memberi alat pengembangan berteknologi AI akses langsung untuk menelusuri dan mengambil dokumentasi developer Google resmi untuk produk seperti Firebase, Google Cloud, Android, Google Maps Platform, dan lainnya. Dengan menghubungkan asisten coding Anda ke library dokumentasi resmi Google, Anda tidak perlu melakukan penelusuran web secara manual, menggunakan konteks yang sudah tidak berlaku, dan melakukan scraping.

Untuk terhubung ke server MCP Developer Knowledge dari kode agen atau aplikasi Anda sendiri, bukan dari IDE, lihat Menghubungkan menggunakan MCP SDK.

Kemampuan server MCP

Server MCP Pengetahuan Google Developers menyediakan tiga alat inti untuk asisten coding AI Anda:

Nama alat	Deskripsi
search_documents	Menelusuri dokumentasi developer Google dan menampilkan kutipan halaman yang paling relevan beserta nama dokumennya.
get_documents	Mengambil konten Markdown lengkap dokumen menggunakan nama yang ditampilkan oleh search_documents.
answer_query	Menghasilkan jawaban terstruktur yang diambil dari korpus Developer Knowledge.

Alat search_documents menelusuri dokumentasi Google untuk menemukan bagian yang paling relevan yang cocok dengan kueri Anda. Saat Anda mengajukan pertanyaan, alat ini akan menampilkan bagian teks pendek. Jika agen Anda memerlukan konteks halaman lengkap di sekitar bagian teks, agen dapat meneruskan nama resource dokumen ke get_documents untuk mengambil seluruh halaman.

Gunakan alat answer_query saat Anda menginginkan jawaban langsung atas pertanyaan yang diambil dari korpus Developer Knowledge, bukan hasil penelusuran mentah atau file Markdown lengkap.

Tips: Pasangkan server MCP Pengetahuan Developer dengan kemampuan agen retrieving-developer-knowledge. Keahlian ini memberi bantuan coding AI Anda petunjuk bawaan tentang alat yang harus dipilih, cara menangani error, dan cara memanggil REST API jika server MCP tidak tersedia. Untuk mempelajari lebih lanjut, lihat Menggunakan keterampilan agen Developer Knowledge.

Memilih metode autentikasi

Server MCP Pengetahuan Developer mendukung dua pendekatan autentikasi, bergantung pada lingkungan pengembangan dan asisten AI Anda:

• Kunci API: paling cocok untuk IDE pihak ketiga dan agen CLI seperti Claude Code, Cursor, GitHub Copilot, Codex, dan klien MCP jarak jauh lainnya. Teruskan kunci API di header X-Goog-Api-Key melalui HTTPS.
• OAuth dan ADC: paling cocok untuk Google Antigravity, yang memiliki dukungan bawaan untuk Kredensial Default Aplikasi (ADC), atau untuk alur kerja perusahaan yang memerlukan token pemilik OAuth 2.0 atau client ID OAuth 2.0 mandiri, bukan kunci API.

Buat kredensial yang diperlukan untuk metode autentikasi yang Anda pilih agar asisten AI atau agen coding Anda dapat mengautentikasi permintaan dengan layanan server MCP Pengetahuan Developer.

Pilih tab untuk membuat kredensial Anda:

Kunci API

Prasyarat

Sebelum membuat kunci API, pastikan Anda memiliki:

• Project Google Cloud.
• gcloud CLI telah diinstal (jika mengonfigurasi dari command line).

Mengaktifkan API dan membuat kunci API

Anda dapat membuat kunci API menggunakan Konsol Google Cloud atau gcloud CLI:

Konsol Google Cloud

1. Buka halaman Developer Knowledge API di konsol Google Cloud.
2. Pilih project Google Cloud Anda, lalu klik Aktifkan.
3. Buka halaman Kredensial.
4. Klik Create credentials, lalu pilih kunci API.
5. Klik tindakan Edit kunci API untuk mengonfigurasi pembatasan:
   • Di bagian API restrictions, pilih Restrict key.
   • Pilih Developer Knowledge API.
   • Jika Anda berencana menggunakan kunci yang sama untuk panggilan model (seperti GEMINI_API_KEY), pilih juga Generative Language API.
6. Klik Save, lalu salin kunci API Anda.

gcloud CLI

1. Aktifkan Developer Knowledge API di project Anda, dengan mengganti PROJECT_ID dengan project ID Anda:

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

2. Buat kunci API:

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

   Perintah ini akan menampilkan detail metadata tentang kunci baru Anda. Salin dan simpan kedua nilai berikut dari output perintah:

   • keyString: ini adalah kunci API mentah (misalnya, AIzaSy...). Anda akan menempelkan nilai ini ke konfigurasi IDE.
   • name: ini adalah jalur resource kunci (misalnya, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Anda akan menggunakan jalur ini untuk membatasi kunci pada langkah berikutnya.

3. Batasi kunci ke Developer Knowledge API untuk membantu mencegah penggunaan yang tidak sah. Ganti KEY_NAME dengan jalur name lengkap yang disalin dari langkah sebelumnya:

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

   Penting: Jika Anda berencana menggunakan kunci yang sama ini untuk panggilan model umum klien AI Anda (misalnya, GEMINI_API_KEY), Anda juga harus mengizinkan Generative Language API:

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

OAuth dan ADC

Prasyarat

Sebelum mengonfigurasi OAuth atau ADC, pastikan Anda memiliki:

• Project Google Cloud.
• gcloud CLI telah diinstal.

Mengaktifkan API

Jalankan perintah berikut untuk mengaktifkan Developer Knowledge API di project Anda:

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

Memilih jenis kredensial OAuth Anda

Pilih pendekatan kredensial yang diperlukan oleh alat Anda:

ADC

Google Antigravity memiliki dukungan bawaan untuk ADC dan memperbarui token secara otomatis. Klien MCP lain dapat menggunakan ADC dengan meneruskan token pemilik berumur pendek di header Authorization:

1. Lakukan autentikasi dengan Akun Google Anda dan tetapkan project kuota Anda:

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

2. Saat browser terbuka, login dengan Akun Google Anda dan berikan izin yang diminta.

3. (Opsional) Jika Anda mengonfigurasi klien MCP pihak ketiga yang tidak memiliki dukungan ADC bawaan, buat token pembawa (berlaku selama satu jam) untuk digunakan di header Authorization klien Anda:

   gcloud auth application-default print-access-token
   

Client ID OAuth

Buat client ID dan secret OAuth 2.0 jika asisten AI Anda menggunakan alur OAuth interaktif karena server MCP jarak jauh Google tidak mendukung Dynamic Client Registration (DCR) OAuth.

1. Buka halaman Branding dan pilih project Anda. Masukkan Nama aplikasi dan Email dukungan pengguna, lalu klik Simpan.
2. Buka halaman Audience dan tetapkan User type ke External.
3. Di halaman yang sama, klik Add users di bagian Test users, masukkan alamat email Google Anda, lalu klik Save.
4. Buka halaman Klien, klik Buat klien, lalu pilih jenis aplikasi yang diperlukan oleh klien MCP Anda:
   • Pilih aplikasi desktop untuk klien desktop yang meminta client ID dan rahasia (seperti VS Code).
   • Pilih aplikasi web dan tambahkan URI pengalihan klien Anda untuk klien yang memerlukan callback pengalihan OAuth statis (seperti konektor kustom Cursor atau Claude Code). Gunakan URI pengalihan yang sama persis dengan yang didokumentasikan klien Anda; URI pengalihan kustom tidak didukung. Untuk URI pengalihan khusus klien, lihat Mengonfigurasi MCP dalam aplikasi AI.
5. Klik Create, lalu salin Client ID dan Client secret (atau download file kredensial klien JSON).

Cakupan OAuth

Server MCP Pengetahuan Developer menerima cakupan OAuth berikut:

• https://www.googleapis.com/auth/cloud-platform: cakupan default yang digunakan oleh Kredensial Default Aplikasi (ADC) dan gcloud CLI.
• https://www.googleapis.com/auth/devprofiles.full_control: cakupan yang digunakan untuk alur izin client ID OAuth 2.0 dan penemuan server MCP.
• https://www.googleapis.com/auth/developerprofiles.readonly: cakupan hanya baca yang didukung untuk akun layanan dan kredensial yang tidak memerlukan layar izin OAuth pengguna akhir.

Mengonfigurasi IDE atau agen coding Anda

Setelah mendapatkan kredensial, ikuti petunjuk penyiapan untuk lingkungan coding Anda. Petunjuk untuk setiap lingkungan coding mendukung metode autentikasi berikut:

Lingkungan coding	Metode autentikasi
Google Antigravity	Kredensial Google bawaan (ADC) atau kunci API
Claude Code, Cursor, GitHub Copilot, Codex	Kunci API
Lainnya	Kunci API, token pemilik ADC, atau client ID OAuth 2.0

Untuk menggunakan token pemilik ADC atau client ID OAuth 2.0 dengan Claude Code, Cursor, GitHub Copilot, atau Codex, ikuti petunjuk di tab Lainnya.

Bergantung pada template yang Anda gunakan, ganti placeholder berikut:

• Kunci API (YOUR_API_KEY): ganti dengan string kunci API mentah Anda.
• Project ID (PROJECT_ID): ganti dengan project ID Google Cloud Anda.

• Token akses (ACCESS_TOKEN): ganti dengan token pemilik dari gcloud auth application-default print-access-token.

Google Antigravity

Antigravity IDE dan ekstensi

Untuk mengonfigurasi server MCP di Antigravity IDE atau ekstensi Antigravity (seperti di VS Code), pilih metode autentikasi Anda:

Kredensial Google

Untuk menginstal server MCP menggunakan penyiapan sekali klik:

1. Di panel agen, klik menu Additional options () dan pilih server MCP.
2. Telusuri Google Developer Knowledge.
3. Klik ikon Instal (). Antigravity otomatis mengonfigurasi server dan terhubung menggunakan kredensial Google aktif Anda.

Kunci API

Untuk mengonfigurasi kunci API di Antigravity IDE atau ekstensi Antigravity:

1. Di panel Agent, klik menu Additional options () > MCP Servers > Manage MCP Servers > View raw config (atau buka .agents/mcp_config.json).

2. Tambahkan konfigurasi server berikut:

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

Antigravity CLI

Konfigurasikan server MCP di file .agents/mcp_config.json project Anda (atau secara global di ~/.gemini/config/mcp_config.json):

Kredensial Google

{
  "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"
      }
    }
  }
}

Kunci API

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

Tips: Jika Anda menggunakan aplikasi Antigravity 2.0 mandiri, buka Setelan > Penyesuaian, lalu klik Buka Konfigurasi MCP di bagian Server MCP yang Terinstal untuk menambahkan konfigurasi Anda.

Claude Code

Jalankan perintah berikut di terminal.

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

Kursor

Untuk mengonfigurasi Cursor, edit .cursor/mcp.json di root project Anda atau ~/.cursor/mcp.json untuk akses global:

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

GitHub Copilot

Catatan: Jika Anda menggunakan ekstensi Antigravity di VS Code, bukan GitHub Copilot, pilih tab Google Antigravity.

Setelan ruang kerja

Untuk mengonfigurasi GitHub Copilot di VS Code untuk ruang kerja tertentu, buat atau edit .vscode/mcp.json:

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

Setelan pengguna global

Untuk menyediakan server di semua ruang kerja VS Code, buka Command Palette, jalankan MCP: Open User Configuration, lalu tambahkan kode berikut ke file mcp.json di profil pengguna Anda:

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

Codex

Untuk mengonfigurasi Codex CLI atau agen Codex, tambahkan konfigurasi server ke ~/.codex/config.toml (atau .codex/config.toml project Anda):

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

Catatan: Setelah Anda mengubah konfigurasi, server mungkin menampilkan status tidak login. Hal ini wajar dan tidak akan memengaruhi akses Anda.

Lainnya

Untuk mengonfigurasi klien MCP jarak jauh lainnya (seperti JetBrains AI Assistant, Windsurf, Cline, Zed, Continue, atau Claude Desktop), atau untuk menggunakan token pembawa ADC atau ID klien OAuth 2.0 di klien pihak ketiga, pilih metode autentikasi Anda:

Kunci API

Konfigurasikan server transpor HTTP dengan setelan berikut:

• URL Server: https://developerknowledge.googleapis.com/mcp
• Header HTTP: X-Goog-Api-Key: YOUR_API_KEY

Template konfigurasi JSON standar:

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

Token pemilik ADC

Jika klien MCP Anda tidak memiliki dukungan ADC bawaan, Anda dapat melakukan autentikasi dengan ADC dengan meneruskan token pembawa dari gcloud auth application-default print-access-token dan ID project Google Cloud Anda di header permintaan:

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

Header X-Goog-User-Project memerlukan izin serviceusage.services.use pada project. Project owner dan editor memiliki izin ini. Pengguna lain memerlukan peran yang menyertakannya, seperti Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

Catatan: Masa berlaku token pemilik ADC akan berakhir setelah satu jam. Saat masa berlaku token Anda habis, jalankan gcloud auth application-default print-access-token lagi untuk membuat token baru.

Client ID OAuth

Untuk mengautentikasi menggunakan ID dan rahasia klien OAuth 2.0 mandiri:

1. Tambahkan endpoint server MCP ke konfigurasi klien Anda tanpa header kunci API:

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

   Catatan: VS Code menggunakan kunci servers tingkat teratas, bukan mcpServers. Tambahkan server ke .vscode/mcp.json di folder yang Anda buka sebagai ruang kerja, atau jalankan MCP: Open User Configuration dari Command Palette untuk membuatnya tersedia di semua ruang kerja. Untuk struktur file VS Code, lihat tab GitHub Copilot dan hapus bagian headers.

2. Selesaikan penyiapan OAuth untuk klien Anda:

   • Prompt interaktif (seperti VS Code): mengirimkan prompt pengujian ke agen. Jika muncul pesan bahwa Dynamic Client Registration tidak didukung, lanjutkan dan masukkan client ID dan rahasia klien Anda, lalu login dengan Akun Google Anda.
   • Konfigurasi OAuth statis (seperti Cursor atau Claude Code): berikan client ID OAuth, rahasia klien, dan URI pengalihan di setelan OAuth klien Anda. Untuk petunjuk khusus klien, lihat Mengonfigurasi MCP dalam aplikasi AI.

   Jika klien meminta Anda menentukan cakupan OAuth, gunakan https://www.googleapis.com/auth/devprofiles.full_control.

Anda tidak perlu menentukan ID project Google Cloud dalam konfigurasi ini. Permintaan dikaitkan dengan project yang memiliki ID klien OAuth Anda.

Memverifikasi koneksi

Setelah dikonfigurasi, mulai ulang asisten AI Anda atau muat ulang server MCP-nya. Kemudian, kirim perintah pengujian untuk memverifikasi bahwa integrasi alat berfungsi:

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

Jika agen memanggil search_documents atau answer_query dan menampilkan informasi dari dokumentasi Google, server Anda terhubung dan aktif.

Menggunakan keahlian agen Developer Knowledge

Instal keahlian agen retrieving-developer-knowledge resmi untuk mengajari asisten Anda kapan dan cara menggunakan alat inti yang ditawarkan oleh server MCP Developer Knowledge.

Keahlian agen adalah serangkaian petunjuk yang dibaca asisten bantuan coding AI Anda sebelum memulai tugas. Keahlian retrieving-developer-knowledge berfungsi dengan asisten apa pun yang mendukung standar Agent Skills terbuka dan membantu asisten Anda melakukan hal berikut:

• Pilih alat yang tepat: memandu asisten Anda menggunakan answer_query untuk pertanyaan "cara" dan perbandingan yang luas, serta search_documents (dengan dua hingga lima kata kunci yang difokuskan) saat mencari flag CLI, izin IAM, atau sintaksis kode yang persis.
• Check for errors before answering: memberi tahu asisten Anda untuk memastikan penelusuran dokumentasi benar-benar berhasil sebelum menulis jawaban, sehingga tidak salah mengira kunci API atau error kuota sebagai dokumentasi yang tidak ada atau kembali menebak dari data pelatihan yang lebih lama.
• Menggunakan REST API sebagai pengganti: memberikan perintah curl kepada asisten Anda untuk memanggil Developer Knowledge API secara langsung jika editor Anda tidak mendukung server MCP atau koneksi MCP gagal.

Menginstal keahlian agen

Pilih bantuan coding Anda untuk menginstal kemampuan retrieving-developer-knowledge di direktori project Anda:

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

Kursor

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

Codex

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

Lainnya

Untuk asisten AI lain yang mendukung standar Agent Skills terbuka, jalankan:

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

Untuk mengupdate skill yang terinstal ke versi terbaru, jalankan:

npx skills update

Untuk melihat petunjuk keterampilan dan panduan referensi lengkap, lihat direktori retrieving-developer-knowledge di GitHub.

Mengoptimalkan jendela konteks dan penggunaan token

Mengambil halaman dokumentasi lengkap ke dalam jendela konteks model AI akan menghabiskan token yang signifikan. Menyerap beberapa dokumen besar dapat menyebabkan biaya token yang tinggi, peningkatan latensi, dan kelebihan kapasitas jendela konteks.

Untuk memastikan respons yang cepat dan hemat biaya, ikuti praktik terbaik rekayasa perintah berikut:

• Menginstal kemampuan agen (direkomendasikan): Instal kemampuan agen retrieving-developer-knowledge agar asisten Anda secara otomatis memilih alat penelusuran yang tepat (answer_query atau search_documents), menggunakan penelusuran kata kunci singkat, dan hanya mendownload halaman lengkap jika diperlukan.

• Mengandalkan pengambilan dua langkah: biarkan agen memulai dengan memanggil search_documents. Tindakan ini akan menampilkan cuplikan (bagian) yang berfokus dan sering kali berisi sintaksis atau tanda tangan API yang tepat yang Anda perlukan tanpa menggunakan token untuk seluruh halaman. Instruksikan agen Anda untuk memanggil get_documents hanya jika konteks di sekitarnya benar-benar diperlukan.

• Pilih answer_query untuk pertanyaan konseptual: saat Anda memerlukan penjelasan yang dihasilkan atau perbandingan desain, arahkan agen Anda untuk menggunakan answer_query. Alat ini menghasilkan jawaban langsung dari korpus Developer Knowledge tanpa menampilkan halaman Markdown mentah lengkap.

• Tulis perintah yang spesifik dan tercakup: hindari perintah yang terlalu luas seperti "Jelaskan semua Firebase". Sebagai gantinya, tentukan produk, platform, dan bahasa target:

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

• Tambahkan aturan agen kustom: jika Anda tidak menggunakan kemampuan retrieving-developer-knowledge, tambahkan panduan tingkat project ke file petunjuk asisten Anda (misalnya, .cursorrules, CLAUDE.md, atau .github/copilot-instructions.md) untuk membatasi pengambilan halaman penuh otomatis:

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

Konfigurasi keamanan dan keselamatan opsional

MCP memperkenalkan risiko dan pertimbangan keamanan baru karena berbagai tindakan yang dapat Anda lakukan dengan alat MCP. Untuk meminimalkan dan mengelola risiko ini, Google Cloud menawarkan setelan default dan kebijakan yang dapat disesuaikan untuk mengontrol penggunaan alat MCP di organisasi atau project Google Cloud Anda.

Untuk mengetahui informasi selengkapnya tentang keamanan dan tata kelola MCP, lihat Keamanan dan keselamatan AI.

Menggunakan Model Armor

Model Armor adalah layanan Google Cloud yang dirancang untuk meningkatkan keamanan dan keselamatan aplikasi AI Anda. Model Armor bekerja dengan menyaring perintah dan respons LLM secara proaktif, melindungi dari berbagai risiko, dan mendukung praktik AI yang bertanggung jawab. Baik Anda men-deploy AI di lingkungan cloud Anda, atau di penyedia cloud eksternal, Model Armor dapat membantu Anda mencegah input berbahaya, memverifikasi keamanan konten, melindungi data sensitif, menjaga kepatuhan, dan menerapkan kebijakan keamanan dan keselamatan AI Anda secara konsisten di seluruh lanskap AI Anda yang beragam.

Jika Model Armor diaktifkan dengan logging diaktifkan, Model Armor akan mencatat seluruh payload. Hal ini dapat mengekspos informasi sensitif dalam log Anda.

Perutean permintaan MCP ke Model Armor

Model Armor tersedia di wilayah tertentu. Jika Model Armor diaktifkan dan Anda menggunakan server MCP di yurisdiksi yang tidak didukung Model Armor, perilaku perutean panggilan mungkin berbeda untuk server MCP yang berbeda dan dapat melanggar kepatuhan residensi data untuk data yang sedang digunakan dan dalam transit. Untuk mengetahui informasi selengkapnya tentang perilaku masing-masing server MCP, lihat Produk yang didukung Model Armor.

Mengaktifkan Model Armor

Ikuti langkah-langkah di Mengintegrasikan dengan server MCP Google dan Google Cloud untuk mengaktifkan Model Armor.

Mengonfigurasi perlindungan untuk server MCP jarak jauh

Untuk membantu melindungi panggilan dan respons alat MCP, Anda dapat menggunakan setelan batas Model Armor. Setelan minimum menentukan filter keamanan minimum yang berlaku di seluruh project. Konfigurasi ini menerapkan sekumpulan filter yang konsisten ke semua panggilan dan respons alat MCP dalam project.

Tips: Jangan aktifkan filter injeksi perintah dan jailbreak kecuali jika traffic MCP Anda membawa data bahasa alami.

Menyiapkan setelan tingkat Model Armor dengan sanitasi MCP diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan tingkat Model Armor.

Catatan: Jika agen dan server MCP berada di project yang berbeda, Anda dapat membuat setelan minimum di kedua project (project klien dan project resource). Dalam hal ini, Model Armor dipanggil dua kali, sekali untuk setiap project.

Lihat contoh perintah berikut:

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"}]'

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Perhatikan setelan berikut:

• INSPECT_AND_BLOCK: Jenis penegakan yang memeriksa konten untuk server MCP Google dan memblokir perintah dan respons yang cocok dengan filter.
• ENABLED: Setelan yang mengaktifkan filter atau penerapan.
• MEDIUM_AND_ABOVE: Tingkat keyakinan untuk setelan filter Responsible AI - Berbahaya. Anda dapat mengubah setelan ini, meskipun nilai yang lebih rendah dapat menghasilkan lebih banyak positif palsu. Untuk mengetahui informasi selengkapnya, lihat Tingkat keyakinan Model Armor.

Menonaktifkan pemindaian traffic MCP dengan Model Armor

Untuk menghentikan Model Armor memindai traffic secara otomatis ke dan dari server MCP Google berdasarkan setelan batas bawah project, jalankan perintah berikut:

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

Ganti PROJECT_ID dengan ID project Google Cloud. Model Armor tidak secara otomatis menerapkan aturan yang ditentukan dalam setelan batas bawah project ini ke traffic server MCP Google.

Setelan tingkat dan konfigurasi umum Model Armor dapat memengaruhi lebih dari sekadar MCP. Karena Model Armor terintegrasi dengan layanan seperti Vertex AI, setiap perubahan yang Anda buat pada setelan tingkat dapat memengaruhi pemindaian traffic dan perilaku keamanan di semua layanan terintegrasi, bukan hanya MCP.

Menyesuaikan setelan Model Armor

Jika Anda menggunakan Model Armor untuk melindungi aplikasi, Anda mungkin mengalami error 403 PERMISSION_DENIED untuk beberapa kueri. Karena server MCP Developer Knowledge hanya menampilkan dokumentasi publik dari sumber Google tepercaya, sebaiknya setel filter Prompt Injection dan Jailbreak (PIJB) ke tingkat keyakinan HIGH_AND_ABOVE untuk mengurangi positif palsu. Jika kasus penggunaan Anda tidak melibatkan alat lain yang mengakses data pribadi atau sensitif, Anda juga dapat mempertimbangkan untuk menonaktifkan filter PIJB.

Pemecahan masalah

Jika Anda mengalami masalah saat menghubungkan atau membuat kueri ke server MCP Developer Knowledge, temukan gejala atau pesan error Anda dalam tabel berikut.

Error penyiapan dan koneksi

Gejala atau error	Kemungkinan penyebab	Resolusi
404 NOT_FOUND di endpoint /mcp	API tidak diaktifkan untuk project Anda.	Aktifkan Developer Knowledge API di konsol Google Cloud atau jalankan gcloud services enable developerknowledge.googleapis.com.
403 PERMISSION_DENIED: Developer Knowledge API has not been used	Developer Knowledge API tidak diaktifkan di project Google Cloud.	Aktifkan API di konsol Google Cloud atau jalankan gcloud services enable developerknowledge.googleapis.com.
Alat MCP tidak ada atau koneksi gagal	Alat coding Anda tidak mendukung server MCP HTTP jarak jauh atau tidak dapat terhubung ke server.	Instal keahlian agen retrieving-developer-knowledge, yang memberi tahu asisten Anda cara beralih ke endpoint REST Developer Knowledge API menggunakan curl saat alat MCP tidak tersedia.

Error kunci API

Gejala atau error	Kemungkinan penyebab	Resolusi
400 Bad Request: API key not valid	String kunci API tidak ada, tidak valid, atau salah format.	Pastikan kunci API disalin dengan benar dan dikonfigurasi dalam objek headers dengan kunci X-Goog-Api-Key. Jangan teruskan kunci API sebagai parameter kueri di URL.
403 PERMISSION_DENIED: API target restriction	Daftar pembatasan kunci API mengecualikan Developer Knowledge API.	Perbarui batasan kunci API Anda di halaman Credentials di Konsol Google Cloud untuk menyertakan Developer Knowledge API.

Error OAuth dan ADC

Gejala atau error	Kemungkinan penyebab	Resolusi
401 UNAUTHENTICATED atau kredensial ADC tidak ada	Token pemilik Kredensial Default Aplikasi atau ADC sudah tidak berlaku atau belum diinisialisasi.	Jalankan gcloud auth application-default login --project=PROJECT_ID untuk memperbarui kredensial lokal, atau jalankan gcloud auth application-default print-access-token untuk membuat token pemilik baru.
403 PERMISSION_DENIED: API requires a quota project, which is not set by default	Permintaan menggunakan token pemilik ADC tanpa header X-Goog-User-Project.	Tambahkan header X-Goog-User-Project dengan ID project Google Cloud Anda ke konfigurasi klien MCP Anda.
403 PERMISSION_DENIED dengan header X-Goog-User-Project	Akun Anda tidak memiliki izin serviceusage.services.use pada project di header.	Minta administrator project untuk memberi Anda peran Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).
403 access_denied / "Akses diblokir: error otorisasi"	Layar izin OAuth Anda menggunakan jenis pengguna Eksternal dalam mode pengujian, dan akun Anda tidak tercantum sebagai pengguna pengujian.	Di Konsol Google Cloud > Auth Platform > Audience, tambahkan alamat email Google aktif Anda di bagian Test users.
Error klien OAuth atau URI pengalihan tidak valid	Klien OAuth dibuat dengan jenis aplikasi yang tidak didukung atau URI pengalihan yang tidak ada.	Gunakan Aplikasi desktop untuk klien dengan perintah interaktif (seperti VS Code), atau Aplikasi web dengan URI pengalihan yang diizinkan klien Anda (seperti Cursor atau Claude Code).

Error kuota dan filter keamanan

Gejala atau error	Kemungkinan penyebab	Resolusi
429 RESOURCE_EXHAUSTED	Anda telah mencapai batas kuota project.	Periksa penggunaan Anda di halaman kuota Developer Knowledge API di Konsol Google Cloud. Untuk mempelajari batas dan meminta peningkatan, lihat Kuota Developer Knowledge API.
403 PERMISSION_DENIED dengan Model Armor	Positif palsu dari filter PIJB Model Armor memblokir kueri yang aman.	Tetapkan keyakinan filter PIJB ke HIGH_AND_ABOVE di setelan template Model Armor Anda.

Dokumentasi yang disertakan

Lihat Referensi korpus untuk mengetahui daftar lengkap produk Google dan repositori dokumentasi yang diindeks oleh server.

Batasan umum

• Hanya dokumentasi publik: Server hanya mengindeks dokumentasi yang tersedia secara publik yang tercantum dalam Referensi korpus. Dokumen internal, repositori pribadi, dan resource pihak ketiga tidak disertakan.
• Bahasa Inggris: Server mengindeks dan menampilkan dokumentasi dalam bahasa Inggris saja.
• Dependensi jaringan dan Kontrol Layanan VPC: Karena server MCP Developer Knowledge adalah layanan yang dihosting dari jarak jauh, klien Anda harus memiliki konektivitas jaringan untuk menjangkau https://developerknowledge.googleapis.com.
  • Di dalam jaringan VPC Google Cloud: Traffic egress internet publik tidak diperlukan. Anda dapat menjangkau developerknowledge.googleapis.com secara pribadi tanpa alamat IP eksternal atau Cloud NAT dengan merutekan traffic menggunakan Akses Google Pribadi (private.googleapis.com / 199.36.153.8/30) atau endpoint Private Service Connect (PSC) yang menargetkan paket all-apis.
  • Kontrol Layanan VPC (VPC-SC): developerknowledge.googleapis.com tidak didukung di VIP Terbatas (restricted.googleapis.com / 199.36.153.4/30) atau endpoint PSC vpc-sc. Jika VPC Anda merutekan *.googleapis.com ke restricted.googleapis.com, konfigurasikan kebijakan respons Cloud DNS atau data DNS pribadi tertentu untuk developerknowledge.googleapis.com agar di-resolve ke private.googleapis.com (199.36.153.8/30).