Firebase Studio'da Firebase MCP

1. Genel Bakış

Bu codelab'de, Firebase Studio'da Firebase MCP sunucusu ile birlikte App Prototyping aracısını kullanarak Firestore'u kullanan bir tam yığın web uygulaması oluşturma alıştırması yapacaksınız.

Son uygulamanın animasyonlu GIF'i

Neler öğreneceksiniz?

  • Uygulama Prototipi Oluşturma aracısını kullanarak statik bir web uygulaması oluşturma
  • Firebase projesine bağlanma
  • Firebase MCP sunucusunu ayarlama
  • Firebase MCP'yi kullanarak Firestore'u ekleme

Gerekenler

  • Google Chrome gibi istediğiniz bir tarayıcı
  • Firebase projenizin oluşturulması ve yönetilmesi için bir Google Hesabı

2. Uygulama Prototipleme aracını kullanarak uygulamanızı oluşturma

Uygulama Prototipi Aracısı, uygulamanızı oluşturmak için Firebase'de Gemini'ı kullanır. Aynı istemler kullanıldığında bile sonuçlar farklı olabilir.

  1. Google Hesabınıza giriş yapın, Google Geliştirici Programı'na katılın ve Firebase Studio'yu açın.
  2. Yapay zeka ile uygulama prototipi oluşturun alanına uygulamanın açıklamasını girin:
    An app for a picker wheel that allows custom input.
    
  3. İstemi İyileştir'i tıklayın. İyileştirilmiş istemi inceleyin.
  4. Yapay zeka ile prototip oluşturun'u tıklayın.
  5. Önerilen uygulama planını inceleyin. Düzenlemek için codicon düzenlemesi için simgeyi özelleştirmeÖzelleştir'i tıklayın.
  6. Kaydet'i tıklayın.
  7. Plan, güncellemelerinizi eklemeyi tamamladığında Bu Uygulamanın Prototipini Oluştur'u tıklayın.Uygulamanın planı
  8. Planınızda yapay zeka öğeleri varsa aracı, Gemini Gemini anahtarı girmenizi ister. Kendi Gemini API anahtarınızı ekleyin veya Gemini API anahtarı oluşturmak için Otomatik oluştur'u tıklayın. Otomatik oluştur'u tıklarsanız Firebase Studio bir Firebase projesi oluşturur ve sizin için bir Gemini API anahtarı oluşturur.
  9. Uygulama Prototipleme aracısı, uygulamanızın ilk sürümünü oluşturmak için planı kullanır. İşlem tamamlandığında, uygulamanızın önizlemesi bir Gemini Chat arayüzüyle birlikte gösterilir. Uygulamanızı inceleyip test etmek için biraz zaman ayırın. Hatalarla karşılaşırsanız temsilcinin kendi hatalarını düzeltmesine izin vermek için sohbette Hatayı Düzelt'i tıklayın.

3. (İsteğe bağlı) Kodu alma

Takılırsanız bu noktadan itibaren örnek uygulamayı daha yakından takip etmek için örnek dosyaları kullanın.

  1. Klasördeki dosyaları indirin.
  2. Firebase Studio'da kod görünümü simgesi Koda Geç'i tıklayarak Kod görünümünü açın.
  3. İndirdiğiniz dosyaları Firebase Studio'nun Explorer bölmesine sürükleyin. Dosyaların mevcut dosyaları değiştirmesine izin verin.
  4. Paketleri yüklemek için terminalde (Shift+Ctrl+C) aşağıdaki komutu çalıştırın.
    npm install
    
  5. Firebase Studio'nun Kaynak Kontrolü bölmesini açın, kod değişikliğini açıklayan bir mesaj yazın (ör. "GitHub'dan kod içe aktarıldı") ve Commit'e (Yorumla) basın.
  6. Uygulamanın örnek sürümünü kullanarak codelab'e devam etmek için Prototip Oluşturucu'ya geç'i tıklayın.

4. Firebase projesine bağlanma

Tebrikler! Uygulamanız yerel olarak çalışıyor. Uygulamaya arka uç eklemek için bir sonraki adımda uygulamayı bir Firebase projesine bağlayacaksınız.

  1. Uygulama Prototipi Oluşturma aracısından bir Firebase projesine bağlanmasını isteyin.
    Connect to a Firebase project.
    
    Aracının yeni bir proje oluşturmasını veya mevcut bir projeye bağlanmasını bekleyin (Daha önce Gemini API anahtarı almak için otomatik oluşturma seçeneğini kullandıysanız projeniz ekranınızın sol üst köşesindeki çalışma alanı adınızın yanında görünür). Ardından, gerekli Firebase yapılandırmasını oluşturup src/lib/firebase.ts aracılığıyla uygulamanıza entegre edin (gösterildiği gibi).
    import { initializeApp, getApp, getApps } from 'firebase/app';
    
    const firebaseConfig = {
      "projectId": "foo-bar-baz",
      "appId": "1:630673270654:web:3eda41879acd38fa96ce14",
      "storageBucket": "foo-bar-baz.firebasestorage.app",
      "apiKey": "AIzaSyDGoMZQia334izw8JedslMTUD0fNpmFca0",
      "authDomain": "foo-bar-baz.firebaseapp.com",
      "measurementId": "",
      "messagingSenderId": "630673270654"
    };
    
    // Initialize Firebase
    const app = !getApps().length ? initializeApp(firebaseConfig) : getApp();
    
    export default app;
    
    Yukarıdaki istem görevi tek seferde tamamlayamazsa aracıya tekrar sormaktan çekinmeyin. Gerekirse adımları ayrı ayrı sorun.
    Create a new Firebase project.
    

