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 em conjunto 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 Cloud Firestore, 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 modelos de IA gerais costumam ter dificuldades com configurações específicas de projetos ou informações desatualizadas. Este kit de ferramentas resolve esse problema:

• Habilidades do agente do Firebase: as habilidades fornecem ao agente de programação experiência no domínio. Eles fornecem documentação atualizada e fluxos de trabalho ideais para que o agente saiba a maneira correta e recomendada pelo Firebase de estruturar sua arquitetura.
• Servidor MCP do Firebase: o servidor MCP dá ao agente de programação contexto e acesso. Ele estabelece um protocolo padrão para que o agente inspecione programaticamente os recursos ativos do projeto, os arquivos locais e as configurações.
• CLI Firebase: a interface de linha de comando dá ao agente de programação poder de ação. É a ferramenta de execução que o agente usa para realizar tarefas pesadas, como inicializar bancos de dados, gerenciar configurações de autenticação de usuários e implantar código em seu nome.

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 recursos:

• Entre em ação: faça mais do que apenas escrever código. Seu agente pode inicializar serviços, gerenciar usuários do 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.

Quais serviços do Firebase podem ser usados com as habilidades e ferramentas do agente?

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.
• 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, 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:

npx skills add firebase/agent-skills --agent=antigravity

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

npx skills add firebase/agent-skills --agent=codex

npx skills add firebase/agent-skills --agent=cursor

npx skills add firebase/agent-skills

Etapa 2: conectar-se ao servidor do MCP do Firebase

Embora muitas habilidades do agente do Firebase usem a CLI Firebase para tarefas, é 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 aparecer 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
    }
  }
}

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

"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, 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 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: seu agente cria e atualiza todos os arquivos necessários, como firestore.rules (para definir quem pode ler, gravar ou consultar dados no seu banco de dados) ou firebase.json (para informar à CLI Firebase quais serviços implantar e como configurá-los).
   5. Executa: o agente orienta você nas etapas de configuração ou implantação adicionais.

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, 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 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. Analise meu firestore.rules e sugira uma correção que permita aos usuários autenticados gravar 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 ao agente para ajudar você a testar mudanças localmente antes de colocá-las em produção.

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.