Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Siapkan templat aplikasi Snowflake di ChatGPT

Pelajari cara admin workspace ChatGPT serta pengguna ChatGPT Plus atau ChatGPT Pro menghubungkan ChatGPT ke server MCP yang dikelola Snowflake.

Diperbarui: 25 days ago

Gunakan panduan ini jika Anda adalah admin workspace ChatGPT atau pengguna ChatGPT Plus atau Pro yang ingin menghubungkan ChatGPT ke Snowflake melalui server MCP yang dikelola Snowflake.

Sebagian besar penyiapan dilakukan di Snowflake. Setelah Snowflake siap, selesaikan koneksi templat Snowflake di ChatGPT, lalu aktifkan plugin Snowflake yang menggunakan templat tersebut.

  • Oauth bawaan: Jika tersedia untuk akun Snowflake Anda dan di ChatGPT, gunakan aplikasi mitra ChatGPT yang diaktifkan oleh admin Snowflake. Masuk ke Snowflake menggunakan SSO organisasi Anda jika sudah dikonfigurasi. Anda tidak perlu memasukkan ID klien atau rahasia klien di ChatGPT. Ikuti bagian Oauth bawaan di bawah.

  • Klien Oauth kustom: Gunakan metode ini jika organisasi Anda mewajibkan klien Oauth sendiri atau Oauth bawaan tidak tersedia. Ikuti bagian Klien Oauth kustom di bawah.

Kedua metode Oauth memerlukan penyiapan server MCP yang sama, izin untuk objek yang digunakan, serta akses jaringan seperti yang dijelaskan di bawah. Selesaikan langkah penyiapan bersama hingga bagian Masukkan detail server Snowflake di ChatGPT sebelum mengonfigurasi Oauth.

Yang akan Anda siapkan

Anda akan membuat server MCP yang dikelola Snowflake dan berfungsi sebagai endpoint MCP untuk ChatGPT. Server MCP menentukan:

  • Tindakan yang dapat digunakan ChatGPT.

  • Data atau objek Snowflake yang dapat diakses oleh alat tersebut.

  • Peran Snowflake yang digunakan setiap pengguna untuk memberikan otorisasi.

  • Basis data, skema, dan nama server MCP Snowflake yang mengidentifikasi endpoint.

Selanjutnya, konfigurasikan Snowflake - Templat Resmi di ChatGPT dengan URL lengkap server MCP terkelola. Layar penyiapan templat mungkin menampilkan URL dalam empat kolom terpisah:

  • Prefiks host Snowflake.

  • Basis data.

  • Skema.

  • Nama server MCP.

ChatGPT hanya dapat menemukan dan menggunakan alat yang disediakan oleh server MCP dan diizinkan oleh peran Snowflake yang digunakan pengguna untuk memberikan otorisasi.

Sebelum memulai

Anda memerlukan:

  • Akses sebagai admin atau pemilik workspace ChatGPT, atau akses ChatGPT Plus atau Pro.

  • Akses Snowflake yang memungkinkan pembuatan objek server MCP dan pemberian izin.

  • Basis data dan skema Snowflake tempat server MCP akan ditempatkan.

  • Keputusan tentang apa saja yang boleh dilakukan ChatGPT, seperti menggunakan Cortex Search, Cortex Analyst, SQL hanya-baca, atau prosedur atau fungsi tertentu.

  • Peran Snowflake dengan hak akses minimum yang akan digunakan pengguna saat memberikan otorisasi aplikasi.

  • Prefiks host akun Snowflake, termasuk sufiks wilayah atau cloud jika ada.

Jika akun Snowflake Anda membatasi akses melalui kebijakan jaringan atau daftar IP yang diizinkan, minta admin Snowflake untuk mengizinkan koneksi masuk dari rentang IP keluar aplikasi ChatGPT yang berlaku saat ini. Daftar ini bersifat dinamis dan harus selalu diperbarui.

