Menyambungkan Kode Genie ke server MCP

Genie Code terhubung ke alat, dokumen, dan data eksternal melalui server Model Context Protocol (MCP) dan konektor asli untuk Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack, dan GitHub. Gunakan konektor asli untuk sumber SaaS umum, atau tambahkan server MCP eksternal atau kustom Anda sendiri dari ruang kerja. Anda memilih alat mana yang akan diaktifkan di pengaturan Kode Genie.

Apa itu MCP?

MCP adalah standar sumber terbuka yang menghubungkan agen ke alat, sumber daya, permintaan, dan informasi kontekstual lainnya. MCP menyediakan cara standar untuk mengekspos alat, data, dan alur kerja ke Kode Genie tanpa menyematkan konteks tersebut langsung ke dalam perintah atau instruksi.

MCP dirancang untuk kasus di mana konteks penting sudah ada tetapi sulit diakses dari agen, seperti Genie Code. MCP menawarkan cara yang aman untuk memberikan akses Kode Genie ke konteks seperti berikut:

  • Sistem dokumentasi: Teams sering menyimpan runbook atau dokumen operasional dalam alat seperti Confluence. Alih-alih menyalin bagian ke dalam perintah, konten tersebut dapat diekspos sekali melalui server MCP eksternal dan direferensikan jika relevan. Dokumen Anda mungkin juga sudah berada di Databricks sebagai indeks Pencarian AI, yang dapat digunakan Kode Genie untuk mengkueri dokumen yang relevan.
  • Alat dan layanan: Tim platform mungkin mempertahankan API atau skrip untuk penyiapan, validasi, atau penyebaran. MCP membuat kemampuan tersebut tersedia langsung untuk Genie Code.
  • Sumber data: Jika Anda sudah memiliki data di Databricks, Anda dapat menyambungkan Kode Genie ke Agen Genie untuk membantu Anda menganalisis data menggunakan bahasa alami. Untuk data yang disimpan di luar Databricks, Anda dapat memberikan akses aman Genie Code melalui server MCP eksternal.
  • Aplikasi kustom: Anda juga dapat menambahkan fungsionalitas kustom yang dihosting melalui Aplikasi Databricks. Ini memungkinkan Anda untuk menghubungkan Kode Genie ke alat kepemilikan, alur kerja, atau integrasi yang dibangun khusus untuk Anda atau organisasi Anda, semuanya dikelola dengan aman dalam ruang kerja Databricks Anda.

Dalam kasus ini, MCP mengganti copy-pasting manual dengan pendekatan terstruktur dan dapat digunakan kembali, membuat konteks yang tepat hanya tersedia ketika diperlukan.

Anda dapat menyambungkan Kode Genie ke server MCP apa pun di ruang kerja yang memiliki izin untuk digunakan. Administrator ruang kerja mengontrol server mana yang tersedia, sementara pengguna dapat memilih dari sumber yang disetujui sesuai kebutuhan.

Untuk mempelajari lebih lanjut tentang server MCP di Databricks dan cara membuat server sendiri, lihat MCP dan alat agen.

Menggunakan konektor asli untuk sumber data pihak ketiga

Genie Code menyediakan konektor bawaan untuk sumber data perusahaan umum:

  • Google Drive: Cari dan buat Google Docs, Sheets, dan Slides; edit Docs yang dibuatnya.
  • Gmail: Cari, baca, dan draf email.
  • Google Calendar: Cari dan buat acara kalender.
  • Microsoft 365: Cari SharePoint, Teams, Outlook, dan Kalender; buat draf email Outlook.
  • Atlassian: Cari dan perbarui Jira dan Confluence.
  • Glean (Beta): Cari di seluruh aplikasi organisasi Anda yang terhubung menggunakan Glean.
  • Slack: Cari pesan dan saluran Slack, serta kirim pesan.
  • GitHub: Cari dan perbarui repositori, masalah, dan pull request.

Menghubungkan ke sumber data ini memungkinkan Genie Code mencari dokumen Anda dan mengambil tindakan di alat terkait saat menjawab pertanyaan. Setiap pengguna mengautentikasi satu per satu, dan token OAuth tidak dibagikan antar pengguna.

