Yapay zeka yardımını kullanarak Firebase hizmetlerini entegre etme

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 aracı becerilerini 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, bir web uygulamasında Cloud Firestore, Firebase Authentication ve Firebase Hosting'yi ayarlamak için yapay zeka kodlama asistanının nasıl kullanılacağı açıklanmaktadır. iOS, Android ve Flutter uygulamaları hakkında bilgi edinmek için yakında tekrar kontrol edin.

Neden Firebase aracı becerilerini ve araçlarını kullanmalısınız?

Yapay zeka kodlama aracıları genellikle belirli proje yapılandırmaları veya güncel olmayan bilgilerle ilgili sorun yaşar. Bu araç seti, özel talimatları (aracı becerileri) iki tamamlayıcı aracı yürütme aracı türüyle (KSA ve MCP sunucusu) birleştirerek bu boşluğu doldurur:

  • Firebase aracı becerileri: Kodlama aracına alan uzmanlığı ve iş akışları sağlar. Talimat katmanı olarak beceriler, aracıya kod yazma da dahil olmak üzere Firebase ile çalışmayla ilgili en iyi uygulamalar konusunda yol gösterir. Beceriler, temsilciye Firebase CLI'yı ve Firebase MCP sunucusunu ne zaman ve nasıl kullanacağını da öğretir.
  • Temsilci yürütme araçları:
    • Firebase CLI (komut satırı araçları): Proje yaşam döngüsü ve ortam görevleri için araçlar sağlar. Temsilci, Firebase projesinde hizmetleri ayarlamak, tam siteleri veya arka uç kaynaklarını dağıtmak, yerel emülatörleri başlatmak ve daha fazlası için terminal ortamında CLI komutları çalıştırabilir.
    • Firebase MCP sunucusu (programatik araçlar ve kaynaklar): Gerçek zamanlı inceleme ve veri işlemleri için araçlar sağlar. Yapılandırılmış araç çağrıları sayesinde aracı, Cloud Firestore dokümanlarını programatik olarak sorgulayıp güncelleyebilir, Firebase Authentication kullanıcılarını yönetebilir, Security Rules doğrulayabilir, canlı günlükleri veya dokümanları doğrudan bağlama aktarabilir ve daha birçok işlem yapabilir.

Firebase aracı becerilerini Firebase CLI ve Firebase MCP sunucusuyla birlikte kullanmak, yapay zeka kodlama aracınıza ek özellikler kazandırır:

  • Harekete geçin: Kod yazmaktan daha fazlasını yapın. Temsilciniz hizmetleri başlatabilir, Firebase Authentication kullanıcılarını yönetebilir, yeni Firebase Security Rules dağıtabilir ve doğrudan Cloud Firestore verilerinizle çalışabilir.
  • Güncel kalma: Temsilcinize kurulum görevlerinde rehberlik etmek için resmi ve sürüme duyarlı istemleri 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ı belgeleri yalnızca belirli bir görev gerektirdiğinde yükler. Bu sayede oturum ek yükü en aza indirilir.

Geçerli Firebase hizmetleri

Bu kılavuzda, öncelikle temsilci becerileri, Firebase CLI ve Firebase MCP sunucusunun birlikte nasıl çalıştığı açıklanmaktadır. Bu sayede, aşağıdaki hizmetleri ve özellikleri hızlıca ayarlayabilirsiniz:

  • Cloud Firestore: NoSQL veritabanı sağlama.
  • Firebase 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 tüm becerilerin listesi için Firebase aracı 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, bu görevleri tamamlamak için Firebase CLI ve Firebase MCP sunucusu kullanılmaktadır.

1. adım: Firebase aracı becerilerini yükleyin

Çoğu durumda, Firebase aracı becerilerini tercih ettiğiniz düzenleyiciye tek bir istemle yükleyebilirsiniz:

