Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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 pustaka dokumentasi resmi Google, Anda tidak perlu melakukan penelusuran web secara manual, menggunakan konteks yang sudah tidak berlaku, dan melakukan scraping.

Kemampuan server MCP

Server MCP Pengetahuan Developer Google 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 Pengetahuan Developer.

Alat search_documents menelusuri dokumentasi Google untuk menemukan bagian yang paling relevan dan 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.

Pilih metode autentikasi Anda

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

Kunci API: paling cocok untuk agen CLI dan IDE pihak ketiga 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 pembawa 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 Developer Knowledge.

Pilih tab untuk membuat kredensial Anda:

Kunci API

Prasyarat

Sebelum membuat kunci API, pastikan Anda telah:

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

Buka halaman Developer Knowledge API di konsol Google Cloud.
Pilih project Google Cloud Anda, lalu klik Aktifkan.
Buka halaman Kredensial.
Klik Create credentials, lalu pilih API key.
Klik tindakan Edit API key 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.
Klik Simpan, lalu salin kunci API Anda.

gcloud CLI

Aktifkan Developer Knowledge API di project Anda, dengan mengganti PROJECT_ID dengan project ID Anda:
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
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.
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:

Mengaktifkan API

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

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

Pilih 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 lainnya dapat menggunakan ADC dengan meneruskan token pembawa berumur pendek di header Authorization:

Lakukan autentikasi dengan Akun Google Anda dan tetapkan project kuota Anda:
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
Saat browser Anda terbuka, login dengan Akun Google Anda dan berikan izin yang diminta.
(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.

Buka halaman Branding dan pilih project Anda. Masukkan Nama aplikasi dan Email dukungan pengguna, lalu klik Simpan.
Buka halaman Audiens dan tetapkan Jenis pengguna ke Eksternal.
Di halaman yang sama, klik Tambahkan pengguna di bagian Pengguna penguji, masukkan alamat email Google Anda, lalu klik Simpan.
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 secret (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.
Klik Create, lalu salin Client ID dan Client secret Anda (atau download file kredensial klien JSON).

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 pembawa ADC, atau client ID OAuth 2.0

Untuk menggunakan token pembawa ADC atau ID klien 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:

Di panel Agent, klik menu Additional options () dan pilih MCP Servers.
Telusuri Google Developer Knowledge.
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:

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

Tambahkan konfigurasi server berikut:

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

Antigravity CLI

Konfigurasi server MCP dalam 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"
      }
    }
  }
}

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

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

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

Konfigurasi server transport 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. Pemilik dan editor project memiliki izin ini. Pengguna lain memerlukan peran yang mencakupnya, seperti Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

Client ID OAuth

Untuk mengautentikasi menggunakan ID dan rahasia klien OAuth 2.0 mandiri:

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 agar server tersedia di semua ruang kerja. Untuk struktur file VS Code, lihat tab GitHub Copilot dan hapus bagian headers.
Selesaikan penyiapan OAuth untuk klien Anda:
- Perintah interaktif (seperti VS Code): kirim perintah 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 untuk 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 coding AI Anda sebelum memulai tugas. Keahlian retrieving-developer-knowledge berfungsi dengan asisten apa pun yang mendukung standar Keahlian Agen 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.
Periksa error sebelum menjawab: memberi tahu asisten Anda untuk memastikan penelusuran dokumentasi berhasil sebelum menulis jawaban, sehingga asisten tidak salah mengira error kunci API atau kuota sebagai dokumentasi yang tidak ada atau kembali menebak dari data pelatihan yang lebih lama.
Kembali ke REST API: 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 asisten 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 Keterampilan Agen terbuka, jalankan:

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

Untuk mengupdate skill terinstal ke versi terbaru, jalankan:

npx skills update

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

Mengoptimalkan jendela konteks dan penggunaan token

