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 CLI do 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 o Firebase Security Rules e gerenciar recursos ativos.

Este guia aborda o uso de um agente de programação de IA para ajudar a configurar o Cloud Firestore, o Firebase Authentication e o Firebase Hosting para um app da Web. Volte em breve para conferir 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 de projeto específicas ou informações desatualizadas. Este kit de ferramentas preenche essa lacuna combinando instruções especializadas (habilidades do agente) com dois tipos complementares de ferramentas de execução de agentes (CLI e servidor MCP):

• Habilidades do agente do Firebase: forneça ao agente de programação conhecimento de domínio e fluxos de trabalho. Como camada de instrução, as habilidades orientam o agente sobre as práticas recomendadas para trabalhar com o Firebase, incluindo a programação. As habilidades também ensinam ao agente quando e como usar a CLI Firebase e o servidor MCP do Firebase.
• Ferramentas de execução de agentes:
  • CLI da Firebase (ferramentas de linha de comando): fornece ferramentas para tarefas de ciclo de vida e ambiente do projeto. 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 do Cloud Firestore, gerenciar usuários do Firebase Authentication, validar Security Rules, extrair registros ou documentação em tempo real diretamente para o contexto e muito mais.

Usar as 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 habilidades:

• 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.
• Mantenha-se atualizado: use comandos oficiais e que reconhecem a versão para orientar seu agente nas tarefas de configuração.
• Melhorar a precisão: acesse o ambiente e os esquemas do projeto para fornecer 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 CLI do Firebase e o servidor MCP do Firebase trabalham juntos para ajudar você a configurar rapidamente estes serviços e recursos:

• Cloud Firestore: provisionar 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 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 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 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 houver problemas ou se o servidor MCP do Firebase não estiver listado, use 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 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 para este app.
   • Crie uma página de login usando o Authentication e atualize o 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. Analise 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. Conexões: o agente vincula seu código local a um projeto do Firebase ou ajuda você a criar um novo.
   3. Inicializa recursos: o agente adiciona as bibliotecas e a configuração necessárias do Firebase à sua base de código.
   4. Atualiza arquivos: o 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: o agente orienta você em outras etapas de configuração ou implantação.

Dicas gerais para criar comandos para 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, e não como 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: "Estou recebendo um erro de 'permissão negada' ao tentar gravar na coleção 'usuários' no Cloud Firestore. Revise 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 um código perfeito na primeira tentativa para tarefas complexas. Se uma resposta não estiver certa, continue a conversa:

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

Verificar 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).

• Revise 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 as mudanças localmente antes de publicá-las.

Usar a conexão do MCP

Como o servidor MCP do Firebase dá ao agente visibilidade direta da estrutura do seu 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

• 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 no servidor MCP do Firebase.
• Saiba mais sobre as ferramentas fornecidas pela CLI Firebase.