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

Simplifique a configuração do Firebase para apps da Web 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 Firebase CLI 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 geralmente têm 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 de agente (CLI e servidor MCP):

• Habilidades do agente do Firebase: forneça ao agente de programação conhecimento e fluxos de trabalho do domínio. Como a 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 Firebase CLI e o servidor MCP do Firebase.
• Ferramentas de execução de agente:
  • Firebase CLI (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): fornece ferramentas para inspeção em tempo real e operações de dados. Por meio de chamadas de ferramentas estruturadas, o agente pode consultar e atualizar Cloud Firestore documentos de maneira programática, gerenciar Firebase Authentication usuários, validar Security Rules, extrair registros ou documentação diretamente no contexto, e muito mais.

O uso das habilidades do agente do Firebase com a Firebase CLI e o servidor MCP do Firebase oferece ao seu agente de programação de IA mais habilidades:

• Entre em ação: faça mais do que apenas escrever código. Seu agente pode inicializar serviços, gerenciar Firebase Authentication usuários, implantar novas Firebase Security Rules, e trabalhar diretamente com seus dados Cloud Firestore.
• Manter-se atualizado: use comandos oficiais e com reconhecimento de versão para orientar o agente nas tarefas de configuração.
• Melhorar a precisão: acesse o ambiente e os esquemas do projeto para oferecer ajuda mais relevante e precisa.
• Reduzir os custos de token: as habilidades do agente carregam a 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 Firebase CLI e o servidor MCP do Firebase funcionam juntos para ajudar você a configurar rapidamente esses 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 implantação de apps da Web estáticos.

Para uma lista completa do que está disponível, consulte a 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 as 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 Firebase CLI para tarefas, também é recomendável conectar seu agente de programação de IA ao servidor MCP do Firebase. Essa conexão melhora a capacidade do 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 se o servidor MCP do Firebase não estiver listado, 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 e ferramentas do agente 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 ao agente para configurar um serviço. Por exemplo, você pode usar comandos como estes:

   • Configure Cloud Firestore como o banco de dados desse 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 Firebase Hosting e implante o app na produção.

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

   1. Planos: seu agente propõe uma estratégia com base na sua base de código existente.
   2. Conexões: seu agente vincula o código local a um projeto do Firebase ou ajuda você a criar um novo projeto do Firebase.
   3. Inicializa recursos: seu 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 do Firebase quais serviços implantar e como configurá-los).
   5. Executa: seu agente orienta você nas etapas adicionais de configuração ou implantação.

Dicas gerais para solicitar um agente de programação de IA

Para aproveitar ao máximo seu agente de programação de IA, especialmente 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 o projeto, comandos de linguagem natural claros e específicos geram os melhores resultados. Evite solicitações vagas.

• Vago: "Corrija o erro do banco de dados."
• Específico: "Estou recebendo um erro de 'permissão negada' ao tentar gravar na coleção 'users' em Cloud Firestore. Analise minhas 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 todos os erros de terminal ou registros do console de volta no chat.
• Peça ajustes: "Esse código usa o SDK v8 mais antigo. Reescreva-o usando o SDK modular do Firebase v9."
• Solicite explicações: "Explique como essas 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 nomeadas ou serviços com nomes incorretos).

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

Use a conexão MCP

Como o servidor MCP do Firebase oferece ao agente visibilidade direta na estrutura do projeto, você pode referenciar 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

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