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.

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

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

  • Firebase aracı becerileri: Kodlama temsilcisine alan uzmanlığı ve iş akışları sağlar. Talimat katmanı olarak beceriler, kod yazma da dahil olmak üzere Firebase ile çalışmayla ilgili en iyi uygulamalar konusunda temsilciye rehberlik eder. 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ı denetim ve veri işlemleri için araçlar sağlar. Temsilci, yapılandırılmış araç çağrıları aracılığıyla Cloud Firestore dokümanlarını programatik olarak sorgulayıp güncelleyebilir, Firebase Authentication kullanıcılarını yönetebilir, Security Rules'yi doğrulayabilir, canlı günlükleri veya dokümanları doğrudan bağlama çekebilir ve daha fazlasını 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ı temel hazırlığı yapın.
  • 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, bir web uygulamasında Firebase hizmetlerini ayarlamak ve kullanmak için Firebase aracı becerilerinin nasıl kullanılacağına dair genel bir iş akışı açıklanmaktadır. Aracı becerileri, bu görevleri tamamlamak için arka planda Firebase CLI'yı ve Firebase MCP sunucusunu kullanı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. Aşağıdaki seçeneklerden birini kullanarak eklentiyi yükleyin:

    • Antigravity Marketplace'ten: Özelleştirmeler'i tıklayın, Marketplace sekmesini seçin ve ardından 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 temsilcinizden Firebase MCP sunucusunu kurması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 (genel) için ~/.cursor/mcp.json öğesini 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. Cline bölmesinin üst kısmındaki MCP Sunucuları simgesini, ardından MCP Sunucularını Yapılandır düğmesini tıklayarak bu dosyayı açabilir veya oluşturabilirsiniz.

{
  "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 şu 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

Temsilci becerileri ve araçları ayarlandıktan sonra artık doğal dili kullanarak yapay zeka kodlama temsilcinizin Cloud Firestore, Firebase Authentication ve Firebase Hosting ayarlarını yapmasını sağlayabilirsiniz.

  1. Temsilcinizden bir hizmet ayarlamasını isteyin. Örneğin, şunlar gibi istemlerden yararlanabilirsiniz:

    • 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. Temsilcinizin sağlayabileceği tüm 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ı kurma: 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 ajanlarına istem verme ile 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. Belirsiz isteklerden kaçının.

  • Belirsiz: "Veritabanı hatasını düzeltin."
  • 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."

İterasyon yapın ve iyileştirin

Yapay zeka kodlama temsilcileri, karmaşık görevler için ilk denemede nadiren mükemmel kod üretir. 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 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, oluşturulan kodu (özellikle Firebase Security Rules ve firebase.json gibi yapılandırma dosyalarını) her zaman 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