Integrar serviços do Firebase usando a assistência de IA

Simplifique a configuração do Firebase para web apps usando ferramentas de desenvolvimento com tecnologia de IA, como Antigravity, Claude Code, Codex e Cursor. Ao usar as habilidades do agente do Firebase com a CLI Firebase e o servidor MCP do Firebase, você pode transformar seu agente de programação de IA em um especialista do Firebase que pode escrever código, configurar Firebase Security Rules e gerenciar recursos ativos.

Este guia aborda o uso de um agente de programação de IA para ajudar a configurar Cloud Firestore, Firebase Authentication e Firebase Hosting para um app da Web. Em breve, vamos disponibilizar informações sobre apps iOS, Android e Flutter.

Por que usar as habilidades e ferramentas do agente do Firebase?

Os agentes de programação de IA costumam ter dificuldades com configurações específicas de projetos ou informações desatualizadas. Esse kit de ferramentas preenche essa lacuna combinando instruções especializadas (habilidades do agente) com dois tipos complementares de ferramentas de execução do agente (CLI e servidor MCP):

• Habilidades do agente do Firebase: forneça ao agente de programação experiência e fluxos de trabalho no domínio. Como camada de instrução, as habilidades orientam o agente sobre as práticas recomendadas para trabalhar com o Firebase, incluindo a escrita de código. As habilidades também ensinam ao agente quando e como usar a CLI Firebase e o servidor MCP do Firebase.
• Ferramentas de execução do agente:
  • CLI Firebase (ferramentas de linha de comando): fornece ferramentas para ciclo de vida do projeto e tarefas de ambiente. O agente pode executar comandos da CLI em um ambiente de terminal para configurar serviços em um projeto do Firebase, implantar sites completos ou recursos de back-end, iniciar emuladores locais e muito mais.
  • Servidor MCP do Firebase (ferramentas e recursos programáticos): oferece ferramentas para inspeção em tempo real e operações de dados. Com chamadas de ferramentas estruturadas, o agente pode consultar e atualizar de forma programática documentos Cloud Firestore, gerenciar usuários Firebase Authentication, validar Security Rules, extrair registros ou documentação em tempo real diretamente para o contexto e muito mais.

Usar habilidades do agente do Firebase com a CLI Firebase e o servidor MCP do Firebase dá ao seu agente de programação de IA mais recursos:

• Entre em ação: faça mais do que apenas escrever código. Seu agente pode inicializar serviços, gerenciar usuários do Firebase Authentication, implantar novos Firebase Security Rules e trabalhar diretamente com seus dados do Cloud Firestore.
• Fique por dentro das novidades: use comandos oficiais e com reconhecimento de versão para orientar seu agente nas tarefas de configuração.
• Melhorar a precisão: acesse o ambiente e os esquemas do seu projeto para oferecer ajuda mais relevante e precisa.
• Reduzir os custos de token: as habilidades do agente carregam documentação detalhada apenas quando uma tarefa específica exige isso, o que minimiza a sobrecarga da sessão.

Serviços do Firebase aplicáveis

Este guia se concentra principalmente em como as habilidades do agente, a CLI Firebase e o servidor MCP do Firebase trabalham juntos para ajudar você a configurar rapidamente estes serviços e recursos:

• Cloud Firestore: provisione um banco de dados NoSQL.
• Firebase Authentication: configure o login seguro do usuário.
• Firebase Security Rules: gere e refine Security Rules para seu app.
• Firebase Hosting: configure seu projeto para a implantação de um app da Web estático.

Para uma lista completa do que está disponível, navegue pela lista completa de habilidades do agente do Firebase.

Fluxo de trabalho geral

As etapas a seguir descrevem um fluxo de trabalho generalizado para usar as habilidades do agente do Firebase para configurar e usar os serviços do Firebase em um app da Web. Nos bastidores, as habilidades do agente usam a CLI Firebase e o servidor MCP do Firebase para concluir essas tarefas.

Etapa 1: instalar habilidades do agente do Firebase

Na maioria dos casos, é possível instalar as habilidades do agente do Firebase no editor de sua preferência com um único comando:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

npx skills add firebase/agent-skills

Etapa 2: conectar-se ao servidor MCP do Firebase

