Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Ekstensi PostgreSQL dapat mendaftarkan definisi server Protokol Konteks Model (MCP) di host yang didukung dengan dukungan AI. Pendaftaran tersebut memungkinkan host menemukan alat PostgreSQL untuk manajemen koneksi, eksplorasi skema, eksekusi kueri, dan alur kerja terkait tanpa meminta Anda untuk mengonfigurasi setiap alat dengan tangan.
Gunakan halaman ini ketika Anda ingin memahami cara kerja dukungan MCP dalam ekstensi, host apa yang didukung hari ini, dan keluarga alat mana yang tersedia setelah pendaftaran.
Prerequisites
Sebelum Anda mengandalkan server MCP, pastikan Anda memiliki:
- Ekstensi PostgreSQL yang diinstal di Visual Studio Code atau Cursor.
- Fitur Copilot/AI yang diaktifkan di ekstensi (
pgsql.copilot.enableadalahtrue). ID setelan tetap mempertahankan prefikspgsql.copilot.*-nya di kedua editor; label ditampilkan sebagai AI di Cursor. - Setidaknya satu profil koneksi tersimpan jika Anda ingin alat MCP tersambung ke server dengan cepat.
- Host yang didukung yang menyediakan API pendaftaran MCP.
Memahami cara kerja pendaftaran MCP
Ekstensi mendaftarkan server MCP secara otomatis ketika semua hal berikut ini benar:
- Host mengekspos API pendaftaran MCP yang didukung.
- Ekstensi dapat mengambil URL server MCP yang valid dan token pembawa dari layanan bahasanya.
- integrasi Copilot diaktifkan.
Hari ini, jalur kode secara eksplisit mendukung:
- Visual Studio Code 1.102 dan yang lebih baru melalui API penyedia definisi server MCP
-
Cursor melalui API MCP Cursor
registerServer
Dalam Visual Studio Code, ekstensi mendaftarkan server sebagai PostgreSQL MCP. Di Kursor, ia mendaftarkan server sebagai pgsql-mcp.
Important
Ekstensi saat ini belum menyediakan alur penyiapan manual dengan salin-tempel untuk klien mandiri yang mengharuskan Anda memasukkan sendiri URL MCP dan token. Jika klien Anda tidak mendukung penemuan atau pendaftaran tingkat host, gunakan alur kerja AI bawaan ekstensi sebagai gantinya.
Menyiapkan profil koneksi untuk alat MCP
Alur MCP yang paling berguna bergantung pada informasi koneksi yang disimpan.
- Buka Koneksi dan identitas dan buat atau perbarui profil koneksi yang Anda inginkan untuk digunakan host.
- Simpan kredensial di mana alur kerja Anda memerlukannya.
- Verifikasi bahwa Anda dapat menyambungkan ke database target dari ekstensi sebelum mengandalkan otomatisasi berbasis MCP.
Ini penting karena alat MCP yang berorientasi pada koneksi menentukan profil target dari penyimpanan koneksi milik ekstensi, bukan dari konfigurasi database terpisah di host AI.
Menggunakan alat MCP di host yang didukung
Setelah host mendeteksi server MCP PostgreSQL, host tersebut dapat memanggil antarmuka alat yang disediakan oleh ekstensi.
| Kelompok alat | Hal yang dibantu | Kegunaan umum |
|---|---|---|
| Mencantumkan Profil Koneksi | Menemukan profil yang disimpan | Temukan profil yang tepat sebelum menyambungkan |
| Menyambungkan ke Database PostgreSQL | Membuka sesi database dari profil yang disimpan | Memulai tugas di server atau database yang tepat |
| Daftar Database | Menghitung database di server yang tersambung | Beralih konteks atau memeriksa database yang tersedia |
| Mendapatkan Objek Database | Mengambil konteks skema | Mengidentifikasi tabel, tampilan, fungsi, dan objek lainnya sebelum mengajukan pertanyaan tindak lanjut |
| Menjalankan Kueri | Jalankan SQL berorientasi baca | Memeriksa data atau memvalidasi asumsi |
| Ubah Basis Data | Menjalankan perubahan data atau skema | Menerapkan DDL atau DML dalam alur kerja yang memerlukan akses tulis |
| Buka Skrip SQL | Membuat skrip untuk ditinjau | Beralih dari hasil agen ke alur editor kueri yang ditinjau oleh manusia |
| Rencana Kueri | Periksa data rencana yang tersimpan dalam cache | Menganalisis alur kerja performa |
| Memvisualisasikan Skema Database | Merender tampilan skema | Memahami hubungan sebelum menulis atau mengubah SQL |
| Dapatkan Konteks Dasbor | Mengambil konteks sesi dasbor aktif, termasuk metrik dan konfigurasi yang tersedia | Menemukan metrik mana yang tersedia sebelum meminta data metrik |
| Mendapatkan Data Metrik Dasbor | Mengambil data rangkaian waktu yang di-cache batch dari dasbor server terbuka | Menganalisis tren performa server tanpa menjalankan kueri langsung |
Tip
Untuk alur kerja yang lebih aman, mulailah dengan alat penemuan seperti Profil Koneksi Daftar, Sambungkan ke Database PostgreSQL, dan Dapatkan Objek Database sebelum Anda menjalankan kueri atau modifikasi.
Pilih antara MCP dan pengalaman AI bawaan
Gunakan server MCP saat host Anda mendukung penemuan MCP dan Anda ingin ekstensi mengekspos permukaan alat PostgreSQL-nya di sana.
Gunakan pengalaman ekstensi bawaan saat:
- Anda ingin mengobrol langsung dengan peserta obrolan @pgsql (hanya Visual Studio Code),
- Anda menginginkan otomatisasi multi-langkah di dalam mode Agen (Visual Studio Code dan Kursor), atau
- host Anda saat ini tidak menampilkan pendaftaran MCP milik ekstensi secara otomatis.
Mengatasi masalah ketersediaan MCP
Host tidak menampilkan server MCP PostgreSQL
Konfirmasikan bahwa Anda menjalankan host yang didukung dan integrasi Copilot/AI diaktifkan dalam ekstensi. Jika diperlukan, muat ulang jendela setelah Anda masuk atau mengubah pengaturan Copilot/AI.
Pendaftaran dilewati
Ekstensi melewati pendaftaran ketika tidak dapat mengambil URL atau token MCP yang dapat digunakan dari layanan bahasa. Periksa log output ekstensi jika host tidak pernah menemukan server setelah memuat ulang.
Alat tidak dapat tersambung ke database saya
Verifikasi bahwa profil koneksi target ada dan ekstensi dapat menggunakannya secara langsung. Alur MCP bergantung pada penyimpanan koneksi dan resolusi kredensial yang sama dengan ekstensi lainnya.
Saya memerlukan titik akhir manual untuk klien MCP lain
Saat ini, ekstensi tersebut tidak menyediakan alur kerja endpoint manual untuk pengguna bagi klien MCP mandiri. Gunakan host yang didukung atau kembali ke pengalaman AI bawaan yang didokumenkan dalam kumpulan dokumen ini.