Antigravity

  • 1. seçenek: Genel düzeyde erişim

    Firebase aracı becerileri, Antigravity Marketplace'teki Firebase eklentisine (ve Build with Google entegrasyon paketine) dahildir. Eklentiyi aşağıdaki seçeneklerden birini kullanarak yükleyin:

    • Antigravity Pazar yeri: Özelleştirmeler'i tıklayın, Pazar yeri sekmesini seçin ve Firebase eklenti kartında + simgesini tıklayın.
    • Antigravity CLI içinde: Çalıştır'ı /plugin install firebase@agent-marketplace (veya /plugin komutunu çalıştırın ve Keşfet sekmesinden Firebase'i yükleyin). Antigravity konumuna yüklenen eklentiler de otomatik olarak Antigravity CLI ile senkronize edilir.
    • İlk katılım sırasında: Firebase yığınının onay kutusunu işaretleyin.
  • 2. seçenek: Proje düzeyinde erişim

    Projenizin dizininde aşağıdaki komutu çalıştırın:

    npx skills add firebase/agent-skills --agent=antigravity
    

Claude Code

Terminalinizde aşağıdaki komutları çalıştırın:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Codex

  • 1. seçenek: Codex terminali

    Terminalinizde aşağıdaki komutları çalıştırın:

    codex plugin marketplace add firebase/agent-skills
    codex plugin add firebase@firebase
    
  • 2. seçenek: Codex uygulaması

    1. Aşağıdaki görevleri bir kez tamamlayın:

      1. Terminal üzerinden kaydolma:

        codex plugin marketplace add firebase/agent-skills
        
      2. Codex uygulamasını tamamen yeniden başlatın.

      3. Eklentiler'i açın.

      4. Firebase pazar yerini/kaynağını seçin.

      5. Firebase'i açın ve + Install'u (+ Yükle) tıklayın.

    2. Yeni bir görev başlatın.

    3. Eklentiyi seçmek için @Firebase yazın veya Codex'ten bir Firebase görevi gerçekleştirmesini isteyin.

İmleç

  • 1. seçenek: Eklentiyi doğrudan Cursor Marketplace'ten yükleyin.

  • 2. seçenek: Terminalinizde aşağıdaki komutu çalıştırın:

    npx skills add firebase/agent-skills --agent=cursor
    

Diğer temsilciler

Terminalinizde aşağıdaki komutu çalıştırın:

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ı kullansa da yapay zeka kodlama aracınızı Firebase MCP sunucusuna bağlamanız da önerilir. Bu bağlantı, temsilcinizin Firebase ortamınızla etkileşim kurma yeteneğini geliştirerek daha derin 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 sorun yaşarsanız veya Firebase MCP sunucusunu listede görmezseniz Manuel yöntem'e geçin.

Manuel yöntem

Antigravity

Antigravity uygulamasını Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için:

  1. Antigravity uygulamasında, temsilci bölmesindeki menüsünü > MCP Servers'ı (MCP Sunucuları) tıklayın.
  2. Firebase > Yükle'yi seçin.

Bu işlem, mcp_config.json dosyanızı otomatik olarak günceller. Dosyayı görüntülemek için MCP Store bölmesinin üst kısmındaki MCP Sunucularını Yönet > Ham yapılandırmayı görüntüle'yi tıklayabilirsiniz. Dosya aşağıdaki içeriğe sahiptir:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "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 kurmanın en kolay yolu, resmi Firebase eklentisini yüklemektir:

    1. Claude eklentileri için Firebase pazar yerini ekleyin:

      claude plugin marketplace add firebase/firebase-tools
    2. Firebase için Claude eklentisini yükleyin:

      claude plugin install firebase@firebase
    3. Yü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:

    1. Uygulama klasörünüzde aşağıdaki komutu çalıştırın:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Yüklemeyi doğrulayın:

      claude mcp list

      Şunları göstermelidir:

      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"]
    }
  }
}

İ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 aracı becerilerine erişim sağlar.

2. seçenek: Tek tıklamayla MCP kurulumu

MCP sunucusunu yalnızca genel yapılandırmanıza eklemek istiyorsanız aşağıdaki düğmeyi tıklayın:

MCP sunucusunu yükleme

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.json öğesini düzenleyin
  • Tüm projeler (global) için ~/.cursor/mcp.json düzenleyin.
