Terhubung ke server MCP Pengetahuan Developer

Server MCP Google Developer Knowledge memberi alat pengembangan berteknologi AI kemampuan untuk menelusuri dokumentasi developer resmi Google dan mengambil informasi untuk produk Google seperti Firebase, Google Cloud, Android, Maps, dan banyak lagi. Dengan menghubungkan aplikasi AI Anda langsung ke library dokumentasi resmi kami, Anda memastikan kode dan panduan yang Anda terima selalu terbaru dan didasarkan pada konteks yang berwenang.

Setelah Anda menyiapkan server, alat terintegrasi dapat membantu permintaan seperti:

  • Panduan penerapan

    • Misalnya: Apa cara terbaik untuk menerapkan notifikasi push menggunakan Firebase Cloud Messaging di aplikasi Android?

  • Pembuatan dan penjelasan kode

    • Misalnya: Telusuri dokumentasi Google untuk menemukan contoh Python guna mencantumkan semua bucket dalam project Cloud Storage.

  • Pemecahan masalah dan proses debug

    • Misalnya: Mengapa kunci Google Maps API saya menampilkan watermark 'Hanya untuk tujuan pengembangan'?

  • Analisis dan ringkasan komparatif

    • Misalnya: Bantu saya memilih antara Cloud Run dan Cloud Functions untuk microservice baru. Buat tabel Markdown yang membandingkan aspek utama seperti kasus penggunaan utama, serentak, dan model harga.

Kemampuan server MCP

Server MCP Pengetahuan Developer Google menyediakan alat berikut untuk aplikasi AI Anda:

Nama alat Deskripsi
search_documents Menelusuri dokumentasi developer Google (Firebase, Google Cloud, Android, Maps, dan lainnya) untuk menemukan halaman dan cuplikan yang relevan untuk kueri Anda. Gunakan get_documents dengan parent dari hasil penelusuran untuk mendapatkan konten halaman lengkap.
get_documents Mendapatkan konten lengkap beberapa dokumen menggunakan parent dari hasil search_documents.

Alat search_documents membagi dokumentasi menjadi potongan teks yang lebih kecil yang dioptimalkan untuk penelusuran dan pengambilan berteknologi AI. Saat Anda melakukan penelusuran, alat ini akan menampilkan satu atau beberapa cuplikan dokumen yang relevan dengan kueri Anda. Jika Anda perlu melihat konten halaman lengkap yang mengapit cuplikan, gunakan get_documents dengan parent yang diberikan dalam hasil penelusuran untuk mengambil konten halaman lengkap.

Penginstalan

Server MCP Pengetahuan Developer Google adalah server MCP jarak jauh yang menggunakan Developer Knowledge API untuk menelusuri dan mengambil dokumentasi. Anda dapat melakukan autentikasi menggunakan OAuth atau kunci API.

Melakukan autentikasi menggunakan OAuth

Bagian ini memandu Anda dalam proses mengautentikasi aplikasi AI dengan server MCP Pengetahuan Developer menggunakan OAuth.

Prasyarat: Siapkan Google Cloud CLI

Sebelum melanjutkan, pastikan Anda memiliki:

Langkah 1: Aktifkan Developer Knowledge API di project

  1. Buka halaman Developer Knowledge API di library API Google.
  2. Periksa apakah Anda telah memilih project yang benar untuk menggunakan API.
  3. Klik Enable. Tidak ada peran IAM tertentu yang diperlukan untuk mengaktifkan atau menggunakan API.

Langkah 2: Pilih metode autentikasi Anda

Metode autentikasi yang Anda pilih bergantung pada apakah asisten AI Anda mendukung Kredensial Default Aplikasi (ADC) menggunakan gcloud CLI atau memerlukan ID Klien OAuth mandiri. Asisten seperti Gemini CLI dapat menggunakan login Google Cloud yang ada untuk penyiapan yang lancar, sementara yang lain, seperti Antigravity, mengharuskan Anda membuat dan memberikan kredensial sendiri secara manual untuk membuat koneksi yang aman.

Pilih tab yang sesuai dengan persyaratan penyiapan asisten AI spesifik Anda.

ADC

Sambungkan akun Anda

  1. Untuk memberikan kemampuan kepada server MCP agar dapat bertindak atas nama Anda, jalankan perintah berikut, dan ganti PROJECT_ID dengan ID project Google Cloud Anda:

    gcloud auth application-default login
--project=PROJECT_ID

  2. Saat diminta, pilih akun, lalu klik Lanjutkan.

Mengonfigurasi aplikasi AI Anda

Setelah diautentikasi, langkah terakhir adalah memberikan detail konfigurasi server ke aplikasi AI Anda. Meskipun struktur JSON yang tepat bervariasi menurut aplikasi, Anda dapat menggunakan contoh berikut sebagai template.

  1. Untuk mengonfigurasi Gemini CLI atau Gemini Code Assist, edit atau buat salah satu file konfigurasi berikut:

    • Di project Anda: .gemini/settings.json
    • Di direktori utama Anda: ~/.gemini/settings.json
    {
  "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"
      }
    }
  }
}

    Untuk memeriksa apakah server MCP berfungsi seperti yang diharapkan, lanjutkan ke memverifikasi penginstalan.