Nilai yang perlu disiapkan

  • Prefiks host Snowflake: seluruh bagian sebelum .snowflakecomputing.com dalam URL akun Snowflake.

  • Database: database yang berisi server MCP.

  • Skema: skema yang berisi server MCP.

  • Nama server MCP: nama objek server MCP Snowflake.

  • URL lengkap server MCP terkelola, jika layar penyiapan ChatGPT meminta URL.

  • Peran Snowflake: peran yang harus digunakan pengguna saat mengotorisasi aplikasi.

  • Daftar alat: objek dan tindakan Snowflake yang ingin Anda gunakan melalui ChatGPT.

Tentukan apa yang dapat dilakukan ChatGPT

Pilih hanya kemampuan yang ingin Anda sediakan. Opsi yang umum digunakan meliputi:

  • Pencarian dengan Cortex Search untuk menemukan jawaban dalam data atau konten Snowflake yang telah diindeks.

  • Tanya jawab dengan Cortex Analyst melalui view semantik yang disetujui.

  • SQL hanya-baca untuk akses kueri yang terkendali.

  • Agen Snowflake, prosedur tersimpan, atau UDF untuk alur kerja tertentu.

Jika Anda mengaktifkan SQL, pertahankan mode hanya-baca kecuali organisasi Anda telah meninjau dan menyetujui akses tulis.

Buka lembar kerja Snowflake

  1. Masuk ke aplikasi Snowflake.

  2. Beralihlah ke peran yang dapat membuat server MCP dan memberikan akses.

  3. Buka Ruang kerja.

    Snowflake navigation menu showing Workspaces selected during MCP server setup.
  4. Buat ruang kerja dengan file SQL.

    Snowflake workspace with a SQL file open for MCP server setup.
  5. Atur konteks ruang kerja ke database dan skema tempat server MCP akan dibuat.

    Snowflake worksheet context picker showing the role, warehouse, database, and schema.

Buat server MCP Snowflake

Di Snowflake, masuk dengan peran yang dapat membuat server MCP dan memberikan akses. Buka lembar kerja di database dan skema tempat server MCP akan dibuat.

Jalankan pernyataan seperti contoh berikut. Ganti nama-namanya dengan nama database, skema, layanan, view, warehouse, dan server Snowflake Anda sendiri.

CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP
FROM SPECIFICATION $$
tools:
- name: "support-search"
type: "CORTEX_SEARCH_SERVICE_QUERY"
identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE"
title: "Support Search"
description: "Search support content for relevant customer issues."
- name: "revenue-analyst"
type: "CORTEX_ANALYST_MESSAGE"
identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW"
title: "Revenue Analyst"
description: "Answer revenue questions using the approved semantic view."
- name: "sql-readonly"
type: "SYSTEM_EXECUTE_SQL"
title: "Read-only SQL"
description: "Run read-only SQL queries against approved Snowflake data."
config:
read_only: true
query_timeout: 600
warehouse: "CHATGPT_WH"
$$;

Snowflake result confirming that the MCP server was successfully created.

Nama alat dan objek Snowflake dalam pernyataan ini adalah contoh:

  • support-search menyediakan akses ke layanan Cortex Search yang ditentukan.

  • revenue-analyst menyediakan akses ke view semantik yang ditentukan. Tambahkan alat untuk view lain sesuai kebutuhan.

  • sql-readonly menyediakan akses SQL hanya-baca dengan warehouse yang ditentukan.

Gunakan nama alat yang tetap dan deskriptif agar ChatGPT dapat memilih alat yang tepat. Membuat server MCP tidak otomatis memberikan akses ke objek Snowflake yang digunakannya.

Untuk opsi spesifikasi tambahan, lihat: Membuat server MCP yang dikelola Snowflake.

Berikan izin Snowflake yang tepat

Pilih peran Snowflake yang akan digunakan pengguna untuk otorisasi, lalu berikan peran tersebut akses ke:

  1. Database dan skema.

  2. Server MCP.

  3. Setiap objek yang digunakan oleh alat, seperti layanan pencarian, view semantik, atau warehouse.

Contoh:

GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;

GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

Jika server MCP menyediakan akses ke UDF, prosedur tersimpan, atau Agen Cortex, berikan juga izin yang diperlukan untuk objek tersebut.

