Firebase MCP sunucusu

Yapay zeka destekli geliştirme araçlarının Firebase projelerinizle çalışabilmesi için Firebase MCP sunucusunu kullanabilirsiniz. Firebase MCP sunucusu; Claude Desktop, Cline, Cursor, Visual Studio Code Copilot ve Windsurf Editor gibi MCP istemcisi olarak işlev görebilen tüm araçlarla çalışır.

Firebase MCP sunucusunu kullanacak şekilde yapılandırılmış bir düzenleyici, yapay zeka özelliklerini kullanarak şunları yapmanıza yardımcı olabilir:

• Firebase projeleri oluşturma ve yönetme
• Firebase Authentication kullanıcılarınızı yönetme
• Cloud Firestore ve Firebase Data Connect'teki verilerle çalışma
• Firebase Data Connect şemalarını alma
• Firestore ve Firebase için Cloud Storage'deki güvenlik kurallarınızı anlama
• Firebase Cloud Messaging ile mesaj gönderme

Bazı araçlar, size yardımcı olmak için Firebase'de Gemini'ı kullanır:

• Firebase Data Connect şeması ve işlemleri oluşturma
• Firebase ürünleri hakkında Gemini'a danışma

Bunlar yalnızca kısmi listelerdir. Düzenleyicinizde kullanılabilecek araçların tam listesi için sunucu özellikleri bölümüne bakın.

Firebase MCP sunucusu araç çağrıları yaptığında, çalıştığı ortamda Firebase CLI'yi yetkilendiren kullanıcı kimlik bilgilerini kullanır. Bu, ortama bağlı olarak giriş yapmış bir kullanıcı veya Application Default Credentials olabilir.

Başlamadan önce

Node.js ve npm'nin çalışır durumda yüklendiğinden emin olun.

MCP istemcinizi ayarlama

Firebase MCP sunucusu, aktarım ortamı olarak standart I/O (stdio) özelliğini destekleyen tüm MCP istemcileriyle çalışabilir.

Temel yapılandırma

Bu bölümde, bazı popüler yapay zeka destekli araçlarla ilgili özel talimatları bulabilirsiniz:

• Firebase Studio
• Gemini CLI ve Gemini Code Assist
• Claude Code
• Claude Desktop
• Cline
• İmleç
• Visual Studio Code Copilot
• Windsurf Editor

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", "experimental:mcp"]
    }
  }
}

Gemini CLI ve Gemini Code Assist

Gemini CLI veya Gemini Code Assist'i Firebase MCP sunucusunu kullanacak şekilde ayarlamanın önerilen yolu, Gemini CLI için Firebase uzantısını yüklemektir:

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

Firebase uzantısını yüklediğinizde Firebase MCP sunucusu otomatik olarak yapılandırılır. Ayrıca, Gemini'ın Firebase uygulama geliştirme performansını artırabilecek bir bağlam dosyası da yüklenir.

Alternatif olarak, yapılandırma dosyalarından birini düzenleyerek veya oluşturarak Gemini CLI'yı ya da Gemini Code Assist'i Firebase MCP sunucusunu (ancak Firebase uzantısı bağlam dosyasını değil) kullanacak şekilde yapılandırabilirsiniz:

• Projenizde: .gemini/settings.json
• Ana dizininizde: ~/.gemini/settings.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", "experimental:mcp"]
    }
  }
}

Claude Code

Claude Code'u Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için uygulama klasörünüzde aşağıdaki komutu çalıştırın:

claude mcp add firebase npx -- -y firebase-tools@latest experimental:mcp

Yüklemeyi doğrulamak için şu komutu çalıştırın:

claude mcp list

Şunlar gösterilmelidir:

firebase: npx -y firebase-tools@latest experimental:mcp - ✓ Connected

Claude Desktop

Claude Desktop'u 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", "experimental: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", "experimental:mcp"],
      "disabled": false
    }
  }
}

İmleç

