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 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:

  1. Antigravity bölümünde, Aracı bölmesindeki menüsü > MCP Sunucuları'nı tıklayın.
  2. 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:

    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ö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:

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 simgesini 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.

  1. 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.
  2. Temsilcinizin sağlayabileceği bilgileri inceleyin ve yönlendirmeli adımları uygulayın. Örneğin:

    1. Planlar: Ajanınız, mevcut kod tabanınıza göre bir strateji önerir.
    2. Bağlama: Aracınız, yerel kodunuzu mevcut bir Firebase projesine bağlar veya yeni bir Firebase projesi oluşturmanıza yardımcı olur.
    3. Kaynakları başlatır: Ajanınız, kod tabanınıza gerekli Firebase kitaplıklarını ve yapılandırmasını ekler.
    4. 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 da firebase.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.
    5. 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.rules gö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.html dosyama bak ve standart Firebase başlatma komut dosyasını nereye ekleyeceğimi göster."

Sonraki adımlar