MCP sunucusu

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 ekini pgsql.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:

  1. Ana bilgisayar, desteklenen bir MCP kaydı API’si sağlar.
  2. Uzantı, dil hizmetinden geçerli bir MCP sunucu URL'si ve taşıyıcı belirteci alabilir.
  3. 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 registerServer MCP 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.

  1. Bağlantılar ve kimlik'i açın ve konağın kullanmasını istediğiniz bağlantı profillerini oluşturun veya güncelleştirin.
  2. Kimlik bilgilerini iş akışınızın gerektirdiği yere kaydedin.
  3. 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:

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.