Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
PostgreSQL uzantısı, desteklenen yapay zeka özellikli konaklara Model Bağlam Protokolü (MCP) sunucu tanımını kaydedebilir. Bu kayıt, ana bilgisayarın sizden her bir aracı tek tek el ile yapılandırmanızı istemeden bağlantı yönetimi, şema keşfi, sorgu yürütme ve ilgili iş akışları için PostgreSQL araçlarını algılamasını sağlar.
McP desteğinin uzantıda nasıl çalıştığını, bugün hangi konakların desteklendiği ve kayıt sonrasında hangi araç ailelerinin kullanılabilir hale geldiğini anlamak istediğinizde bu sayfayı kullanın.
Prerequisites
MCP sunucusuna güvenmeden önce aşağıdakilere sahip olduğunuzdan emin olun:
- Visual Studio Code veya Cursor’a yüklü PostgreSQL uzantısı.
- Uzantıda etkin olan Copilot/AI özellikleri (
pgsql.copilot.enabletrue). Ayar kimliği ön ekinipgsql.copilot.*her iki düzenleyicide de tutar; etiket İmleç'te yapay zeka olarak görünür. - MCP araçlarının bir sunucuya hızlı bir şekilde bağlanmasını istiyorsanız en az bir kaydedilmiş bağlantı profili.
- MCP kayıt API'si sunan desteklenen bir ana bilgisayar.
MCP kaydının nasıl çalıştığını anlama
Uzantı, aşağıdakilerin tümü doğru olduğunda MCP sunucusunu otomatik olarak kaydeder:
- Ana bilgisayar, desteklenen bir MCP kaydı API’si sağlar.
- Uzantı, dil hizmetinden geçerli bir MCP sunucu URL'si ve taşıyıcı belirteci alabilir.
- Copilot entegrasyonu etkinleştirildi.
Bugün, kod yolu açıkça şunları destekler:
- Visual Studio Code 1.102 ve sonrası MCP sunucu tanımı sağlayıcısı API’si aracılığıyla
-
Cursor, Cursor’un
registerServerMCP API’si aracılığıyla
uzantı, Visual Studio Code'de sunucuyu PostgreSQL MCP olarak kaydeder. İmleç'te sunucuyu pgsql-mcp olarak kaydeder.
Important
Uzantı, MCP URL’sini ve belirteci kendiniz girmenizi bekleyen bağımsız istemciler için şu anda elle kopyala-yapıştır yapılan bir kurulum akışı sunmuyor. İstemciniz ana bilgisayar düzeyinde keşif veya kaydetmeyi desteklemiyorsa bunun yerine uzantının yerleşik yapay zeka iş akışlarını kullanın.
MCP araçları için bağlantı profillerini hazırlama
En kullanışlı MCP akışları, kaydedilen bağlantı bilgilerine bağlıdır.
- Bağlantılar ve kimlik'i açın ve konağın kullanmasını istediğiniz bağlantı profillerini oluşturun veya güncelleştirin.
- Kimlik bilgilerini iş akışınızın gerektirdiği yere kaydedin.
- MCP tabanlı otomasyona güvenmeden önce uzantıdan hedef veritabanına bağlanabildiğinizi doğrulayın.
Bunun nedeni, bağlantı odaklı MCP araçlarının hedef profili yapay zeka konağındaki ayrı bir veritabanı yapılandırması yerine uzantının bağlantı deposundan çözümlemesidir.
Desteklenen bir konakta MCP araçlarını kullanma
Ana bilgisayar PostgreSQL MCP sunucusunu keşfettikten sonra, uzantının sunduğu araç arabirimini çağırabilir.
| Araç ailesi | Ne işe yarar? | Tipik kullanım |
|---|---|---|
| Bağlantı Profillerini Listeleme | Kaydedilen profilleri bulma | Bağlanmadan önce doğru profili bulun |
| PostgreSQL Veritabanına bağlanma | Kaydedilmiş profilden veritabanı oturumu açma | Doğru sunucuda veya veritabanında görev başlatma |
| Veritabanlarını Listeleme | Bağlı sunucuda veritabanlarını listeleme | Bağlamı değiştirme veya kullanılabilir veritabanlarını inceleme |
| Veritabanı Nesnelerini Alma | Şema bağlamını getir | İzleme soruları sormadan önce tabloları, görünümleri, işlevleri ve diğer nesneleri tanımlama |
| Sorgu Çalıştırma | Okuma odaklı SQL yürütme | Verileri inceleme veya varsayımları doğrulama |
| Veritabanını Değiştir | Veri veya şema değişikliklerini yürütme | Yazma erişimi gerektiren iş akışlarına DDL veya DML uygulama |
| SQL Betiğini açma | İnceleme için betik oluşturun | Aracı çıkışından insan tarafından gözden geçirilmiş sorgu düzenleyicisi akışına geçme |
| Sorgu Planı | Önbelleğe alınmış plan verilerini inceleme | Performans iş akışlarını analiz etme |
| Veritabanı Şemasını Görselleştirme | Şema görünümünü işleme | SQL yazmadan veya değiştirmeden önce ilişkileri anlama |
| Gösterge Paneli Bağlamını Al | Kullanılabilir metrikler ve yapılandırma dâhil etkin gösterge paneli oturumu bağlamını al | Ölçüm verilerini istemeden önce hangi ölçümlerin kullanılabilir olduğunu keşfetme |
| Pano Ölçüm Verilerini Alma | Açık bir sunucu panosundan toplu önbelleğe alınmış zaman serisi verilerini getirme | Canlı sorgu çalıştırmadan sunucu performans eğilimlerini analiz etme |
Tip
Daha güvenli iş akışları için, sorguları veya değişiklikleri çalıştırmadan önce Bağlantı Profillerini Listele, PostgreSQL Veritabanına Bağlan ve Veritabanı Nesnelerini Al gibi bulma araçlarıyla başlayın.
MCP ile yerleşik yapay zeka deneyimleri arasında seçim yapma
Konağınız MCP bulmayı desteklediğinde ve uzantının PostgreSQL araç yüzeyini orada kullanıma sunmasını istediğinizde MCP sunucusunu kullanın.
Aşağıdaki durumlarda yerleşik uzantı deneyimlerini kullanın:
- doğrudan @pgsql sohbet katılımcısıyla sohbet etmek istiyorsunuz (yalnızca Visual Studio Code),
- Agent modunda (Visual Studio Code ve Cursor) çok adımlı otomasyon istiyorsanız veya
- mevcut barındırıcınız, uzantının MCP kaydını otomatik olarak görünür kılmaz.
MCP kullanılabilirliği sorunlarını giderme
Ana bilgisayar PostgreSQL MCP sunucusunu göstermiyor
Desteklenen bir ana bilgisayar çalıştırdığınızı ve uzantıda Copilot/AI tümleştirmesinin etkinleştirildiğini onaylayın. Gerekirse, oturum açıldıktan veya Copilot/AI ayarlarını değiştirdikten sonra pencereyi yeniden yükleyin.
Kayıt işlemi atlandı
Uzantı, dil hizmetinden kullanılabilir bir MCP URL'si veya belirteci alamıyorsa kaydı atlar. Ana sistem, yeniden yüklendikten sonra sunucuyu hiç algılamazsa uzantının çıktı günlüklerini denetleyin.
Bir araç veritabanıma bağlanamıyor
Hedef bağlantı profilinin mevcut olduğunu ve uzantının bunu doğrudan kullanabileceğini doğrulayın. MCP akışları, uzantının geri kalanıyla aynı bağlantı deposuna ve kimlik bilgisi çözümlemesine bağlıdır.
Başka bir MCP istemcisi için manuel bir uç noktaya ihtiyacım var
Uzantı şu anda bağımsız MCP istemcileri için kullanıcıya yönelik manuel uç nokta iş akışı sunmuyor. Desteklenen bir konak kullanın veya bu belge kümesinde belgelenen yerleşik yapay zeka deneyimlerine geri dönün.