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 Pengetahuan Developer Google memberi alat pengembangan yang didukung 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 dapat menghindari penelusuran web manual, konteks yang tidak relevan, dan 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 dari dokumen menggunakan nama yang ditampilkan oleh `search_documents`.
`answer_query`	Menghasilkan jawaban terstruktur dan tersintesis yang didasarkan pada 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 singkat. Jika agen Anda memerlukan konteks halaman lengkap yang mengelilingi bagian tersebut, agen dapat meneruskan nama resource dokumen ke get_documents untuk mengambil seluruh halaman.

Gunakan alat answer_query jika Anda menginginkan jawaban langsung atas pertanyaan yang disintesis dari korpus Pengetahuan Developer bukan hasil penelusuran mentah atau file Markdown lengkap.

Memilih metode autentikasi

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

Kunci API: Terbaik untuk IDE dan agen CLI 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: Terbaik untuk Google Antigravity atau alur kerja perusahaan yang menggunakan Kredensial Default Aplikasi (ADC) atau Client ID OAuth 2.0 mandiri.

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 terinstal (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 Enable.
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 ini untuk panggilan model (seperti GEMINI_API_KEY), pilih juga Generative Language API.
Klik Save, 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 dalam konfigurasi IDE Anda.
- 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, 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

Memilih jenis kredensial OAuth

Pilih pendekatan kredensial yang diperlukan oleh alat Anda:

Kredensial Default Aplikasi

Jika asisten AI Anda mendukung ADC (seperti Google Antigravity):

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.

ID klien OAuth

Jika asisten AI Anda memerlukan klien OAuth dan rahasia mandiri:

Buka layar izin OAuth.
Tetapkan jenis pengguna ke External, isi nama aplikasi yang diperlukan dan email dukungan, lalu klik Save and continue.
Di halaman Audience, klik Add users di bagian Test users, masukkan alamat email Google Anda, lalu klik Save.
Buka halaman Clients, klik Create client, lalu tetapkan Application type ke Desktop app.
Klik Create, lalu download file kredensial klien JSON.

Mengonfigurasi IDE atau agen coding Anda

Setelah mendapatkan kredensial, pilih lingkungan coding pilihan Anda untuk melihat petunjuk penyiapan.

Bergantung pada metode autentikasi yang Anda pilih, ganti placeholder dalam template konfigurasi sebagai berikut:

Autentikasi kunci API: Ganti YOUR_API_KEY dengan string kunci API mentah Anda.
Autentikasi OAuth atau ADC: Ganti PROJECT_ID dengan project ID Google Cloud Anda:

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 (), lalu pilih MCP Servers.
Telusuri Google Developer Knowledge.
Klik ikon Install (). Antigravity akan 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

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

Claude Code

Jalankan perintah berikut di terminal.

claude mcp add google-dev-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

Agar server tersedia di semua ruang kerja VS Code, buka Setelan Pengguna (JSON) Anda dan tambahkan kode berikut di bagian kunci "mcp":

{
  "mcp": {
    "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.json (atau .codex/config.json project Anda):

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "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), konfigurasikan server transportasi 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"
      }
    }
  }
}

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.

Mengoptimalkan penggunaan jendela konteks dan token

Mengambil halaman dokumentasi lengkap ke jendela konteks model AI akan menggunakan token yang signifikan. Menggunakan beberapa dokumen besar dapat menyebabkan biaya token yang tinggi, peningkatan latensi, dan overflow jendela konteks.

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