Koneksi ini menggunakan konektor MCP yang disediakan Databricks, sehingga tidak ada server untuk dihosting dan tidak ada aplikasi OAuth untuk mendaftar. Azure Databricks mengatur setiap koneksi melalui Unity Catalog dan Unity Gateway. Gateway mengotorisasi setiap panggilan alat terhadap izin Unity Catalog Anda, menerapkan kebijakan bawaan dan persyaratan persetujuan, serta merekam log penggunaan dan audit dalam tabel sistem. Lihat Daftarkan server MCP eksternal.

Untuk menyambungkan sumber data pihak ketiga:

  1. Di ruang kerja Anda, klik ikon kode Sparkle Genie Genie Code di sudut kanan atas untuk membuka obrolan.
  2. Di bilah perintah, klik Ikon baru. ikon plus.
  3. Di samping sumber data yang ingin Anda sambungkan, klik Sambungkan.
  4. Selesaikan langkah-langkah untuk masuk.

Setelah Anda mengautentikasi, Genie Code dapat mencari dokumen Anda saat menjawab pertanyaan. Administrator metastore dan pemilik koneksi dapat mengelola atau mencabut izin pengguna pada koneksi. Lihat Langkah 4. Berikan akses ke Layanan MCP.

Nota

Alat sumber data tidak selalu memicu secara otomatis. Jika penelusuran dokumen tidak dimulai, coba minta Genie Code secara eksplisit untuk menggunakan alat ini, misalnya "gunakan Google Docs" atau "gunakan SharePoint".

Untuk menyambungkan sumber data lain, tambahkan secara manual ke Kode Genie. Lihat Menambahkan server MCP ke Kode Genie secara manual.

Tugas terjadwal dan autentikasi

  • Genie Code tidak memberi peringatan saat autentikasi koneksi berakhir. Anda mungkin hanya mengetahuinya ketika panggilan alat gagal atau saat membuka daftar koneksi. Autentikasi ulang untuk mengatasinya.
  • Mengubah izin koneksi mengharuskan setiap pengguna melakukan autentikasi ulang. Tugas terjadwal yang menggunakan koneksi gagal sampai pengguna melakukan autentikasi ulang.

Batasan Google Drive

  • Saat mengotorisasi Google Drive, Anda mungkin melihat layar "aplikasi yang belum diverifikasi". Klik Tingkat Lanjut dan lanjutkan proses otorisasi.
  • Ukuran file maksimum adalah 25 MB.
  • Hanya file Google Workspace asli (Dokumen, Spreadsheet, Slide) yang didukung. PDF, gambar, dan format biner lainnya tidak didukung.
  • Genie Code dapat membuat Google Docs, Sheets, dan Slides, serta mengedit Google Docs yang dibuat melalui konektor. Dokumen yang dibuat di luar konektor tidak bisa diedit, atau mengedit Sheet atau Slide yang sudah ada.
  • Membaca dokumen yang sangat besar bisa terasa lambat.

Nota

Penggunaan dan transfer data pengguna mentah atau turunan yang diterima dari API Google Workspace akan mematuhi Kebijakan Data Pengguna layanan Google API, termasuk persyaratan Penggunaan Terbatas.

Keterbatasan Gmail

  • Genie Code dapat mencari, membaca, dan membuat draft email, tetapi tidak dapat mengirim email atau mengedit pesan yang sudah ada.
  • Genie Code tidak dapat menambahkan file Drive sebagai lampiran asli Gmail. Sebagai solusi sementara, sertakan tautan ke file di isi email.

Batasan Microsoft 365

  • Termasuk SharePoint, Teams, Outlook, dan Kalender.
  • Genie Code bisa membuat draft email Outlook tapi tidak bisa dikirim.
  • Ukuran file maksimum adalah 25 MB untuk file SharePoint.
  • Jenis file SharePoint yang didukung meliputi dokumen Office (.docx, .xlsx, .pptx), serta format berbasis teks umum seperti .txt, .csv, .json, .md, dan lainnya. PDF, gambar, dan format biner lainnya tidak didukung.