Pastikan Snowflake siap

Jalankan:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

Lalu jalankan:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

Pastikan:

  • Server berada di database dan skema yang diharapkan.

  • Daftar alat sesuai dengan yang Anda inginkan.

  • identifier setiap alat mengarah ke objek Snowflake yang tepat.

  • Peran yang digunakan untuk terhubung memiliki izin USAGE pada server MCP.

  • Peran yang digunakan untuk terhubung memiliki izin yang diperlukan pada setiap objek yang digunakan.

Masukkan detail server Snowflake di ChatGPT

Untuk penyiapan workspace, buka admin.openai.com, pilih workspace ChatGPT yang dituju, lalu buka Plugin. Untuk navigasi workspace dan akses aplikasi lama, lihat Kontrol admin, keamanan, dan kepatuhan untuk plugin dan aplikasi.

  1. Di ChatGPT, beralihlah ke akun atau workspace tempat aplikasi akan tersedia.

  2. Buka Pengaturan > Plugin untuk penyiapan pribadi, atau Konsol Admin > Plugin sebagai admin workspace untuk penyiapan workspace.

  3. Cari Snowflake.

  4. Aktifkan Snowflake - Templat Resmi.

  5. Buka Snowflake - Templat Resmi, masukkan nama koneksi yang jelas, lalu pilih Hubungkan.

  6. Masukkan URL lengkap server MCP terkelola:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

Contoh:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

ChatGPT Snowflake Template connection form with name, managed MCP server URL, and OAuth settings.

Jika layar penyiapan menampilkan konfigurasi Snowflake dalam kolom terpisah, gunakan nilai yang sama dari URL tersebut:

Prefiks host Snowflake

Gunakan seluruh bagian sebelum .snowflakecomputing.com dalam URL akun Snowflake Anda, termasuk sufiks wilayah atau cloud jika ada.

Misalnya, jika URL akun diawali dengan:

https://myorg-myaccount.azure.snowflakecomputing.com

Prefiks host-nya adalah:

myorg-myaccount.azure

Database

Masukkan database yang berisi server MCP, misalnya:

CHATGPT_APPS

Skema

Masukkan skema yang berisi server MCP, misalnya:

TOOLS

Nama server MCP

Masukkan nama objek server MCP Snowflake, misalnya:

CHATGPT_SNOWFLAKE_MCP

Konfigurasikan Oauth

Pilih metode Oauth yang tersedia untuk akun Anda dan memenuhi persyaratan organisasi Anda. Kedua metode menggunakan penyiapan server MCP yang sama di atas, serta pengujian koneksi dan kontrol akses di bawah.

Untuk kedua metode Oauth, saat Anda menggunakan session:role:all, Snowflake menggunakan peran default setiap pengguna. Peran default harus tercantum dalam daftar peran yang diizinkan oleh integrasi Oauth, jika daftar tersebut dikonfigurasi, dan tidak boleh diblokir. Memiliki peran lain yang disetujui tidak membuat peran tersebut dipilih secara otomatis.

Oauth bawaan

Sebelum melanjutkan, selesaikan bagian penyiapan bersama di atas untuk membuat server MCP, memberikan izin, memverifikasi server, dan memasukkan detailnya di ChatGPT. Langkah ini tetap wajib meskipun Anda langsung membuka bagian ini.

Gunakan metode ini hanya jika aplikasi mitra ChatGPT tersedia untuk akun Snowflake Anda dan Oauth bawaan tersedia di dialog penyiapan ChatGPT.

  1. Minta admin Snowflake untuk mengaktifkan integrasi mitra ChatGPT di akun Snowflake yang menghosting server MCP. Gunakan kembali integrasi mitra ChatGPT yang sudah ada dan aktif.

  2. Di dialog penyiapan ChatGPT, gunakan Oauth bawaan. Anda tidak perlu memasukkan ID klien atau rahasia klien maupun mendaftarkan URL callback.

  3. Lanjutkan ke bagian Hubungkan dan kelola Snowflake di bawah untuk masuk, memberikan persetujuan, dan mengonfigurasi akses. Lalu selesaikan bagian Uji aplikasi, termasuk pengujian dengan anggota non-admin yang diizinkan.

