Firebase MCP Server

Firebase MCP Server

O Firebase Model Context Protocol (MCP) Server oferece a ferramentas de desenvolvimento com IA a capacidade de trabalhar com seus projetos Firebase e o código do seu aplicativo. O servidor Firebase MCP funciona com qualquer ferramenta que possa atuar como um cliente MCP, incluindo: Firebase Studio, Gemini CLI, Claude Code, Cline, Cursor, VS Code Copilot, Windsurf e muito mais!

Recursos

Um editor configurado para usar o servidor Firebase MCP pode usar seus recursos de IA para ajudar você a:

• Criar e gerenciar projetos Firebase - Inicializar novos projetos, listar os existentes e gerenciar aplicativos Firebase
• Gerenciar usuários do Firebase Authentication - Recuperar, atualizar e gerenciar contas de usuário
• Trabalhar com Cloud Firestore e Firebase SQL Connect - Consultar, ler, escrever e gerenciar documentos do banco de dados
• Recuperar esquemas do Firebase SQL Connect - Gerar esquemas e operações com assistência de IA
• Entender regras de segurança - Validar e recuperar regras de segurança para Firestore, Cloud Storage e Realtime Database
• Enviar mensagens com Firebase Cloud Messaging - Enviar notificações push para dispositivos e tópicos
• Acessar dados do Crashlytics - Depurar problemas, visualizar relatórios de falhas e gerenciar análises de falhas
• Implantar no App Hosting - Monitorar backends e recuperar logs
• Trabalhar com Realtime Database - Ler e escrever dados em tempo real
• Consultar logs do Cloud Functions - Recuperar e analisar logs de execução de funções
• Gerenciar Remote Config - Obter e atualizar modelos de configuração remota

Algumas ferramentas usam o Gemini no Firebase para ajudar você a:

• Gerar esquemas e operações do Firebase SQL Connect
• Consultar o Gemini sobre produtos Firebase

Importante: O Gemini no Firebase pode gerar resultados que parecem plausíveis, mas são factualmente incorretos. Ele pode responder com informações imprecisas que não representam as opiniões do Google. Valide toda a saída do Gemini antes de usá-la e não use código gerado não testado em produção. Não insira informações de identificação pessoal (PII) ou dados de usuário no chat.
Saiba mais sobre o Gemini no Firebase e como ele usa seus dados.

Instalação e Configuração

Pré-requisitos

Certifique-se de ter uma instalação funcional do Node.js e do npm.

Configuração Básica

O servidor Firebase MCP pode funcionar com qualquer cliente MCP que suporte entrada/saída padrão (stdio) como meio de transporte. Quando o servidor Firebase MCP faz chamadas de ferramentas, ele usa as mesmas credenciais de usuário que autorizam a Firebase CLI no ambiente onde está sendo executado.

Aqui estão as instruções de configuração para ferramentas populares de assistência por IA:

Gemini CLI

Instale a extensão Firebase para Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills

Claude Code

Opção 1: Instalar via plugin (Recomendado)

A maneira mais fácil de configurar o servidor Firebase MCP no Claude Code é instalar o plugin oficial do Firebase:

1. Adicione o marketplace Firebase para plugins do Claude:

   claude plugin marketplace add firebase/firebase-tools
   

2. Instale o plugin Claude para Firebase:

   claude plugin install firebase@firebase
   

3. Verifique a instalação:

   claude plugin
   

Opção 2: Configurar o servidor MCP manualmente

Alternativamente, você pode configurar manualmente o servidor Firebase MCP executando:

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

Você pode verificar a instalação executando:

claude mcp list

Deve mostrar:

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

Cursor

Adicione a .cursorrules no diretório do seu projeto ou configure nas configurações do Cursor:

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

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

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

Firebase Studio

Para configurar o Firebase Studio para usar o servidor Firebase MCP, edite ou crie o arquivo de configuração: .idx/mcp.json

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

Uso

Uma vez configurado, o servidor MCP fornecerá automaticamente recursos do Firebase ao seu assistente de IA. Você pode:

• Pedir à IA para ajudar a configurar serviços do Firebase
• Consultar seu banco de dados Firestore
• Gerenciar usuários de autenticação
• Implantar no Firebase Hosting
• Depurar problemas do Crashlytics
• E muito mais!

Para uma lista completa de ferramentas e recursos disponíveis, consulte a seção Capacidades do Servidor abaixo.

