İçeriğe atla

Neon MCP nedir? Postgres veritabanını asistana bağlamak, kurulum, salt okuma ve üretim uyarısı

Asistanına veritabanı işini söylersin; Neon MCP projelerini ve dallarını listeler, şemayı ve tablo verisini okur, SQL ve migration çalıştırır, dal oluşturur; yazma yetkisi açıksa proje, dal ve rol silme araçları da vardır. Neon'un barındırdığı resmî uzak MCP sunucusu (adres https://mcp.neon.tech/mcp). Neon'un kendi belgesi MCP'yi "yalnız geliştirme ve test için" öneriyor: üretim veritabanına bağlama. Salt okuma bağlanırken seçilebilir. MCP için ayrı plan koşulu belgede yok; Free planda çalıştığını söyleyen açık bir cümle de yok. Kurulum: Claude'un bağlayıcı listesinden ya da `npx neon@latest init`.

Ne yapar
Asistana Neon Postgres veritabanını yönettirir
Tür
Bağlayıcı (Neon'un barındırdığı uzak MCP sunucusu)
Nerede
Claude, Claude Code, Cursor, VS Code, ChatGPT ve daha fazlası
Salt okuma
Var; bağlanırken seçilir
Üretim
Neon'un kendi belgesi önermiyor
Türkçe
Resmî kaynak yazmıyor
Ücret
MCP için ayrı ücret yok; Neon planı geçerli

Neon MCP ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Neon MCP ile asistanın Neon hesabındaki Postgres projelerini görür: projeleri ve dalları listeler, şemayı ve tabloları okur, yavaş sorguları ve sorgu planlarını inceler, 15 hazır teşhis kontrolü çalıştırır, günlükleri ve Neon belgelerini okur. Yazma yetkisi açıkken proje ve dal oluşturur, SQL ve migration çalıştırır, rol ve veritabanı oluşturur, anlık görüntü alır.

SenVeritabanı işini söylersin
AsistanClaude, Claude Code, Cursor, VS Code, ChatGPT
Neon MCPmcp.neon.tech, Neon barındırır
Neon projenDal, şema, tablo, SQL, migration

Yazma açıksa silme araçları da var; salt okuma bağlanırken seçilir. Neon üretimde önermiyor.

Neon veritabanını asistana okutmakNe alırsın: Şema, sorgu sonucu, teşhisBağlantı gerekirSQL ve migration çalıştırtmakNe alırsın: Değişen şema ya da veriBağlantı gerekir

Araç sayısı hızlı değişiyor: katalog ve Claude dizini 35 diyor, Neon'un girişsiz araç listesi ucu 14.10.2026'da filtresiz 114, salt okuma filtresiyle 50 araç döndürdü. Bu yüzden tek bir sayı verilmiyor.

Kime yarar: Neon'da geliştirme ve test veritabanı kullanan ve şema işlerini asistanla hızlandırmak isteyenlere. Üretim veritabanı için aşağıdaki uyarıyı oku.

Neon MCP nasıl bağlanır?

Gerekenler: bir Neon hesabı (OAuth ya da hesap ayarlarından üretilen API anahtarı) ve MCP destekleyen bir istemci. Komutlar Neon belgeleri ve README'den aynen alındı. Neon CLI 6.0'dan sonra npx neonctl init yerine npx neon@latest init kullanılıyor.

  1. Neon belgesine göre profil menüsünden Settings'i aç; Connectors'ı seç (bazı ekranlarda Customize sonra Connectors).
  2. Sağ üstte "Browse connectors"a tıkla, Neon'u bul ve ekle.
  3. Neon hesabına erişimi yetkilendir. Salt okuma için yetki ekranında "Allow writes" kutusunun işaretini kaldır; tek proje ve araç kategorisi de bu ekranda seçilebilir.

Claude dizinindeki adres https://mcp.neon.tech/mcp. Atlas kartındaki "+ › Connect" yolu Neon belgesinde yok.

Projende IP Allow açıksa mcp.neon.tech'in sabit adreslerini (34.192.103.46 ve 23.22.233.166) izin listesine ekle. OAuth ile varsayılan olarak yalnız kişisel hesabındaki projeler görünür; kuruluş projeleri için istemde org_id ya da project_id ver.

Neon MCP nasıl kullanılır?

Bağlandıktan sonra isteği normal yazarsın. Önce okuma işleriyle başla, yazma gerektiren işleri bir geliştirme dalında dene.

Şemayı oku"Neon'daki "uygulama-test" projemin şemasını oku ve tabloları, ilişkilerini ve eksik indeks olabilecek yerleri özetle. Hiçbir şeyi değiştirme."
Yavaş sorgu"Neon MCP ile yavaş çalışan sorguları bul ve her biri için sorgu planına bakarak bir iyileştirme öner. Önce öneriyi göster, uygulama."
Dalda deneme"Test projemde yeni bir dal oluştur, şu migration'ı onda çalıştır ve sonucu göster. Ana dala dokunma."

Kendi belgesi uyarıyor: MCP yalnız geliştirme ve test içindir. Üretim veritabanına bağlama, kişisel veri gösterme, anonimleştirilmiş veri kullan ve LLM'in istediği işlemleri çalıştırmadan önce incele.

Neon MCP hangi istemcilerde çalışır?

Claude (claude.ai ve Desktop)VarResmî bağlayıcı; özel adres girmek gerekmez.
Claude Code, Cursor, VS Code (Copilot)Varadd-mcp ya da elle ayar; VS Code Agent modu ister.
ChatGPTKısmenDeveloper mode ile özel bağlayıcı; kimlik doğrulama döngüsü bildirilmiş.
Cline, Windsurf, Zed, Kiro, Codex, Gemini CLI ve diğerleriVarNeon belgesinde her biri için bölüm var.
Yerel npm paketiYok@neondatabase/mcp-server-neon Neon belgesinde deprecated; uzak sunucu öneriliyor.

Eski /sse adresi 1 Ekim 2026'dan itibaren kapanacak diye duyurulmuş. Adresi /mcp yap.

Neon MCP neye erişir, salt okuma nasıl çalışır?

Okur

Neon projeleri, dallar, şemalar, tablolar ve SQL sorgu sonuçları (tablo verisi dahil), yavaş sorgu ve sorgu planları, günlükler ve Neon belgeleri.

Yazar

Yazma yetkisi açıkken proje ve dal oluşturma, SQL ve migration, Postgres rolü ve veritabanı oluşturma, rol şifresi sıfırlama, Neon Auth ve Data API ayarı, anlık görüntü, işlev dağıtma, depolama kovası oluşturma.

Siler

Yazma yetkisi açıkken delete_project, delete_branch, rol, veritabanı ve uç nokta silme, anlık görüntü ve depolama nesnesi silme araçları var; SQL ile de veri silinebilir. Dalı üst dalın şu anki haline sıfırlayan bir araç aradaki yazmaları atar.

Veri

README'ye göre giriş yapılmışsa hesap kimliği, ad ve e-posta Segment'e gider; her araç çağrısında araç adı ve istemci kaydedilir, araç argümanları ve sorgu sonuçları kaydedilmez; hatalar Sentry'ye gider. Asistana giden sorgu sonuçları kullandığın yapay zekâ hizmetine de gider.

Salt okuma nasıl açılırNe olur
OAuth ekranında "Allow writes" kutusunu kapatProje ve dal oluşturma, migration ve silme araçları kapanır.
Adrese ?readonly=true ekle (API anahtarında tek yol)run_sql görünür kalır ama READ ONLY işlem içinde çalışır; run_sql_transaction, migration, bağlantı dizesi alma ve silme araçları kapanır.
Tek proje kapsamı (?projectId=)delete_project aracı gizlenir.

GitHub Security Advisories listesinde kayıtlı uyarı görünmüyor; bu "güvenli" demek değildir. Tablo verisi asistana okunduğundan kişisel veri içeren veritabanlarını bağlama; Neon da anonimleştirilmiş veri kullanmanı öneriyor.

Neon MCP ücretsiz mi? Free planda çalışır mı?

MCP sunucusu için ayrı bir ücret ya da plan koşulu belgede yazmıyor; bir Neon hesabı yetiyor. Kullandığın projeler Neon planının kotalarına tabi. "Free planda çalışır" diyen açık bir cümle belgede yok; Free planın kotaları geçerli olur. Fiyatlar dolar, TL fiyatı yok.

Free0 $ /ay
  • 100 proje, projede 10 dal
  • Projede ayda 100 CU-saat
  • Proje başına 1 GB, hesapta toplam 20 GB depolama
  • 5 dakika sonra kendiliğinden uyur
LaunchKullandığın kadar
  • 0,106 $/CU-saat
  • 0,35 $/GB-ay
  • Projede 10 dal dahil, fazlası 1,50 $/dal-ay
ScaleKullandığın kadar
  • 0,222 $/CU-saat
  • Projede 25 dal dahil
  • SLA ve uyumluluk özellikleri

Kaynak: Neon planlar sayfası ve MCP belgesi. Hosted hizmetin kullanım koşulları için Neon'un şartlar sayfasına bak. Bu bir hukuki ya da mali görüş değildir.

Resmî fiyat sayfası en son tarihinde kontrol edildi.

Sık sorunlar ve çözümleri

Ne oluyorNe yapmalı
OAuth'ta "invalid redirect uri"rm -rf ~/.mcp-auth ile önbelleği sil, istemciyi yeniden başlat ve OAuth'u baştan yap.
Eski /sse adresini kullanan istemci çalışmıyorAdresi https://mcp.neon.tech/mcp yap.
IP Allow açık projede bağlantı kurulamıyorNeon'un sabit adreslerini izin listesine ekle.
Kuruluşa ait projeleri görmüyorsunİstemde org_id ya da project_id ver, ya da organizasyon API anahtarı kullan.
Kullanıcıların bildirdiği ChatGPT'de kimlik doğrulama döngüye giriyor; proje kapsamlı kullanımda araç şeması uyuşmuyorAçık GitHub konuları (#371, #339, #362); resmî çözüm yayımlanmamış.

Neon MCP bağlantısı nasıl kesilir?

  1. İstemcide: MCP ayarından Neon girdisini sil (Claude'da bağlayıcıyı kaldır). Belge bu adımı ayrıca anlatmıyor.
  2. API anahtarı kullandıysan: Neon Console › Settings'ten anahtarı iptal et.
  3. Yapılandırma dosyası: add-mcp ile yazılan dosyada (ör. .cursor/mcp.json) girdiyi sil.

OAuth yetkisini Neon tarafından iptal etme ekranının yolunu belge netleştirmiyor; Neon hesap ayarlarını kontrol et.

Sık sorulan sorular

Neon MCP'yi üretim veritabanıma bağlamalı mıyım?

Neon'un kendi belgesi hayır diyor: MCP yalnız geliştirme ve test için; üretim veritabanına bağlama, kişisel veri gösterme, anonimleştirilmiş veri kullan ve LLM'in istediği işlemleri çalıştırmadan önce incele.

Salt okuma modu var mı?

Var. OAuth yetki ekranında Allow writes kutusunu kapat ya da adrese ?readonly=true ekle; API anahtarı akışında ?readonly=true tek yoldur. Salt okumada yazan araçlar kapanır, run_sql READ ONLY işlemde çalışır.

Neon Free planında çalışır mı?

MCP belgesinde plan koşulu yazmıyor; Neon hesabı yeterli ve Free planın kotaları geçerli. Belgede Free'de çalışır diyen açık bir cümle yok.

Yerel kurulum hâlâ var mı?

Yerel stdio paketi Neon'a göre deprecated. Yalnız yerel çalıştırabilen istemciler için mcp-remote köprüsü öneriliyor.

Asistan tüm projelerimi silebilir mi?

Yazma yetkisi açıkken delete_project ve delete_branch araçları var. Tek proje kapsamı delete_project'i gizler; salt okumada tüm silme araçları kapanır. SQL ile veri silme de yazma yetkisiyle mümkündür.

Neon neleri topluyor?

Giriş yapıldığında hesap kimliği, ad ve e-posta Segment'e; araç çağrılarında araç adı ve istemci; hatalar Sentry'ye gider. Araç argümanları ve sorgu sonuçları analitiğe yazılmaz denmiş.

İlgili rehberler

Cline21st MCPai-memoryawwwards-animationsBrave Search MCPChrome DevTools MCP

Kaynaklar

Resmî kaynaklarda net olmayanlar: Free planda MCP'nin çalıştığı (açık cümle yok) · OAuth yetkisinin Neon Console'dan nasıl iptal edileceği · /sse kapanışının fiilen gerçekleşip gerçekleşmediği · güncel araç sayısı (değişiyor) · hosted hizmetin şartları · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.