Ketentuan peran default, daftar izin, dan peran yang diblokir yang dijelaskan di atas juga berlaku untuk metode ini.

Klien Oauth kustom

Sebelum melanjutkan, selesaikan bagian penyiapan bersama di atas untuk membuat server MCP, memberikan izin, memverifikasi server, dan memasukkan detailnya di ChatGPT. Langkah ini tetap wajib meskipun Anda langsung membuka bagian ini.

Untuk klien Oauth kustom, Anda memerlukan ID klien dan rahasia klien dari Snowflake. Ketentuan peran default, daftar izin, dan peran yang diblokir yang dijelaskan di atas juga berlaku untuk metode ini.

  1. Di dialog penyiapan ChatGPT, pilih Pengaturan Oauth lanjutan > Klien Oauth yang Ditentukan Pengguna, lalu salin URL Callback persis seperti yang ditampilkan di ChatGPT.

  2. Buat integrasi keamanan Oauth kustom dengan OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' dan tetapkan OAUTH_REDIRECT_URI ke URL callback yang sama persis.

  3. Jalankan pernyataan berikut di Snowflake menggunakan nama integrasi dalam huruf kapital:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

  4. Dari hasil JSON, tempelkan oauth_client_id ke ID klien Oauth dan oauth_client_secret ke Rahasia klien Oauth di ChatGPT.

  5. Atur Metode autentikasi endpoint token ke client_secret_basic.

Setelah memasukkan kredensial klien kustom, lanjutkan ke bagian Hubungkan dan kelola Snowflake serta Uji aplikasi di bawah.

Menghubungkan dan mengelola Snowflake

  1. Untuk kedua metode Oauth, di dialog penyiapan ChatGPT yang sama, pilih Lanjutkan, masuk ke Snowflake, lalu izinkan koneksi. Anda dapat menggunakan SSO organisasi jika sudah dikonfigurasi.

  2. Untuk penyiapan workspace, pastikan Snowflake dan Snowflake - Templat Resmi sama-sama diaktifkan. Di Enterprise dan Edu, konfigurasikan kebijakan penginstalan plugin dan Akses pengguna setiap aplikasi yang disertakan untuk peran yang ditetapkan kepada anggota atau grup yang dituju. Di Business, kelola kebijakan penginstalan plugin dan ketersediaan aplikasi di seluruh workspace.

  3. Admin workspace bertanggung jawab meninjau Kontrol tindakan untuk alat yang disediakan.

  4. Admin workspace bertanggung jawab meninjau Izin aplikasi untuk menentukan kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.

Izin aplikasi ini berlaku untuk percakapan ChatGPT. Agen workspace menggunakan kontrol per agen yang ditetapkan oleh pembuatnya untuk menentukan tindakan aplikasi yang tersedia dan kapan pengguna akhir diminta untuk menyetujuinya. Untuk perilaku agen, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.

Uji aplikasi

  1. Buka chat, pilih Snowflake, lalu uji koneksinya.

  2. Pastikan ChatGPT menemukan alat yang Anda konfigurasi.

  3. Jalankan tindakan baca berisiko rendah terlebih dahulu, seperti pencarian atau kueri hanya-baca pada data yang disetujui.

  4. Pastikan izin Snowflake mencegah akses di luar peran dan objek yang disetujui.

  5. Untuk penyiapan workspace, lakukan pengujian dengan anggota non-admin yang diizinkan dan memiliki peran default Snowflake yang berbeda-beda. Koneksi admin yang berhasil tidak menjamin bahwa setiap anggota dapat terhubung.

Bagi admin workspace, mengaktifkan Snowflake saja tidak cukup. Jika Snowflake - Templat Resmi belum diaktifkan dan dihubungkan, plugin mungkin terlihat nonaktif bagi anggota.

URL server MCP dan cara kerja Oauth

ChatGPT terhubung ke URL lengkap server MCP yang dikelola Snowflake:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