Documentação

Para mais informações, visite a documentação oficial do servidor Firebase MCP.

Capacidades do Servidor

O servidor Firebase MCP fornece três tipos de capacidades: Ferramentas (funções que executam ações), Prompts (modelos de comandos reutilizáveis) e Recursos (arquivos de documentação para modelos de IA).

Nome da Ferramenta	Grupo de Recursos	Descrição
apphosting_fetch_logs	apphosting	Buscar logs recentes de serviço ou build para um backend do App Hosting.
apphosting_list_backends	apphosting	Listar backends do App Hosting, configurações de tráfego e domínios personalizados no seu projeto.
auth_get_users	auth	Recuperar usuários do Firebase Auth por UID, e-mail, número de telefone ou listar todos os usuários.
auth_update_user	auth	Atualizar a conta de um usuário habilitando/desabilitando-a ou definindo claims personalizados.
auth_set_sms_region_policy	auth	Definir uma política de região de SMS permitindo ou negando códigos de país específicos para o Firebase Authentication.
firebase_login	core	Autenticar o usuário no Firebase CLI e no servidor MCP ou verificar o status atual de autenticação.
firebase_logout	core	Desconectar o usuário do Firebase CLI e do servidor MCP.
firebase_validate_security_rules	core	Validar a sintaxe e verificar erros nas regras de segurança do Firestore, Storage ou Realtime Database.
firebase_get_project	core	Recuperar metadados e detalhes de configuração do projeto Firebase atualmente ativo.
firebase_list_apps	core	Listar todos os aplicativos Firebase registrados no projeto ativo.
firebase_list_projects	core	Listar projetos Firebase acessíveis pelo usuário autenticado.
firebase_get_sdk_config	core	Recuperar detalhes de configuração do SDK ou o conteúdo do arquivo de configuração de um aplicativo Firebase registrado.
firebase_create_project	core	Criar um novo projeto Firebase ou habilitar serviços Firebase em um projeto existente do Google Cloud.
firebase_create_app	core	Criar um novo aplicativo iOS, Android ou Web no projeto Firebase ativo.
firebase_create_android_sha	core	Adicionar um hash de certificado SHA-1 ou SHA-256 a um aplicativo Android no projeto Firebase ativo.
firebase_get_environment	core	Recuperar a configuração atual do ambiente do Firebase CLI e do MCP, o projeto ativo e o usuário autenticado.
firebase_update_environment	core	Atualizar configurações do ambiente, como diretório do projeto, projeto ativo ou conta de usuário ativa.
firebase_init	core	Inicializar e configurar serviços Firebase no seu espaço de trabalho local do projeto.
firebase_get_security_rules	core	Recuperar as regras de segurança ativas para Firestore, Storage ou Realtime Database.
firebase_read_resources	core	Ler o conteúdo dos recursos internos de documentação firebase:// ou listar todos os recursos disponíveis.
crashlytics_create_note	crashlytics	Adicionar uma nota a um problema do Crashlytics para um aplicativo Android ou iOS.
crashlytics_delete_note	crashlytics	Excluir uma nota de um problema do Crashlytics para um aplicativo Android ou iOS.
crashlytics_get_issue	crashlytics	Recuperar detalhes e metadados de um problema específico do Crashlytics.
crashlytics_list_events	crashlytics	Listar eventos recentes de falhas e exceções que correspondam aos filtros especificados para um problema.
crashlytics_batch_get_events	crashlytics	Recuperar eventos de amostra de falhas e exceções por nome de recurso para depuração.
crashlytics_list_notes	crashlytics	Listar todas as notas anexadas a um problema do Crashlytics para um aplicativo Android ou iOS.
crashlytics_get_report	crashlytics	Gerar relatórios numéricos agregados para problemas e eventos do Crashlytics.
crashlytics_update_issue	crashlytics	Atualizar o estado (ABERTO ou FECHADO) de um problema do Crashlytics.
realtimedatabase_get_data	realtimedatabase	Ler dados de um caminho especificado no Firebase Realtime Database.
realtimedatabase_set_data	realtimedatabase	Gravar dados JSON em um caminho especificado no Firebase Realtime Database.
dataconnect_build	dataconnect	Compilar esquemas, operações e conectores do Firebase SQL Connect para validar sintaxe e tipos.
dataconnect_list_services	dataconnect	Listar serviços, esquemas e conectores locais e implantados do Firebase SQL Connect.
dataconnect_execute	dataconnect	Executar uma consulta ou mutação GraphQL contra um serviço ou emulador do Firebase SQL Connect.
firestore_delete_document	firestore	Use isto para excluir documentos do Firestore de um banco de dados no projeto atual por caminhos completos de documento. Use isto se você souber o caminho exato de um documento.
firestore_get_documents	firestore	Use isto para recuperar um ou mais documentos do Firestore de um banco de dados no projeto atual por caminhos completos de documento. Use isto se você souber o caminho exato de um documento.
firestore_list_collections	firestore	Use isto para recuperar uma lista de coleções de um banco de dados do Firestore no projeto atual.
firestore_query_collection	firestore	Consultar documentos do Firestore de uma coleção com filtros e ordenação opcionais.
functions_get_logs	functions	Recuperar e filtrar entradas de log do Cloud Functions do Google Cloud Logging.
functions_list_functions	functions	Listar todas as Cloud Functions implantadas no seu projeto Firebase.
messaging_send_message	messaging	Enviar uma notificação push do Firebase Cloud Messaging para um token de registro de dispositivo ou tópico.
remoteconfig_get_template	remoteconfig	Recuperar a versão ativa ou especificada do modelo do Firebase Remote Config.
remoteconfig_update_template	remoteconfig	Publicar um novo modelo do Firebase Remote Config ou reverter para uma versão anterior.
storage_get_object_download_url	storage	Recuperar a URL de download de um objeto em um bucket do Cloud Storage.

