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 em conjunto 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, Authentication e Firebase Hosting para um app da Web. Em breve, vamos disponibilizar informações sobre apps iOS, Android e Flutter.

Por que usar habilidades e ferramentas do agente do Firebase?

Os modelos gerais de IA 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 conhecimento do domínio. Elas oferecem 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 oferece contexto e acesso ao agente de programação. Ele estabelece um protocolo padrão para que o agente inspecione programaticamente os recursos ativos do projeto, os arquivos locais e as configurações.
• Firebase CLI: a interface de linha de comando oferece ao agente de programação poder acionável. É a ferramenta de execução que o agente usa para realizar tarefas pesadas, como inicializar bancos de dados, gerenciar configurações de autenticação do usuário e implantar código em seu nome.

O uso de 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 Authentication usuários, implantar novas Firebase Security Rules, e trabalhar diretamente com seus Cloud Firestore dados.
• Manter-se atualizado: use comandos oficiais e com reconhecimento de versão para orientar seu agente nas tarefas de configuração.
• Melhorar a acurácia: 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 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 assistidos pelas habilidades e ferramentas do agente?

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.
• 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 habilidades do agente do Firebase

Na maioria dos casos, é possível instalar 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 MCP do Firebase

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

"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 ao agente para configurar um serviço. Por exemplo, você pode usar comandos como estes:

   • Configure 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 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 seu código local a um projeto do Firebase existente 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 seu projeto, comandos de linguagem natural claros e específicos produzem 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 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 v9 do Firebase."
• Peça 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).

• 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 ao ar.

Use a conexão MCP

Como o servidor MCP do Firebase oferece ao agente visibilidade direta da 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.