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 dapat menghindari penelusuran web manual, konteks yang sudah tidak berlaku, 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 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 pendek. Jika memerlukan konteks halaman lengkap di sekitar bagian teks, agen Anda dapat meneruskan nama resource dokumen ke get_documents untuk mengambil seluruh halaman.

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

Memilih metode autentikasi Anda

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

  • Kunci API: Terbaik 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 alur kerja Google Antigravity atau perusahaan yang menggunakan Kredensial Default Aplikasi (ADC) atau ID Klien 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 Developer Knowledge.

Pilih tab untuk membuat kredensial Anda:

Kunci API

Prasyarat

Sebelum membuat kunci API, pastikan Anda telah:

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 API key.
  5. Klik tindakan Edit API key untuk mengonfigurasi pembatasan:
    • Di bagian Pembatasan API, pilih Batasi kunci.
    • Pilih Developer Knowledge API.
    • Jika Anda berencana menggunakan kunci yang sama ini 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 tanpa izin. 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

    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 telah:

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:

Kredensial Default Aplikasi

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

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

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

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

Client ID OAuth

Jika asisten AI Anda memerlukan ID dan rahasia klien OAuth mandiri:

  1. Buka layar izin OAuth.
  2. Tetapkan jenis pengguna ke Eksternal, isi nama aplikasi dan email dukungan yang diperlukan, lalu klik Simpan dan lanjutkan.
  3. Di halaman Audiens, klik Tambahkan pengguna di bagian Pengguna pengujian, masukkan alamat email Google Anda, lalu klik Simpan.
  4. Buka halaman Klien, klik Buat klien, lalu tetapkan Jenis aplikasi ke Aplikasi desktop.
  5. 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 di 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 ID project 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:

  1. Di panel Agent, klik menu Additional options () dan pilih MCP Servers.
  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

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-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) 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.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), konfigurasi 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"
      }
    }
  }
}

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

Mengambil halaman dokumentasi lengkap ke jendela konteks model AI akan menggunakan token dalam jumlah besar. 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:

  • Mengandalkan pengambilan dua langkah: Biarkan agen memulai dengan memanggil search_documents. Respons ini 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 baik menggunakan answer_query untuk pertanyaan konseptual: Jika Anda memerlukan penjelasan yang disintesis atau perbandingan desain, arahkan agen Anda untuk menggunakan answer_query. Alat ini menyintesis 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: Tambahkan pedoman level project ke file petunjuk asisten Anda (misalnya, .cursorrules, CLAUDE.md, atau .github/copilot-instructions.md) untuk membatasi pengambilan otomatis halaman lengkap:

    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 tingkat 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 project ID 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 . 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 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. 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 batasan 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 / "Akses diblokir: error otorisasi" Akun Anda tidak tercantum sebagai pengguna pengujian yang sah dalam izin OAuth. Di Konsol Google Cloud > Auth Platform > Audience, tambahkan alamat email Anda di bagian Test users.
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 Aplikasi desktop.
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.
429 RESOURCE_EXHAUSTED Anda telah mencapai batas kuota project. Periksa penggunaan kuota Developer Knowledge API Anda di konsol dan minta penambahan kuota jika diperlukan.
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.

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 uji coba layar izin OAuth: Saat membuat klien OAuth desktop dalam project dengan jenis pengguna eksternal dalam mode pengujian, Google memblokir akses untuk akun yang tidak tercantum di bagian pengguna uji coba. 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, buka IAM & Admin > Quotas & System Limits di konsol Google Cloud dan filter menurut Developer Knowledge API.

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 Restricted VIP (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).