Cursor'ı Firebase MCP sunucusunu kullanacak şekilde yapılandırmak için .cursor/mcp.json dosyasını (yalnızca belirli bir projeyi yapılandırmak için) veya ~/.cursor/mcp.json dosyasını (MCP sunucusunu tüm projelerde kullanılabilir hale getirmek için) düzenleyin:

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

Visual Studio 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", "experimental:mcp"]
  }
}

Sunucuyu açtığınız her projede kullanılabilir hale getirmek için kullanıcı ayarlarınızı düzenleyin:

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
    }
  }
}

Windsurf Editor

Windsurf Editor'u yapılandırmak için dosyayı düzenleyin ~/.codeium/windsurf/mcp_config.json:

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

İsteğe bağlı yapılandırma

Daha önce gösterilen her istemci için temel yapılandırmaya ek olarak, belirleyebileceğiniz iki isteğe bağlı parametre vardır:

• --dir ABSOLUTE_DIR_PATH: MCP sunucusu için proje bağlamı ayarlamak üzere firebase.json içeren bir dizinin mutlak yolu. Belirtilmemişse get_project_directory ve set_project_directory araçları kullanılabilir hale gelir ve varsayılan dizin, MCP sunucusunun başlatıldığı çalışma dizini olur.

• --only FEATURE_1,FEATURE_2: Etkinleştirilecek özellik gruplarının virgülle ayrılmış listesi. Bu özelliği, yalnızca aktif olarak kullandığınız özelliklere sunulan araçları sınırlandırmak için kullanın. Temel araçların her zaman kullanılabildiğini unutmayın.

Örneğin:

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "experimental:mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

MCP sunucusu özellikleri

Firebase MCP sunucusu, üç farklı MCP özelliği kategorisi sunar: istemler, araçlar ve kaynaklar.

İstemler

Firebase MCP sunucusu, Firebase uygulama geliştirme için optimize edilmiş önceden yazılmış istemler kitaplığıyla birlikte gelir. Bu istemleri çalıştırarak çeşitli yaygın Firebase geliştirme görevlerini tamamlayabilirsiniz.

MCP'yi destekleyen çoğu geliştirme aracı, bu istemleri çalıştırmak için uygun bir yöntem sunar. Örneğin, Gemini CLI bu istemleri eğik çizgi komutları olarak kullanıma sunar:

/firebase:init

Kullanılabilir komutların listesini görmek için Gemini CLI'da /firebase: yazın. Bu komutlar aşağıdaki tabloda da listelenmiştir:

Bu bilgileri şu komutu kullanarak da görebilirsiniz:

npx firebase-tools@latest mcp --generate-prompt-list

Araçlar

Firebase MCP sunucusu, LLM'lerin doğrudan Firebase projenizle (onayınızla) çalışmasına olanak tanıyan çeşitli araçlar da sunar. İstemlerin aksine, bu araçları doğrudan çağırmazsınız. Bunun yerine, araç çağırma özelliğini destekleyen modeller (ör. Gemini, Claude ve GPT) gerektiğinde geliştirme görevlerini gerçekleştirmek için bu araçları otomatik olarak çağırabilir.

Aşağıdaki tabloda, MCP sunucusunun sunduğu araçlar listelenmiştir.

Bu bilgileri şu komutu kullanarak da görebilirsiniz:

npx firebase-tools@latest mcp --generate-tool-list

Kaynaklar

MCP sunucusu, kaynaklar sağlar. Bu kaynaklar, LLM'ler tarafından kullanılmak üzere tasarlanmış doküman dosyalarıdır. Kaynak kullanımını destekleyen modeller, oturum bağlamına otomatik olarak alakalı kaynakları ekler.

Aşağıdaki tabloda, MCP sunucusunun kullanıma sunduğu kaynaklar listelenmiştir.

Bu bilgileri şu komutu kullanarak da görebilirsiniz:

npx firebase-tools@latest mcp --generate-resource-list