Antigravity, Claude Code, Codex ve Cursor gibi yapay zeka destekli geliştirme araçlarını kullanarak web uygulamaları için Firebase kurulumunuzu kolaylaştırın. Firebase agent skills'i Firebase CLI ve Firebase MCP sunucusu ile birlikte kullanarak yapay zeka kodlama aracınızı kod yazabilen, Firebase Security Rules'ı yapılandırabilen ve canlı kaynakları yönetebilen özel bir Firebase uzmanına dönüştürebilirsiniz.
Bu kılavuzda, web uygulaması için Cloud Firestore, Authentication ve Firebase Hosting'nin ayarlanmasına yardımcı olması amacıyla yapay zeka kodlama aracının kullanımı ele alınmaktadır. iOS, Android ve Flutter uygulamalarıyla ilgili bilgiler için yakında tekrar kontrol edin.
Neden Firebase temsilci becerilerini ve araçlarını kullanmalısınız?
Genel yapay zeka modelleri genellikle belirli proje yapılandırmaları veya güncel olmayan bilgilerle ilgili sorun yaşar. Bu araç seti, aradaki boşluğu kapatır:
- Firebase agent becerileri: Beceriler, kodlama aracısına alan uzmanlığı sağlar. Ajanın, mimarinizi yapılandırmak için Firebase'in önerdiği doğru yöntemi bilmesi amacıyla güncel belgeler ve optimum iş akışları sağlar.
- Firebase MCP sunucusu: MCP sunucusu, kodlama aracına bağlam ve erişim sağlar. Bu protokol, aracının etkin proje kaynaklarınızı, yerel dosyalarınızı ve yapılandırmalarınızı programatik olarak incelemesi için standart bir protokol oluşturur.
- Firebase KSA: Komut satırı arayüzü, kodlama aracına eyleme dönüştürülebilir güç verir. Bu araç, temsilcinin veritabanlarını başlatma, kullanıcı kimlik doğrulama yapılandırmalarını yönetme ve sizin adınıza kod dağıtma gibi zorlu görevleri gerçekleştirmek için kullandığı yürütme aracıdır.
Firebase agent skills'i Firebase CLI ve Firebase MCP sunucusuyla birlikte kullanmak, yapay zeka kodlama aracınıza ek yetenekler kazandırır:
- Harekete geçin: Yalnızca kod yazmaktan daha fazlasını yapın. Ajanınız hizmetleri başlatabilir, Authentication kullanıcıları yönetebilir, yeni Firebase Security Rules dağıtabilir ve doğrudan Cloud Firestore verilerinizle çalışabilir.
- Güncel kalın: Temsilcinize kurulum görevlerinde yol göstermek için resmi ve sürüme duyarlı istemler kullanın.
- Doğruluğu artırma: Daha alakalı ve doğru yardım sağlamak için projenizin ortamına ve şemalarına erişin.
- Jeton maliyetlerini azaltma: Temsilci becerileri, ayrıntılı dokümanları yalnızca belirli bir görev gerektiğinde yükler. Bu sayede oturum ek yükü en aza indirilir.
Ajan becerileri ve araçları hangi Firebase hizmetlerinde yardımcı olabilir?
Bu kılavuzda öncelikle, bu hizmetleri ve özellikleri hızlı bir şekilde ayarlamanıza yardımcı olmak için aracı becerilerinin, Firebase KSA'nın ve Firebase MCP sunucusunun birlikte nasıl çalıştığına odaklanılmaktadır:
- Cloud Firestore: NoSQL veritabanı sağlama.
- Authentication: Güvenli kullanıcı oturum açma özelliğini ayarlayın.
- Firebase Security Rules: Uygulamanız için Security Rules oluşturun ve iyileştirin.
- Firebase Hosting: Projenizi statik web uygulaması dağıtımı için ayarlayın.
Kullanılabilir özelliklerin tam listesi için Firebase temsilcisi becerilerinin tam listesine göz atın.
Genel iş akışı
Aşağıdaki adımlarda, Firebase hizmetlerini web uygulamasında ayarlamak ve kullanmak için Firebase aracı becerilerinin nasıl kullanılacağına dair genelleştirilmiş bir iş akışı açıklanmaktadır. Arka planda, aracı becerileri bu görevleri tamamlamak için Firebase KSA'yı ve Firebase MCP sunucusunu kullanır.
1. adım: Firebase temsilci becerilerini yükleyin
Çoğu durumda, Firebase aracı becerilerini tercih ettiğiniz düzenleyiciye tek bir istemle yükleyebilirsiniz:
Antigravity
Firebase aracı becerileri, Antigravity için Build with Google entegrasyon paketlerinden biri olarak sunulur. Bu paketi iki noktada genel düzeyde erişim için etkinleştirebilirsiniz:
- İlk katılım sırasında: Firebase yığını onay kutusunu işaretleyin.
- Ayarlarda: Ayarlar > Özelleştirmeler'e gidin. Build with Google Plugins (Google Eklentileriyle Oluşturun) bölümünde Customize'ı (Özelleştir) ve ardından Firebase entegrasyonu için Download'u (İndir) tıklayın.
Proje düzeyinde erişimi tercih ediyorsanız projenizin dizininde aşağıdaki komutu çalıştırın:
npx skills add firebase/agent-skills --agent=antigravity
Claude Code
claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase
Codex
npx skills add firebase/agent-skills --agent=codex
İmleç
Firebase ajan becerilerini doğrudan Cursor Marketplace'ten veya terminalinizde aşağıdaki komutu çalıştırarak yükleyebilirsiniz:
npx skills add firebase/agent-skills --agent=cursor
Diğer temsilciler
npx skills add firebase/agent-skills
2. adım: Firebase MCP sunucusuna bağlanın
Birçok Firebase aracı becerisi görevler için Firebase CLI'yı kullanırken yapay zeka kodlama aracınızı Firebase MCP sunucusuna bağlamanız önerilir. Bu bağlantı, aracınızın Firebase ortamınızla etkileşim kurma becerisini geliştirerek daha derin bir entegrasyon ve erişim sağlar.
Yapay zeka destekli yöntem
Çoğu durumda, yapay zeka kodlama aracınızdan Firebase MCP sunucusunu ayarlamasını isteyebilirsiniz. Ancak bu işlemde zorluk yaşanırsa veya Firebase MCP sunucusu listelenmezse Manuel yönteme geçin.
Manuel yöntem
Antigravity
Antigravity uygulamasını Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için:
- Antigravity bölümünde, Aracı bölmesindeki menüsü > MCP Sunucuları'nı tıklayın.
- Firebase > Yükle'yi seçin.
Bu işlem, mcp_config.json dosyanızı otomatik olarak günceller. Bu dosyayı görüntülemek için MCP Store bölmesinin üst kısmındaki MCP Sunucularını Yönet'i tıklayın > Ham yapılandırmayı görüntüle'yi tıklayın. Dosyada şu içerik bulunur:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Firebase Studio
Firebase Studio'yu Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için yapılandırma dosyasını düzenleyin veya oluşturun: .idx/mcp.json.
Dosya henüz yoksa ana dizini sağ tıklayıp Yeni dosya'yı seçerek dosyayı oluşturun. Dosyaya aşağıdaki içerikleri ekleyin:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
1. seçenek: Eklenti aracılığıyla yükleme (önerilir)
Claude Code'da Firebase MCP sunucusunu ayarlamanın en kolay yolu, resmi Firebase eklentisini yüklemektir:
Claude eklentileri için Firebase pazar yerini ekleyin:
claude plugin marketplace add firebase/firebase-toolsFirebase için Claude eklentisini yükleyin:
claude plugin install firebase@firebaseYüklemeyi doğrulayın:
claude plugin marketplace list
2. seçenek: MCP sunucusunu manuel olarak yapılandırma
Alternatif olarak, Firebase MCP sunucusunu manuel olarak yapılandırabilirsiniz:
Uygulama klasörünüzde aşağıdaki komutu çalıştırın:
claude mcp add firebase npx -- -y firebase-tools@latest mcpYüklemeyi doğrulayın:
claude mcp listŞunlar gösterilmelidir:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Claude Desktop'ı Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için claude_desktop_config.json dosyasını düzenleyin. Bu dosyayı Claude > Ayarlar menüsünden açabilir veya oluşturabilirsiniz. Geliştirici sekmesini seçin, ardından Yapılandırmayı Düzenle'yi tıklayın.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cline
Cline'ı Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için cline_mcp_settings.json dosyasını düzenleyin. Bu dosyayı, Cline bölmesinin üst kısmındaki MCP Sunucuları simgesini ve ardından MCP Sunucularını Yapılandır düğmesini tıklayarak açabilir veya oluşturabilirsiniz.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
İmleç
1. seçenek: Marketplace eklentisi (önerilir)
Cursor Marketplace'ten Firebase eklentisini yükleyin. Bu işlem, MCP sunucusunu otomatik olarak yapılandırır ve Firebase temsilci becerilerine erişim sağlar.
2. seçenek: Tek tıklamayla MCP kurulumu
Yalnızca MCP sunucusunu genel yapılandırmanıza eklemek istiyorsanız aşağıdaki düğmeyi tıklayın:
3. seçenek: Manuel yapılandırma
Sunucuyu belirli bir proje için yapılandırmayı tercih ediyorsanız veya ayarlarınızı manuel olarak düzenlemek istiyorsanız mcp.json dosyanızı güncelleyin:
- Belirli bir proje için
.cursor/mcp.jsonsimgesini düzenleyin. - Tüm projeler (global) için
~/.cursor/mcp.jsonöğesini düzenleyin.
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
VS Code Copilot
Tek bir projeyi yapılandırmak için çalışma alanınızdaki .vscode/mcp.json dosyasını düzenleyin:
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Sunucuyu açtığınız her projede kullanılabilir hale getirmek için kullanıcı ayarlarınızı düzenleyin. Örneğin:
"mcp": {
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Rüzgar Sörfü
Windsurf Editor'ü yapılandırmak için dosyayı düzenleyin
~/.codeium/windsurf/mcp_config.json:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
3. adım: Firebase hizmetlerini başlatın
Ajan becerileri ve araçları ayarlandıktan sonra, yapay zeka kodlama aracınızın Cloud Firestore, Authentication ve Firebase Hosting'yi ayarlaması için doğal dili kullanabilirsiniz.
Temsilcinizden bir hizmet ayarlamasını isteyin. Örneğin, aşağıdaki gibi istemler kullanabilirsiniz:
- Bu uygulama için veritabanı olarak Cloud Firestore'ı ayarlayın.
- Authentication kullanarak bir giriş sayfası oluşturun ve yalnızca yetkili kullanıcıların kendi verilerini okuyup yazabilmesini sağlamak için Security Rules değerini güncelleyin.
- Uygulamayı kurun Firebase Hosting ve üretime dağıtın.
Temsilcinizin sağlayabileceği bilgileri inceleyin ve yönlendirmeli adımları uygulayın. Örneğin:
- Planlar: Ajanınız, mevcut kod tabanınıza göre bir strateji önerir.
- Bağlama: Aracınız, yerel kodunuzu mevcut bir Firebase projesine bağlar veya yeni bir Firebase projesi oluşturmanıza yardımcı olur.
- Kaynakları başlatır: Ajanınız, kod tabanınıza gerekli Firebase kitaplıklarını ve yapılandırmasını ekler.
- Dosyaları günceller: Ajanınız,
firestore.rules(veritabanınızda verileri kimin okuyabileceğini, yazabileceğini veya sorgulayabileceğini tanımlamak için) ya dafirebase.json(Firebase CLI'ya hangi hizmetlerin dağıtılacağını ve nasıl yapılandırılacağını bildirmek için) gibi gerekli dosyaları oluşturur ve günceller. - Yürütür: Temsilciniz, ek yapılandırma veya dağıtım adımlarında size yol gösterir.
Yapay zeka kodlama ajanına istem göndermeyle ilgili genel ipuçları
Özellikle Firebase gibi çok yönlü entegrasyonlarla çalışırken yapay zeka kodlama aracınızdan en iyi şekilde yararlanmak için etkileşimi tek seferlik bir komut yerine işbirliği olarak değerlendirin.
Net olun ve bağlam bilgisi verin
Firebase MCP sunucusu, temsilciye projenizle ilgili önemli bağlam bilgileri sağlasa da en iyi sonuçlar net ve spesifik doğal dil istemleriyle elde edilir. Net olmayan isteklerden kaçının.
- Belirsiz: "Veritabanı hatasını düzelt."
- Belirli: "Cloud Firestore içindeki "users" koleksiyonuna yazmaya çalışırken "permission denied" (izin reddedildi) hatası alıyorum.
firestore.rulesgözden geçir ve kimliği doğrulanmış kullanıcıların kendi belgelerine yazmasına olanak tanıyan bir düzeltme öner."
İterasyon yapın ve iyileştirin
Yapay zeka kodlama aracı, karmaşık görevlerde ilk denemede nadiren mükemmel kod oluşturur. Bir yanıt tam olarak doğru değilse sohbete devam edin:
- Hata mesajlarını paylaşın: Terminal hatalarını veya konsol günlüklerini tekrar sohbete yapıştırın.
- Ayarlama isteğinde bulunun: "Bu kod, eski v8 SDK'sını kullanıyor. Firebase v9 modüler SDK'sını kullanarak yeniden yaz."
- Açıklama isteyin: "Bu Firebase Security Rules, kullanıcı verilerini nasıl koruyor?"
Yürütmeden önce doğrulayın
Yapay zeka kodlama aracıları güçlüdür ancak hata yapabilir veya "halüsinasyon" (yanlış adlandırılmış işlevler ya da hizmetler uydurma) görebilir.
- Kodu inceleyin: Üretim ortamına dağıtmadan önce her zaman oluşturulan kodu, özellikle de Firebase Security Rules ve yapılandırma dosyalarını (ör.
firebase.json) okuyun. - Yerel olarak test etme: Mümkün olduğunda, değişiklikleri canlıya aktarmadan önce yerel olarak test etmenize yardımcı olması için temsilciden destek isteyin.
MCP bağlantısını kullanma
Firebase MCP sunucusu, temsilcinizin proje yapınızı doğrudan görmesini sağladığından, özel uygulama tavsiyeleri almak için belirli dosyalara başvurabilirsiniz.
- Örnek: "
src/web/index.htmldosyama bak ve standart Firebase başlatma komut dosyasını nereye ekleyeceğimi göster."
Sonraki adımlar
- Kullanılabilir tüm Firebase temsilcisi becerilerinin tam listesine göz atın.
- Firebase MCP sunucusunun sağladığı tüm kullanılabilir istemlerin, araçların ve kaynakların tam listesine göz atın.
- Firebase CLI tarafından sağlanan araçlar hakkında daha fazla bilgi edinin.