Mengandalkan pengambilan dua langkah: Izinkan agen memulai dengan memanggil search_documents. Tindakan ini akan menampilkan cuplikan (potongan) 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: Jika Anda memerlukan penjelasan tersintesis atau perbandingan desain, arahkan agen Anda untuk menggunakan answer_query. Alat ini mensintesis jawaban langsung dari korpus Pengetahuan Developer tanpa menampilkan halaman Markdown mentah lengkap.
Menulis perintah yang spesifik dan dalam cakupan: Hindari perintah yang terlalu luas seperti "Jelaskan semua tentang 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: Tambahkan panduan tingkat project ke file instruksi asisten Anda (misalnya, .cursorrules, CLAUDE.md, atau .github/copilot-instructions.md) untuk membatasi pengambilan otomatis seluruh halaman:
```
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 berfungsi dengan secara proaktif menyaring perintah dan respons LLM, melindungi dari berbagai risiko, dan mendukung praktik AI yang bertanggung jawab. Baik Anda men-deploy AI di lingkungan cloud Anda, maupun di penyedia cloud eksternal, Model Armor dapat membantu Anda mencegah input berbahaya, memverifikasi keamanan konten, melindungi data sensitif, mempertahankan 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 digunakan dan dalam pengiriman. 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, Anda dapat menggunakan setelan tingkat Model Armor. Setelan minimum menentukan filter keamanan minimum yang berlaku di seluruh project. Konfigurasi ini menerapkan kumpulan filter yang konsisten ke semua panggilan dan respons alat MCP dalam project.

Siapkan setelan minimum Model Armor dengan sanitasi MCP diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan minimum 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 project IDAnda.

Perhatikan setelan berikut:

INSPECT_AND_BLOCK: Jenis penerapan 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 kepercayaan 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 kepercayaan Model Armor.

Menonaktifkan pemindaian traffic MCP dengan Model Armor

Untuk menghentikan Model Armor agar tidak otomatis memindai traffic 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 project ID. Model Armor tidak otomatis menerapkan aturan yang ditentukan dalam setelan tingkat project ini ke traffic server MCP Google mana pun.

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 buat pada setelan tingkat dapat memengaruhi perilaku pemindaian dan keamanan traffic di semua layanan terintegrasi, bukan hanya MCP.

Menyesuaikan setelan Model Armor

Jika Anda menggunakan Model Armor untuk melindungi aplikasi Anda, Anda mungkin akan mengalami error 403 PERMISSION_DENIED untuk beberapa kueri. Karena server MCP Pengetahuan Developer hanya menampilkan dokumentasi publik dari sumber Google tepercaya, sebaiknya tetapkan filter Injeksi Perintah dan Jailbreak (PIJB) ke tingkat kepercayaan 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 server MCP Pengetahuan Developer, lihat matriks pemecahan masalah dan langkah-langkah penyelesaian berikut:

Matriks pemecahan masalah

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`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	Developer Knowledge API tidak diaktifkan di project Google Cloud project.	Aktifkan API di Konsol Google Cloud atau jalankan `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED: API target restriction`	Daftar pembatasan kunci API tidak menyertakan Developer Knowledge API.	Perbarui pembatasan kunci API Anda di halaman Kredensial di Konsol Google Cloud untuk menyertakan Developer Knowledge API.
`401 UNAUTHENTICATED` atau kredensial ADC tidak ada	Kredensial Default Aplikasi sudah tidak berlaku atau belum diinisialisasi.	Jalankan `gcloud auth application-default login --project=PROJECT_ID` untuk memperbarui kredensial lokal.
`403 access_denied` / "Access blocked: authorization error"	Akun Anda tidak tercantum sebagai pengguna pengujian yang diotorisasi dalam izin OAuth.	Di Konsol Google Cloud > Platform Autentikasi > Audiens, tambahkan alamat email Anda di bagian Pengguna pengujian.
Error klien OAuth atau URI pengalihan tidak valid	Klien OAuth dibuat dengan jenis aplikasi yang tidak didukung.	Buat ulang klien OAuth Anda dengan jenis yang ditetapkan ke Desktop app.
`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`.
`429 RESOURCE_EXHAUSTED`	Anda telah mencapai batas kuota project Anda.	Periksa penggunaan kuota Developer Knowledge API Anda di konsol dan minta peningkatan kuota jika diperlukan.
`403 PERMISSION_DENIED` dengan Model Armor	Positif palsu dari filter PIJB Model Armor memblokir kueri yang aman.	Tetapkan kepercayaan filter PIJB ke `HIGH_AND_ABOVE` di setelan template Model Armor Anda.

Mengatasi error autentikasi dan izin

Konfigurasi header kunci API: Pastikan konfigurasi JSON MCP Anda menyertakan bagian headers dengan "X-Goog-Api-Key". Jangan meneruskan kunci API sebagai parameter kueri di URL.
Pengguna pengujian layar izin OAuth: Saat membuat klien OAuth desktop di project dengan jenis pengguna eksternal dalam mode pengujian, Google akan memblokir akses untuk akun yang tidak tercantum di bagian pengguna pengujian. Pastikan alamat email Google aktif Anda ditambahkan di bagian Audiens > Pengguna pengujian di Konsol Google Cloud.
Batas kuota dan kecepatan: Untuk memantau penggunaan harian dan per menit Anda, buka IAM & Admin > Batas Kuota & Sistem di Konsol Google Cloud dan filter menurut Developer Knowledge API.

Dokumentasi yang disertakan

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

Batasan umum

Dokumentasi publik saja: Server hanya mengindeks dokumentasi yang tersedia secara publik dan tercantum dalam Referensi Korpus. Dokumen internal, repositori pribadi, dan resource pihak ketiga tidak disertakan.
Bahasa Inggris: Server hanya mengindeks dan menampilkan dokumentasi dalam Bahasa Inggris.
Dependensi jaringan: Server memerlukan konektivitas internet aktif untuk menjangkau https://developerknowledge.googleapis.com.

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

Kemampuan server MCP

Memilih metode autentikasi

Kunci API

Prasyarat

Mengaktifkan API dan membuat kunci API

Konsol Google Cloud

gcloud CLI

OAuth dan ADC

Prasyarat

Mengaktifkan API

Memilih jenis kredensial OAuth

Kredensial Default Aplikasi

ID klien 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

Memverifikasi koneksi

Mengoptimalkan penggunaan jendela konteks dan 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

Matriks pemecahan masalah

Mengatasi error autentikasi dan izin

Dokumentasi yang disertakan

Batasan umum

Terhubung ke server MCP Pengetahuan Developer