ChatGPT menggunakan prefiks host Snowflake dari URL tersebut untuk menentukan endpoint Oauth Snowflake berikut:

  • Otorisasi: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

  • Token: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

Jangan menempelkan URL Snowsight, URL root akun Snowflake saja, atau URL dengan segmen jalur tambahan. URL MCP harus menyertakan /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} dan cocok persis dengan objek Snowflake Anda.

Pemecahan masalah

Snowflake aktif untuk admin tetapi nonaktif untuk anggota

  • Pastikan Snowflake dan Snowflake - Templat Resmi sama-sama diaktifkan di Konsol Admin > Plugin.

  • Buka Snowflake - Templat Resmi dan selesaikan alur Hubungkan. Mengaktifkan templat tanpa menghubungkannya saja tidak cukup.

  • Buka Snowflake dan pastikan templat tersebut muncul sebagai aplikasi yang diperlukannya.

  • Pastikan peran atau grup anggota yang mengalami masalah diizinkan oleh kebijakan penginstalan plugin.

Server MCP tidak ditemukan

  • Periksa kembali URL lengkap server MCP, atau keempat kolom templat jika layar penyiapan Anda memintanya.

  • Pastikan server MCP berada tepat di database dan skema tersebut.

Tidak ada alat yang muncul di ChatGPT

  • Pastikan spesifikasi server MCP menyertakan alat.

  • Pastikan peran memiliki izin USAGE pada server MCP.

Alat muncul tetapi gagal saat digunakan

  • Pastikan peran memiliki izin yang diperlukan pada objek Snowflake yang digunakan, seperti layanan pencarian, view semantik, warehouse, prosedur, atau UDF.

Alat SQL gagal

  • Pastikan nama warehouse sudah benar dan warehouse sedang berjalan.

  • Pastikan peran memiliki izin USAGE pada warehouse.

  • Pastikan read_only: true telah ditetapkan jika Anda menginginkan akses hanya-baca.

Peran ALL yang diminta telah diblokir secara eksplisit

Minta admin Snowflake Anda untuk membandingkan peran default Anda dengan peran yang diizinkan dan diblokir oleh integrasi Oauth. Memiliki peran lain yang diizinkan tidak membuat peran tersebut dipilih secara otomatis. Jika sesuai, ubah peran default ke peran yang disetujui, lalu hubungkan kembali. Mengubah peran default juga memengaruhi sesi Snowflake Anda di luar ChatGPT.

Otorisasi gagal

  • Pastikan pengguna dapat masuk ke Snowflake.

  • Saat menggunakan session:role:all, pastikan peran default pengguna diizinkan oleh integrasi Oauth.

  • Pastikan penyiapan menggunakan alur Oauth MCP yang dikelola Snowflake.

  • Jika Anda menggunakan klien Oauth kustom, pastikan ID Klien dan Rahasia Klien cocok dengan integrasi Oauth Snowflake dan URI pengalihannya sama persis dengan URL Callback yang ditampilkan di ChatGPT.

    Jika Anda menggunakan Oauth bawaan, minta admin Snowflake untuk memeriksa bahwa integrasi mitra ChatGPT tersedia dan diaktifkan di akun yang menghosting server MCP.

Kebijakan jaringan atau daftar IP yang diizinkan di Snowflake memblokir aplikasi

  • Minta admin Snowflake untuk memperbarui kebijakan jaringan atau aturan akses Snowflake.

  • Izinkan koneksi masuk dari rentang IP keluar aplikasi ChatGPT yang berlaku saat ini.

  • Konfigurasikan daftar IP yang diizinkan ini di Snowflake. Daftar ini terpisah dari daftar IP yang diizinkan untuk workspace ChatGPT.

  • Jika memungkinkan, otomatiskan pembaruan dari JSON yang dipublikasikan karena rentang IP dapat berubah.

Masalah koneksi nama host

Gunakan prefiks host Snowflake yang benar. Nama host Snowflake dengan garis bawah dapat menimbulkan masalah; sebaiknya gunakan tanda hubung.

Apakah artikel ini membantu?