Embora muitas habilidades do agente do Firebase usem a CLI Firebase para tarefas, também é recomendável conectar seu agente de programação de IA ao servidor MCP do Firebase. Essa conexão aumenta a capacidade do seu agente de interagir com o ambiente do Firebase, oferecendo integração e acesso mais profundos.

Método assistido por IA

Na maioria dos casos, você pode pedir ao seu agente de programação de IA para configurar o servidor MCP do Firebase. No entanto, se ele tiver dificuldades ou não vir o servidor MCP do Firebase na lista, mude para o método manual.

Método manual

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

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

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

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

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

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

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

Etapa 3: inicializar os serviços do Firebase

Com as habilidades do agente e as ferramentas configuradas, agora você pode usar a linguagem natural para que seu agente de programação de IA configure Cloud Firestore, Firebase Authentication e Firebase Hosting.

1. Peça para o agente configurar um serviço. Por exemplo, você pode usar comandos como estes:

   • Configure o Cloud Firestore como o banco de dados deste app.
   • Crie uma página de login usando Authentication e atualize Security Rules para garantir que apenas usuários autorizados possam ler e gravar os próprios dados.
   • Configure o Firebase Hosting e implante o app na produção.

2. Revise as informações e siga as etapas guiadas que o agente pode fornecer, como:

   1. Planos: o agente propõe uma estratégia com base na sua base de código atual.
   2. Conecta: seu agente vincula o código local a um projeto do Firebase ou ajuda você a criar um novo projeto.
   3. Inicializa recursos: o agente adiciona as bibliotecas e a configuração necessárias do Firebase à sua base de código.
   4. Atualiza arquivos: seu agente cria e atualiza todos os arquivos necessários, como firestore.rules (para definir quem pode ler, gravar ou consultar dados no banco de dados) ou firebase.json (para informar à CLI Firebase quais serviços implantar e como configurá-los).
   5. Executa: seu agente orienta você em etapas adicionais de configuração ou implantação.

Dicas gerais para dar comandos a um agente de programação de IA

Para aproveitar ao máximo seu agente de programação de IA, principalmente ao trabalhar com integrações multifacetadas como o Firebase, trate a interação como uma colaboração em vez de um comando único.

Seja específico e dê contexto

Embora o servidor MCP do Firebase forneça ao agente um contexto significativo sobre seu projeto, comandos claros e específicos em linguagem natural geram os melhores resultados. Evite solicitações vagas.

• Vago: "Corrija o erro do banco de dados."
• Específico: "Recebo um erro de 'permissão negada' ao tentar gravar na coleção 'users' em Cloud Firestore. Revise meu firestore.rules e sugira uma correção que permita que usuários autenticados gravem no próprio documento."

Itere e aprimore

Os agentes de programação de IA raramente geram código perfeito na primeira tentativa para tarefas complexas. Se uma resposta não estiver totalmente correta, continue a conversa:

• Forneça mensagens de erro: cole no chat erros de terminal ou registros do console.
• Pedir ajustes: "Esse código usa o SDK v8 mais antigo. Reescreva usando o SDK modular v9 do Firebase."
• Pedir explicações: "Explique como esses Firebase Security Rules protegem os dados do usuário".

Verifique antes de executar

Os agentes de programação de IA são poderosos, mas podem cometer erros ou "alucinar" (inventar funções ou serviços com nomes incorretos).

• Revise o código: sempre leia o código gerado, especialmente Firebase Security Rules e arquivos de configuração (como firebase.json), antes de implantar na produção.
• Teste localmente: sempre que possível, peça ajuda ao agente para testar mudanças localmente antes de publicá-las.

Usar a conexão do MCP

Como o servidor MCP do Firebase oferece ao seu agente visibilidade direta da estrutura do projeto, é possível fazer referência a arquivos específicos para receber conselhos de implementação personalizados.

• Exemplo: "Analise meu arquivo src/web/index.html e mostre onde adicionar o script de inicialização padrão do Firebase".

Próximas etapas

• Confira uma lista completa de todas as habilidades disponíveis do agente do Firebase.
• Confira uma lista completa de todos os comandos, ferramentas e recursos disponíveis que o servidor MCP do Firebase oferece.
• Saiba mais sobre as ferramentas fornecidas pela CLI Firebase.