"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ı açmak veya oluşturmak için Cline bölmesinin üst kısmındaki MCP Sunucuları simgesini, ardından MCP Sunucularını Yapılandır düğmesini tıklayabilirsiniz.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

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 artık doğal dili kullanarak yapay zeka kodlama aracınızın Cloud Firestore, Firebase Authentication ve Firebase Hosting'yi ayarlamasını sağlayabilirsiniz.

  1. Temsilcinizden bir hizmet ayarlamasını isteyin. Örneğin, aşağıdaki gibi istemler kullanabilirsiniz:

    • Cloud Firestore uygulamasını bu uygulamanın veritabanı olarak ayarlayın.
    • Authentication kullanarak bir giriş sayfası oluşturun ve yalnızca yetkili kullanıcıların kendi verilerini okuyup yazabilmesi için Security Rules uygulamasını güncelleyin.
    • Firebase Hosting uygulamasını ayarlayın ve uygulamayı üretime dağıtın.
  2. Ajanınızın sağlayabileceği bilgileri inceleyin ve açıklamalı adımları uygulayın. Örneğin:

    1. Planlar: Temsilciniz, mevcut kod tabanınıza göre bir strateji önerir.
    2. Bağlantı kurar: Temsilciniz yerel kodunuzu mevcut bir Firebase projesine bağlar veya yeni bir Firebase projesi oluşturmanıza yardımcı olur.
    3. Kaynakları başlatır: Temsilciniz, gerekli Firebase kitaplıklarını ve yapılandırmasını kod tabanınıza ekler.
    4. Dosyaları günceller: Temsilciniz, gerekli dosyaları oluşturur ve günceller. Örneğin, firestore.rules (veritabanınızdaki verileri kimlerin okuyabileceğini, yazabileceğini veya sorgulayabileceğini tanımlamak için) veya firebase.json (Firebase KSA'ya hangi hizmetlerin dağıtılacağını ve bunların nasıl yapılandırılacağını bildirmek için).
    5. Yürütür: Temsilciniz, ek yapılandırma veya dağıtım adımlarında size yol gösterir.

Yapay zeka destekli kodlama ajanına istem göndermeyle ilgili genel ipuçları

Yapay zeka kodlama asistanınızdan en iyi şekilde yararlanmak için, özellikle Firebase gibi çok yönlü entegrasyonlarla çalışırken etkileşimi tek seferlik bir komut yerine bir işbirliği olarak ele alın.

Net olun ve bağlam bilgisi verin

Firebase MCP sunucusu, temsilciye projeniz hakkında önemli bağlam bilgileri sağlasa da en iyi sonuçları net ve spesifik doğal dil istemleri verir. Net olmayan isteklerden kaçının.

  • Belirsiz: "Veritabanı hatasını düzelt."
  • Spesifik: "Cloud Firestore uygulamasındaki 'users' koleksiyonuna yazmaya çalışırken 'izin reddedildi' hatası alıyorum. firestore.rules kodumu incele ve kimliği doğrulanmış kullanıcıların kendi dokümanlarına yazmasına olanak tanıyan bir düzeltme öner."

Yineleme ve geliştirme

Yapay zeka kodlama aracıları, karmaşık görevler için ilk denemede nadiren mükemmel kod oluşturur. Bir yanıt tam olarak doğru değilse sohbete devam edin:

  • Hata mesajları sağlama: Terminal hatalarını veya konsol günlüklerini tekrar sohbete yapıştırın.
  • Düzenleme isteyin: "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ğrulama

Yapay zeka kodlama temsilcileri güçlüdür ancak hata yapabilir veya "halüsinasyon görebilir" (yanlış adlandırılmış işlevler veya hizmetler uydurabilir).

  • 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 yayınlamadan önce yerel olarak test etmenize yardımcı olması için temsilciden yardım isteyin.

MCP bağlantısını kullanma

Firebase MCP sunucusu, temsilcinize proje yapınızı doğrudan görme imkanı sağladığından, özel uygulama önerileri almak için belirli dosyalara başvurabilirsiniz.

  • Örnek: "src/web/index.html dosyama bak ve standart Firebase başlatma komut dosyasını nereye ekleyeceğimi göster."

Sonraki adımlar