AI Kuralı (AI Rule)

ServBay MCP entegre edildikten sonra, AI araçları ServBay'i "kullanabilir", ancak bunu ne zaman ve nasıl kullanmaları gerektiğini "bilmezler". AI Kuralı (AI Rule), AI'ya özel hazırlanmış bir rehberdir—yani, yerel servisler, siteler, alan adları, HTTPS, port, veritabanı, yedekleme gibi konular işin içine girdiğinde, AI'ya uygulama kodunu değiştirip ortam sorunlarını atlamak yerine önce ServBay MCP üzerinden kontrol ve işlem yapmasını söyler. Bu belgede, AI Kuralı kurulumu anlatılmaktadır.

AI Kuralı Hangi Sorunları Çözer?

• AI'ya Öncelikli Olarak MCP'yi Kullandırır — "Site açılmıyor / 502 / Port kullanılıyor / Sertifika hatası" gibi yerel ortam sorunlarında kodu rastgele değiştirmek yerine ilk adım olarak ServBay MCP ile durumu inceler.
• Güvenli Sınırları Düzenler — Yazma veya yıkıcı işlemler öncesi açıklama yapıp onay ister, konuşmada anahtar gibi hassas bilgiler paylaşılmaz ya da istenmez.
• Tekrar Açıklama Trafiğini Azaltır — Kural sürekli aktif olduğu için, AI her oturumda tutarlı kurallara göre davranır.

Ön Koşullar

• ServBay yüklenip çalıştırılmış olmalı.
• ServBay MCP entegrasyonu tamamlanmış olması önerilir.

Çalışma Alanı Düzeyinde vs Global Düzeyde Kurulum

AI Kuralı iki düzeyde kurulabilir:

• Çalışma Alanı Düzeyi (Workspace) — Kural dosyası belirli bir proje klasörüne yazılır ve sadece o proje için geçerlidir. Projeye özel kurallar için uygundur.
• Global Düzey (Global) — Kural dosyası, AI aracının kullanıcı düzeyi ayarlarına yazılır ve tüm projelere uygulanır. Şu anda sadece Claude Code ve Codex global düzeyi destekler.

AI Kuralı Nasıl Kurulur?

ServBay Ayarları (Settings)→ AI İstemci Entegrasyonları (IDE Integrations) bölümüne girin, ilgili istemci satırında AI Kuralı Kur (Install AI Rule) seçeneğine tıklayın; çalışma alanı kurulumunda önce hedef proje klasörünü seçmeniz gerekir. ServBay gerekli kural dosyasını oluşturacak veya güncelleyecektir. Kuralı kaldırmak için AI Kuralını Kaldır (Remove AI Rule) butonunu kullanabilirsiniz.

Çalışma Alanı Kural Dosya Konumları

İstemci	Kural Dosyası (Proje köküne göre relatif)
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

Global Kural Dosya Konumları

İstemci	Kural Dosyası
Claude Code	~/.claude/CLAUDE.md (resmi kullanıcı hafızası, oturum başlangıcında yüklenir)
Codex	~/.codex/AGENTS.md (resmi global hafıza)

Birleştirme Stratejisi: İçeriğiniz Korunur

ServBay, kuralları etiketli birleştirme yöntemiyle yazar: ServBay'in yönettiği kural içeriği özel işaretleyicilerle sınırlandırılır ve sadece bu aralık güncellenir, dosyanın diğer taraflarındaki mevcut içerikleriniz kesinlikle korunur. Yani, kuralı mevcut CLAUDE.md / AGENTS.md dosyanıza eklemek tamamen güvenlidir—mevcut içerikleriniz kaybolmaz, kaldırırken de sadece yönetilen kısım silinir.

Sıkça Sorulan Sorular (SSS)

• S: AI Kuralı'nı kurmak mevcut CLAUDE.md / AGENTS.md dosyalarımı silip değiştirir mi?
  • C: Hayır. ServBay sadece kendi işaretlediği alanı günceller, diğer içerikleriniz olduğu gibi kalır.
• S: Neden istemcimde "global kural" seçeneği yok?
  • C: Global düzey sadece Claude Code ve Codex için mevcuttur; diğer istemciler için çalışma alanı kurulumunu kullanınız.
• S: AI Kuralı ve MCP entegrasyonu arasındaki ilişki nedir?
  • C: MCP entegrasyonu AI'ya ServBay'i kullandırır, AI Kuralı ise AI'ya ne zaman ve nasıl kullanacağını öğretir. En iyi sonuç için ikisi birlikte kullanılmalıdır.
• S: Cursor / VS Code projelerimdeki kural dosyaları Git'e dahil olur mu?
  • C: Kural dosyaları proje klasöründe bulunduğu için, sürüm kontrolüne girip girmemesi .gitignore ayarınıza bağlıdır. Ekip kurallarınıza göre ayarlayabilirsiniz.

Sonuç

AI Kuralı, ServBay MCP'nin "kullanım rehberi"dir; AI'nın yerel geliştirme ortamı sorunlarına öncelikli, doğru ve güvenli yaklaşmasını sağlar. Çalışma alanı ve global düzeyde kurulum desteği ile içerikleriniz işaretli birleştirme ile korunur. Kurulumdan sonra, AI aracınız yerel ortamda gerçek bir yardımcıya dönüşür.