Kredensial Manual

Mengonfigurasi layar izin OAuth

Konfigurasi layar izin OAuth project dan tambahkan diri Anda sebagai pengguna pengujian. Jika Anda telah menyelesaikan langkah ini untuk project Google Cloud, lanjutkan ke langkah berikutnya.

  1. Buka halaman ringkasan Auth di konsol Google Cloud, lalu klik Mulai.
  2. Masukkan Nama aplikasi, pilih Email dukungan Anda, lalu klik Berikutnya.
  3. Di bagian Audience, pilih External, lalu klik Next.
  4. Masukkan alamat email Anda di bagian Informasi kontak, lalu klik Berikutnya.
  5. Tinjau dan setujui Kebijakan Data Pengguna Layanan Google API, lalu klik Lanjutkan.
  6. Klik Buat.

Menambahkan pengguna pengujian

  1. Di Google Auth Platform, klik Audience.
  2. Di bagian Pengguna pengujian, klik Tambahkan pengguna.
  3. Masukkan alamat email Anda dan pengguna uji resmi lainnya, lalu klik Simpan.

Buat klien OAuth

Untuk mengautentikasi sebagai pengguna akhir dan mengakses data pengguna di aplikasi Anda, Anda perlu membuat ID Klien OAuth 2.0. Client ID digunakan untuk mengidentifikasi aplikasi tunggal ke server OAuth Google.

  1. Di Google Auth Platform, klik Clients.
  2. Klik Buat klien.
  3. Dari pemilih Application type, pilih Desktop app.
  4. Di kolom Name, ketik nama untuk kredensial. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Klik Buat. Layar klien OAuth yang dibuat akan muncul, menampilkan Client ID dan Rahasia klien baru Anda.
  6. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0.
  7. Klik client ID yang baru Anda buat. Di bagian Rahasia klien, klik ikon download untuk menyimpan file JSON. Anda akan menggunakan nilai client_id dan client_secret dalam file ini di langkah berikutnya.

Mengonfigurasi aplikasi AI Anda

Selanjutnya, Anda perlu memberikan detail konfigurasi server ke aplikasi AI. Meskipun rangkaian langkah yang tepat bervariasi menurut aplikasi, Anda dapat menggunakan contoh berikut sebagai template.

Untuk mengonfigurasi Antigravity agar menggunakan server MCP:

  1. Di Antigravity, klik menu Additional options di panel Agent > MCP Servers > Manage MCP Servers.

  2. Di bagian atas panel Manage MCP Servers yang terbuka, klik View raw config untuk mengedit file mcp_config.json:

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

  3. Kembali ke Manage MCP servers, lalu klik Refresh.

Menambahkan kredensial OAuth

Saat pertama kali Anda mencoba menggunakan server MCP Pengetahuan Developer, asisten AI akan meminta Anda menyelesaikan penyiapan:

  1. Minta agen untuk menggunakan server MCP Pengetahuan Developer dengan perintah seperti:

    How do I list Cloud Storage buckets?

  2. Jika Anda melihat pesan yang meminta Anda untuk mendaftarkan satu atau beberapa URI pengalihan, klik opsi untuk melanjutkan. Karena Anda menyiapkan client ID sebagai aplikasi Desktop, Anda tidak perlu menambahkan URI tertentu ini di Platform Google Auth.

  3. Saat asisten AI meminta Client ID dan Client Secret, tempel setiap kunci yang sesuai dari file JSON rahasia klien yang Anda simpan sebelumnya.

  4. Saat diminta, pilih akun, lalu klik Lanjutkan.

  5. Kembali ke asisten AI Anda. Sekarang, agen akan memproses permintaan Anda menggunakan server yang baru diautentikasi.

Melakukan autentikasi menggunakan kunci API

Bagian ini memandu Anda dalam proses mengautentikasi aplikasi AI dengan server MCP Pengetahuan Developer menggunakan kunci API.

Langkah 1: Buat kunci API

Anda dapat membuat kunci API Developer Knowledge di project Google Cloud menggunakan Konsol Google Cloud atau gcloud CLI:

Konsol Google Cloud

Mengaktifkan API

  1. Buka halaman Developer Knowledge API di library API Google.
  2. Periksa apakah Anda telah memilih project yang benar untuk menggunakan API.
  3. Klik Enable. Tidak ada peran IAM tertentu yang diperlukan untuk mengaktifkan atau menggunakan API.

Membuat dan mengamankan kunci API

  1. Di Konsol Google Cloud untuk project tempat Anda mengaktifkan API, buka halaman Kredensial.
  2. Klik Create credentials, lalu pilih API key dari menu. Dialog API key created akan menampilkan string untuk kunci yang baru dibuat.
  3. Klik Edit kunci API.
  4. Di kolom Name, berikan nama untuk kunci.
  5. Pada bagian Pembatasan API, pilih Batasi kunci.
  6. Dari daftar Select APIs, aktifkan Developer Knowledge API, lalu klik OK.
    • Catatan: Jika Anda baru saja mengaktifkan Developer Knowledge API, mungkin ada penundaan sebelum API tersebut muncul di daftar Select APIs.
  7. Klik Simpan.