5. Firebase Studio'da Firebase MCP'yi ayarlama

Firebase MCP sunucusu, Firebase Authentication, Cloud Firestore ve Firebase Data Connect dahil olmak üzere Firebase hizmetlerinden veri ayarlamak, yönetmek ve çekmek için aracının çağırabileceği araçlar sağlayarak Uygulama Prototipi Oluşturma aracısının özelliklerini genişletir. Bunu nasıl ayarlayacağınız aşağıda açıklanmıştır.

  1. Kod görünümünü açmak için Studio kod görünümü simgesiKoda Geç'i tıklayın.
  2. Terminalde (Shift+Ctrl+C), ekrandaki talimatları uygulayarak ve tüm varsayılan seçenekleri olduğu gibi bırakarak Firebase hesabınızda oturum açmak için aşağıdaki komutu çalıştırın:
    firebase login --no-localhost
    
  3. Gezgin'de (Ctrl+Shift+E) .idx klasörünü sağ tıklayın ve Yeni dosya'yı seçin. Dosyaya mcp.json adını verin ve Enter tuşuna basın.
  4. Sunucu yapılandırmalarını .idx/mcp.json dosyasına ekleyin.
    {
        "mcpServers": {
            "firebase": {
                "command": "npx",
                "args": [
                    "-y",
                    "firebase-tools@latest",
                    "experimental:mcp"
                ]
            }
        }
    }
    
    Firebase MCP sunucusuna bağlı olduğunuzu doğrulayın. Çıkış panelinde benzer günlük girişleri görmeniz gerekir. Doğru kanal olarak "Gemini" seçilmelidir.Gemini günlüklerinden MCPManager

6. Firebase MCP'yi kullanarak Firestore'u ekleme

1. hedef: Firestore'u ekleyin

  1. Prototyper'a geçin. Sohbet arayüzünde, temsilciden uygulamanızda Firestore'u kullanmasını isteyin.
    Use Firestore for user entries. Give anyone read and write access.
    
    Temsilcinin şunları yapmasını bekleyin:
    • Firebase MCP aracını firebase_init çağırarak Firestore'u başlatın. Bu işlem, diğer yapılandırma değişikliklerinin yanı sıra Firestore kurallarını (gösterildiği gibi) oluşturur ve dosyaları indeksler.
    • Uygulama kodunuzu yerel depolama yerine Firestore'u kullanacak şekilde güncelleyin.
    rules_version = '2';
    service cloud.firestore {
      match /databases/{database}/documents {
        match /{document=**} {
          allow read, write: if true;
        }
      }
    }
    
    Burada, herkese veritabanınızda okuma ve yazma erişimi verilir. Bu codelab'in dışında, veritabanlarınızı her zaman güvenli hale getirmeniz gerekir. Bu konu hakkında daha fazla bilgiyi dokümanlarımızda bulabilirsiniz.
  2. Koda geç'i tıklayın. Terminalde (Shift+Ctrl+C), mevcut Firebase projesinde Firestore API'yi hiç etkinleştirmediyseniz Firestore'u başlatın.
    firebase init firestore
    
    Ekrandaki talimatları uygulayın ve varsayılan seçenekleri değiştirmeyin. Önceki adımdaki güvenlik kurallarının üzerine yazmayın.Ardından, veritabanı örneğiniz için güvenlik kurallarını dağıtın.
    firebase deploy --only firestore
    
    Bu işlem, sizin için bir Firestore veritabanı örneği sağlar.

2. hedef: Test edin

  1. Uygulamanızı yeniden yükleyin, seçme çarkınızda girişler oluşturup silin ve bu güncellemeleri Firebase Console'daki Firestore sayfasında izleyin.

Studio ve Console'da uygulama

  1. Veritabanınızı sorgulamak için Firestore ile de sohbet edebilirsiniz.
    List my Firestore collections.
    
    Gemini'ın Firebase MCP aracını firestore_list_collections çağırmasını bekleyin.

Firestore ile sohbet etme

7. Sonuç

Tebrikler! Firebase MCP ile App Prototyping aracısını kullanarak tam yığınlı bir web uygulamasını başarıyla oluşturdunuz. Firebase MCP sunucusu tarafından sunulan diğer araçları denemekten ve uygulamanızın yapabileceklerini genişletmekten çekinmeyin.

Daha fazla bilgi