Menghubungkan ke server Model Context Protocol (MCP)

Server MCP menyediakan alat dan sumber data tambahan untuk Gemini. Misalnya, dengan menambahkan server Firebase MCP, Anda dapat menggunakan bahasa alami untuk menjelajahi data Cloud Firestore saat membangun atau men-debug aplikasi.

Prasyarat

Jika diperlukan oleh server MCP, pastikan Anda memiliki penginstalan Node.js dan npm yang berfungsi.

Memilih server MCP yang kompatibel

Firebase Studio memiliki dukungan dasar untuk server MCP, tetapi tidak semua server MCP kompatibel. Saat memilih server MCP, perhatikan detail kompatibilitas berikut:

  • Didukung:

    • Server input/output (stdio) standar atau Server-Sent Events (SSE)/Server transpor HTTP yang dapat di-stream
    • Autentikasi kunci API menggunakan header HTTP atau variabel lingkungan
    • Alat yang disediakan oleh server MCP

  • Tidak didukung:

    • Server yang memerlukan antarmuka pengguna grafis atau sesi desktop
    • Perintah, pengambilan sampel, atau resource lain yang disediakan oleh server MCP

Menambahkan server MCP

Untuk menambahkan server MCP, Anda perlu membuat atau mengedit file konfigurasinya.

Langkah 1: Buat file konfigurasi

Percakapan interaktif dan Gemini CLI dapat terhubung ke server MCP, tetapi menggunakan file konfigurasi yang berbeda:

  • Chat interaktif menggunakan .idx/mcp.json.
  • Gemini CLI menggunakan .gemini/settings.json.

Buat satu atau kedua file menggunakan petunjuk berikut.

Chat interaktif

Dalam tampilan Code, buat .idx/mcp.json menggunakan salah satu metode berikut:

  • Palet Perintah: Buka Palet Perintah (Shift+Ctrl+P), lalu gunakan perintah Firebase Studio: Add MCP Server.
  • Chat interaktif: Klik Menyesuaikan ikon alat Sesuaikan Alat di chat interaktif, lalu pilih Tambahkan server MCP.
  • Explorer: Dari Explorer (Ctrl+Shift+E), klik kanan direktori .idx, lalu pilih New file. Beri nama file mcp.json.

Gemini CLI

Di tampilan Code, buat .gemini/settings.json:

  1. Di Explorer (Ctrl+Shift+E), periksa apakah direktori .gemini ada. Jika tidak, klik kanan panel Explorer, lalu pilih Folder baru. Beri nama folder .gemini.
  2. Klik kanan direktori .gemini, lalu pilih New file. Beri nama file settings.json.

Untuk mengetahui detail tentang cara menggunakan server MCP dengan Gemini CLI, tinjau dokumentasi lengkapnya.

Langkah 2: Edit konfigurasi server

  1. Buka file konfigurasi server.

  2. Tambahkan konfigurasi server ke konten file. Misalnya, untuk menambahkan server Firebase MCP, masukkan:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "experimental:mcp"
      ]
    }
  }
}

    File konfigurasi ini menginstruksikan Gemini terkait server MCP mana yang ingin Anda gunakan. Contoh ini menunjukkan satu server bernama firebase yang akan menggunakan perintah npx untuk menginstal dan menjalankan firebase-tools@latest.

    Jika server MCP Anda memerlukan autentikasi kunci API, Anda dapat mengonfigurasinya dengan salah satu cara berikut:

    • Untuk server MCP HTTP jarak jauh yang memerlukan kunci API di header permintaan, gunakan kolom headers. Misalnya, untuk mengonfigurasi server MCP GitHub:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • Untuk server MCP stdio lokal yang memerlukan kunci API dalam variabel lingkungan, gunakan kolom env. Misalnya, untuk mengonfigurasi build lokal server MCP GitHub:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

  3. Di terminal (Shift+Ctrl+C), jalankan perintah yang diperlukan untuk menyelesaikan penginstalan. Misalnya, untuk menggunakan server Firebase MCP, masukkan perintah berikut untuk login ke akun Anda:

    firebase login --no-localhost

    Ikuti petunjuk di terminal untuk mengizinkan sesi. Beberapa alat memerlukan project Firebase yang terhubung. Anda dapat menggunakan server Firebase MCP untuk membuat project, atau Anda dapat menjalankan perintah berikut untuk menginisialisasi project Firebase:

    firebase init

    Tindakan ini akan membuat file firebase.json di direktori root Anda.

Menggunakan alat MCP

Setelah menginstal server MCP yang ingin Anda gunakan, alat atau data yang disediakan tersedia di:

  • Gemini CLI
  • Chat interaktif saat menggunakan Mode agen dan Mode agen (Jalankan otomatis)
  • App Prototyping agent

Misalnya, jika Anda menambahkan server MCP Firebase, Anda dapat meminta Gemini untuk mengambil konfigurasi SDK untuk project saat ini, mengambil data yang disimpan di Cloud Firestore dan Realtime Database, membantu Anda menyiapkan layanan Firebase, dan lainnya.

Dalam percakapan interaktif, ketik / untuk melihat daftar perintah MCP yang tersedia.

Daftar perintah MCP yang tersedia

Memeriksa atau menyesuaikan alat

Anda dapat mengelola alat mana yang aktif dalam chat interaktif:

  1. Klik Menyesuaikan ikon alat Sesuaikan Alat dalam percakapan interaktif untuk melihat daftar semua alat yang tersedia dari server MCP yang dikonfigurasi.
  2. Gunakan kotak centang untuk mengaktifkan atau menonaktifkan seluruh server atau alat individual.

Daftar alat MCP yang tersedia

Memecahkan masalah server MCP

Jika Anda mengalami masalah dengan server MCP, gunakan langkah-langkah berikut untuk mendiagnosis masalah.

Periksa log untuk mengetahui error

  1. Buka panel Output (Shift+Ctrl+U).
  2. Di menu drop-down, pilih Gemini.
  3. Periksa pesan yang diawali dengan tag [MCPManager]. Log ini menunjukkan server mana yang dikonfigurasi, alat mana yang berhasil ditambahkan, dan pesan error.

Membangun ulang lingkungan

Jika server MCP gagal diinstal atau terhubung, coba bangun kembali ruang kerja Anda:

  1. Buka Palet Perintah (Shift+Ctrl+P).
  2. Jalankan perintah Firebase Studio: Rebuild Environment.
  3. Setelah ruang kerja dibangun kembali, periksa apakah server MCP terhubung.

Jika alat tidak digunakan

Jika server MCP terhubung, tetapi Gemini tidak menggunakan alatnya:

  • Mulai sesi percakapan baru: Tindakan ini memastikan Gemini mengambil konfigurasi alat terbaru. Pelajari cara mengelola histori chat.
  • Berikan perintah yang spesifik: Jika Gemini dapat menyelesaikan tugas tanpa menggunakan alat MCP, Gemini mungkin akan mencoba metode lain. Jika Anda ingin menggunakan alat tertentu, coba sebutkan nama alat tersebut. Misalnya: "Gunakan firebase_get_sdk_config untuk mendapatkan konfigurasi SDK untuk project saat ini."
  • Bergabunglah dengan Google Developer Program: Periksa apakah akun Anda terdaftar.

Langkah berikutnya