Mengambil halaman dokumentasi lengkap ke jendela konteks model AI akan menggunakan token dalam jumlah yang signifikan. Memasukkan beberapa dokumen besar dapat menyebabkan biaya token yang tinggi, peningkatan latensi, dan luapan 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 informasi dua langkah: memungkinkan agen memulai dengan memanggil search_documents. Respons ini menampilkan cuplikan (chunk) yang berfokus dan sering kali berisi sintaksis atau tanda tangan API yang Anda butuhkan tanpa menggunakan token untuk seluruh halaman. Instruksikan agen Anda untuk memanggil get_documents hanya jika konteks di sekitarnya benar-benar diperlukan.
Lebih memilih 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 Pengetahuan Developer 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?
```
Menambahkan aturan agen kustom: jika Anda tidak menggunakan skill retrieving-developer-knowledge, tambahkan pedoman tingkat project ke file petunjuk asisten Anda (misalnya, .cursorrules, CLAUDE.md, atau .github/copilot-instructions.md) untuk membatasi pengambilan otomatis halaman penuh:
```
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. Layanan ini 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 wilayah hukum 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 setiap 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 serangkaian filter yang konsisten ke semua panggilan dan respons alat MCP dalam project.

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

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 ID project 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 AI yang bertanggung jawab - 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 tingkat 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 otomatis menerapkan aturan yang ditentukan dalam setelan tingkat project ini ke traffic server MCP Google.

Setelan tingkat Model Armor dan konfigurasi umum dapat memengaruhi lebih dari sekadar MCP. Karena Model Armor terintegrasi dengan layanan seperti Vertex AI, setiap perubahan yang Anda lakukan 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 terhubung ke atau membuat kueri server MCP Developer Knowledge, temukan gejala atau pesan error Anda dalam tabel berikut.

Error penyiapan dan koneksi

Gejala atau error	Kemungkinan penyebab	Resolusi
Endpoint `404 NOT_FOUND` di `/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 `retrieving-developer-knowledge` agent skill, yang memberi tahu asisten Anda cara melakukan penggantian ke endpoint REST API Developer Knowledge 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 meneruskan kunci API sebagai parameter kueri di URL.
`403 PERMISSION_DENIED: API target restriction`	Daftar pembatasan kunci API tidak menyertakan 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 pembawa 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 pembawa baru.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	Permintaan menggunakan token pembawa 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 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 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.
- Inside Google Cloud VPC networks: 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, konfigurasi 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).

Terhubung ke server MCP Pengetahuan Developer Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Kemampuan server MCP

Pilih metode autentikasi Anda

Kunci API

Prasyarat

Mengaktifkan API dan membuat kunci API

Konsol Google Cloud

gcloud CLI

OAuth dan ADC

Prasyarat

Mengaktifkan API

Pilih jenis kredensial OAuth Anda

ADC

Client ID OAuth

Mengonfigurasi IDE atau agen coding Anda

Google Antigravity

Antigravity IDE dan ekstensi

Kredensial Google

Kunci API

Antigravity CLI

Kredensial Google

Kunci API

Claude Code

Kursor

GitHub Copilot

Setelan ruang kerja

Setelan pengguna global

Codex

Lainnya

Kunci API

Token pemilik ADC

Client ID OAuth

Memverifikasi koneksi

Menggunakan keahlian agen Developer Knowledge

Menginstal keahlian agen

Google Antigravity

Claude Code

Kursor

Codex

Lainnya

Mengoptimalkan jendela konteks dan penggunaan token

Konfigurasi keamanan dan keselamatan opsional

Menggunakan Model Armor

Perutean permintaan MCP ke Model Armor

Mengaktifkan Model Armor

Mengonfigurasi perlindungan untuk server MCP jarak jauh

Menonaktifkan pemindaian traffic MCP dengan Model Armor

Menyesuaikan setelan Model Armor

Pemecahan masalah

Error penyiapan dan koneksi

Error kunci API

Error OAuth dan ADC

Error kuota dan filter keamanan

Dokumentasi yang disertakan

Batasan umum

Terhubung ke server MCP Pengetahuan Developer