Setelah kunci dibuat, klik Show key untuk melihatnya. Catat untuk digunakan saat mengonfigurasi aplikasi AI Anda.

gcloud CLI

  1. Jika Anda belum melakukannya, download dan instal gcloud CLI.

  2. Aktifkan Developer Knowledge API, dengan mengganti PROJECT_ID dengan ID project Google Cloud Anda:

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

  3. Buat kunci API menggunakan ID project Google Cloud yang sama:

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

    Perintah ini menampilkan string kunci API. Catat untuk digunakan saat mengonfigurasi aplikasi AI Anda.

  4. Amankan kunci API Anda dengan menambahkan pembatasan kunci API. Untuk keamanan yang lebih baik, batasi kunci API ke Developer Knowledge API.

Langkah 2: Aktifkan server MCP Pengetahuan Developer dalam project

Untuk mengaktifkan server MCP Developer Knowledge di project Google Cloud Anda, download dan instal gcloud CLI, lalu jalankan perintah berikut, dengan mengganti PROJECT_ID dengan ID project Google Cloud Anda:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Jika layanan Developer Knowledge belum diaktifkan untuk project Google Cloud Anda, Anda akan diminta untuk mengaktifkan layanan tersebut sebelum mengaktifkan server MCP jarak jauh.

Sebagai praktik terbaik keamanan, sebaiknya aktifkan server MCP hanya untuk layanan yang diperlukan agar aplikasi AI Anda berfungsi.

Langkah 3: Konfigurasi aplikasi AI Anda

Konfigurasi aplikasi AI populer menggunakan petunjuk ini. Ganti YOUR_API_KEY dengan kunci API Developer Knowledge yang Anda buat di langkah sebelumnya:

Gemini CLI

Untuk mengonfigurasi Gemini CLI, jalankan perintah berikut:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

Atau, edit atau buat salah satu file konfigurasi berikut:

  • Di project Anda: .gemini/settings.json
  • Di direktori utama Anda: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Untuk mengonfigurasi Gemini Code Assist, edit atau buat salah satu file konfigurasi berikut:

  • Di project Anda: .gemini/settings.json
  • Di direktori utama Anda: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Untuk mengonfigurasi Claude Code, jalankan perintah berikut di folder aplikasi Anda.

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 (untuk project tertentu) atau ~/.cursor/mcp.json (untuk semua project).

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

GitHub Copilot

Untuk mengonfigurasi GitHub Copilot di VS Code untuk satu project, edit file .vscode/mcp.json di ruang kerja Anda.

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

Agar server tersedia di setiap project, edit setelan pengguna Anda. Klik tombol Open Settings (JSON).

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

Selancar Angin

Untuk mengonfigurasi Windsurf Editor, edit file ~/.codeium/windsurf/mcp_config.json.

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

Verifikasi penginstalan

Setelah dikonfigurasi, buka aplikasi AI Anda dan masukkan perintah seperti:

How do I list Cloud Storage buckets?

Jika Anda melihat panggilan alat ke search_documents atau alat server MCP Pengetahuan Developer lainnya, server berfungsi dengan benar.

Mengelola penggunaan token

Mengambil konten dokumen–terutama saat menggunakan batch_get_documents–menggunakan token dalam jendela konteks aplikasi AI Anda. Karena beberapa halaman dokumentasi developer Google cukup besar, pengambilan beberapa dokumen dapat dengan cepat menyebabkan biaya yang lebih tinggi, waktu respons model yang lebih lambat, dan jendela konteks meluap.

Untuk mengoptimalkan performa dan menghindari tagihan yang tidak terduga, buat perintah spesifik yang hanya menargetkan informasi yang Anda butuhkan. Hindari permintaan yang terlalu luas (misalnya, "Bandingkan semua produk Firebase") yang memaksa agen untuk memproses sejumlah besar data sekaligus.

Dokumentasi yang disertakan

Lihat Referensi korpus untuk mengetahui informasi tentang dokumen mana yang dicari oleh server.

Batasan umum

  • Cakupan Konten: Hanya halaman yang dapat dilihat secara publik di Referensi korpus yang disertakan. Konten dari sumber lain seperti GitHub, situs OSS, blog, atau YouTube tidak disertakan.
  • Hasil hanya dalam bahasa Inggris: Server hanya mendukung hasil dalam bahasa Inggris.
  • Bergantung pada jaringan: Alat server mengandalkan layanan Google Cloud aktif. Jika Anda mengalami error yang terus berlanjut, periksa koneksi internet dan konfigurasi kunci API Developer Knowledge Anda.

Pemecahan masalah

Jika Anda mengalami masalah, pastikan hal berikut:

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.