AI İstemcisi Entegrasyonu (IDE Integration)

ServBay, dahili MCP Sunucusunu favori AI istemcilerinize tek tıkla entegre ederek ilgili MCP yapılandırmalarını otomatik olarak ekler; yapılandırma dosyalarını elle düzenlemenize gerek kalmaz. Bu makalede entegrasyonun nasıl yapılacağı, desteklenen istemciler ve her istemcinin entegrasyon yöntemi anlatılmaktadır.

Ön Koşullar

• ServBay yüklü ve çalışıyor olmalıdır.
• Hedef AI istemci yüklü olmalıdır (ServBay, yapılandırmasına göre entegrasyon uygunluğunu belirler).

Tek Tıkla Entegrasyon

ServBay Ayarları (Settings) → AI İstemci Entegrasyonları (IDE Integrations) bölümüne gidin. İstemci listesinde hedef istemciyi bulun ve Entegre Et (Integrate) butonuna tıklayın. ServBay şu adımları otomatik olarak uygular:

1. Dağıtıma gömülü gelen servbay-mcp yürütülebilir dosyasını bulur (ayrıca yüklemenize gerek yoktur).
2. Hedef istemcinin yapılandırma standartlarına göre MCP yapılandırmasını ekler/günceller (sadece servbay düğümünü ekler/günceller, var olan diğer MCP yapılandırmalarınız korunur).
3. Entegrasyon durumunu gösterir.

Entegrasyonu kaldırmak için Kaldır (Remove) butonuna tıklamanız yeterlidir.

Entegrasyon Durumu

Her istemcinin, "bu makinedeki ServBay" ile olan entegrasyon durumu aşağıdaki şekilde gösterilir:

Durum	Açıklama
Entegre Edildi	İstemci, bu makinedeki ServBay'in servbay-mcp dosyasını kullanıyor
Entegre Edildi (Farklı Yol)	İstemcide servbay tanımlı; ancak dosya yolu farklı (örneğin başka bir ServBay kurulumu)
Entegre Edilmedi	İstemci tespit edildi, ancak entegrasyon eksik
Tespit Edilemedi	İstemci bu makinede bulunamadı

Desteklenen İstemciler ve Entegrasyon Yöntemleri

İstemci	Entegrasyon Yöntemi	Yapılandırma Konumu
Claude Code	Resmi CLI: claude mcp add --scope user --transport stdio servbay -- <bin>	Claude Code kullanıcı düzeyi MCP yapılandırması
Codex	Resmi CLI: codex mcp add (CLI çalışmazsa ~/.codex/config.toml dosyasına kayıt yapılır)	Codex yapılandırması
Cursor	~/.cursor/mcp.json dosyasına yazılır (üst seviye mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Kullanıcı düzeyinde mcp.json dosyasına yazılır (üst seviye servers, type: stdio)	VS Code kullanıcı düzeyi mcp.json
Claude Desktop	claude_desktop_config.json dosyasına yazılır (üst seviye mcpServers)	claude_desktop_config.json

Yapılandırma şeması farklılıkları

Farklı istemcilerde MCP yapılandırmasının üst seviye anahtarı farklıdır: VS Code servers kullanır, Cursor / Claude Desktop ise mcpServers kullanır. ServBay, her istemcinin standardına uygun anahtarı otomatik olarak yazar; bu detaylarla sizin uğraşmanıza gerek yoktur.

Entegrasyonu Doğrulama

Entegrasyon sonrası, ilgili AI istemcisinde bir ortam sorgusu gerçekleştirin (örneğin "ServBay’de çalışan servisleri listele" komutunu verin). Eğer AI, mevcut servis listesini gerçekçi sunabiliyorsa entegrasyon başarıyla tamamlanmıştır.

Sıkça Sorulan Sorular (SSS)

• S: Entegrasyon mevcut MCP yapılandırmalarımı değiştirir mi?
  • C: Hayır. ServBay sadece servbay düğümünü ekler/günceller, diğer MCP Sunucusu ayarlarınızı korur.
• S: İstemci “Tespit Edilemedi” olarak mı görünüyor?
  • C: Bu, istemcinin makinede bulunmadığı anlamına gelir. Önce istemciyi yükleyip bir kere çalıştırdıktan sonra entegrasyonu deneyin.
• S: Entegrasyon sonrası AI erişimi çalışmıyor mu?
  • C: ServBay’in çalıştığından ve (Claude Code / Codex için) resmi CLI’nin erişilebilir olduğundan emin olun. Gerekirse entegrasyonu kaldırıp tekrar deneyin.
• S: Entegrasyon sonrası başka neler önerilir?
  • C: AI Kuralları’nı yüklemeniz önerilir; böylece AI, ServBay MCP’yi öncelikli ve doğru şekilde kullanabilir.

Sonuç

"AI İstemci Entegrasyonu" ile ServBay MCP'yi popüler AI araçlarına kolayca ekleyebilirsiniz; üstelik mevcut ayarlarınız bozulmadan, elle yapılandırmaya gerek olmadan. AI Kuralları ile birleştiğinde AI, yerel geliştirme ortamınızı yönetmede maksimum verim ve kolaylık sağlar.