Keterbatasan Glean (Beta)

  • Glean hanya untuk pencarian. Ia tidak bisa membaca dokumen dari tautan langsung.
  • Administrator metastore harus terlebih dahulu mengonfigurasi ID tenant Glean sebelum pengguna non-administrator dapat menggunakan koneksi tersebut. Administrator dapat memasukkan ID penyewa saat pertama kali menyambungkan ke Glean.
  • Untuk terhubung ke server Glean MCP tertentu, administrator metastore dapat secara opsional mengatur jalur server MCP (misalnya, /mcp/eng) saat menyiapkan koneksi. Biarkan bidang ini kosong untuk menggunakan jalur default (/mcp/default). Pengguna non-administrator tidak dapat menentukan atau mengubah jalur server Glean MCP.

Keterbatasan Slack

  • Kode Genie tidak dapat mengedit atau menghapus pesan setelah dikirim.

batasan GitHub

  • Penulisan dibatasi pada isi file, masalah, dan pull request.
  • Secara default, konektor Databricks GitHub MCP hanya dapat mengakses repositori publik. Untuk memberi konektor akses baca ke repositori perusahaan privat Anda, administrator organisasi GitHub harus menyelesaikan penyiapan tambahan. Lihat Mengaktifkan akses repositori privat.
  • GitHub Enterprise Server (versi GitHub yang dihost sendiri) tidak didukung.

Menambahkan server MCP ke Kode Genie secara manual

Untuk menyambungkan Kode Genie ke server MCP, tambahkan di pengaturan Kode Genie Anda:

  1. Buka pengaturan Kode Genie. Di panel Kode Genie, klik ikon roda gigi. Pengaturan.
  2. Di bawah Server MCP, klik Ikon baru. Tambahkan Server.
  3. Pilih server MCP yang ingin Anda tambahkan. Anda dapat memilih server MCP terkelola Databricks atau server MCP eksternal:
    • Fungsi Katalog Unity: Pilih skema untuk fungsi tersebut. Ini memungkinkan Genie Code menggunakan fungsi untuk menjalankan kueri SQL yang telah ditentukan sebelumnya.
    • Pencarian AI: Pilih skema untuk indeks. Ini memungkinkan Genie Code untuk mengkueri indeks Pencarian AI untuk menemukan dokumen yang relevan.
    • Agen Genie: Pilih Agen Genie. Genie MCP memanggil Genie sebagai alat, memungkinkan Anda mengkueri Agen Genie untuk menganalisis data menggunakan bahasa alami.
    • Server MCP eksternal: Pilih koneksi Katalog Unity untuk digunakan sebagai server MCP eksternal. Anda harus masuk ke koneksi terlebih dahulu sebelum dapat digunakan.
    • Server MCP kustom: Pilih Aplikasi Databricks untuk digunakan sebagai server MCP kustom. Ini memungkinkan Anda menggunakan alat yang telah ditentukan sendiri. Persyaratan berikut berlaku:
      • Aplikasi Anda harus disebarkan di ruang kerja yang sama dengan tempat Anda mencoba menyambungkannya.
      • Server MCP harus diakses di https://<server-url>/mcp.
      • Aplikasi Anda harus stateless. Misalnya, atur mcp_app = mcp_server.http_app(stateless_http=True).
      • Jika mengalami kesalahan CORS, Anda mungkin perlu menambahkan URL ruang kerja ke daftar asal yang diizinkan aplikasi Anda. Misalnya, atur app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
  4. Kliklah Simpan.

Setelah ditambahkan, server MCP segera tersedia untuk Genie Code. Anda dapat mulai menggunakannya tanpa mengubah perintah atau instruksi Anda. Genie Code secara otomatis menggunakan server-server ini jika diperlukan.

Anda dapat memilih alat dan server mana yang akan diaktifkan atau dinonaktifkan di pengaturan Kode Genie Anda.

Keterbatasan

Untuk panduan kepatuhan untuk aplikasi yang terhubung, lihat Pembatasan Layanan MCP yang disediakan Databricks.

  • Last updated on