Nome do Prompt	Grupo de Recursos	Descrição
firebase:deploy	core	Use este comando para implantar recursos no Firebase. Argumentos: <prompt> (opcional): quaisquer instruções específicas que você deseje fornecer sobre a implantação
firebase:init	core	Use este comando para configurar serviços Firebase, como recursos de backend e IA.
firestore:generate_security_rules	firestore	Gerar regras de segurança seguras do Firebase Firestore e testes unitários correspondentes para o seu projeto.
storage:generate_security_rules	storage	Gerar regras de segurança seguras do Firebase Storage e testes unitários correspondentes para o seu projeto.
crashlytics:connect	crashlytics	Use este comando para acessar os dados do Crashlytics de um aplicativo Firebase.
Nome do Recurso	Descrição
---------------------------------	-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
app_id_guide	Guia de ID do App Firebase: orienta o agente de codificação na escolha de um ID de App Firebase no projeto atual
crashlytics_investigations_guide	Guia de Investigações do Firebase Crashlytics: orienta o agente de codificação ao investigar bugs relatados em issues do Crashlytics, incluindo procedimentos para diagnosticar e corrigir falhas.
crashlytics_issues_guide	Guia de Issues do Firebase Crashlytics: orienta o agente de codificação ao trabalhar com issues do Crashlytics, incluindo regras de priorização e procedimentos para diagnosticar e corrigir falhas.
crashlytics_reports_guide	Guia de Relatórios do Firebase Crashlytics: orienta o agente de codificação ao solicitar relatórios do Crashlytics, incluindo a definição de filtros apropriados e como entender as métricas. O agente deve ler este guia antes de solicitar qualquer relatório.
backend_init_guide	Guia de Inicialização do Backend Firebase: orienta o agente de codificação na configuração dos serviços de backend do Firebase no projeto atual
ai_init_guide	Guia de Inicialização do Firebase GenAI: orienta o agente de codificação na configuração das capacidades de GenAI no projeto atual utilizando o Firebase
firestore_init_guide	Guia de Inicialização do Firestore: orienta o agente de codificação na configuração do Firestore no projeto atual
firestore_rules_init_guide	Guia de Inicialização de Regras do Firestore: orienta o agente de codificação na configuração das regras de segurança do Firestore no projeto
auth_init_guide	Guia de Inicialização do Firebase Authentication: orienta o agente de codificação na configuração do Firebase Authentication no projeto atual
hosting_init_guide	Guia de Implantação do Firebase Hosting: orienta o agente de codificação na implantação no Firebase Hosting no projeto atual
docs	Documentação do Firebase: carrega conteúdo em texto simples da documentação do Firebase, por exemplo, https://firebase.google.com/docs/functions torna-se firebase://docs/functions