Servidor MCP do Firebase

Você pode usar o servidor MCP do Firebase para dar às ferramentas de desenvolvimento com tecnologia de IA a capacidade de trabalhar com seus projetos do Firebase e o codebase do app.

O servidor MCP do Firebase funciona com qualquer ferramenta que possa atuar como cliente MCP, incluindo: Firebase Studio, CLI do Gemini e Gemini Code Assist, Claude Code e Claude Desktop, Cline, Cursor, VS Code Copilot, Windsurf e muito mais!

arrow_downward Ir para as instruções de configuração

Benefícios do servidor MCP

Um editor configurado para usar o servidor MCP do Firebase pode utilizar os recursos de IA para ajudar a:

• Criar e gerenciar projetos do Firebase
• Gerenciar seus usuários do Firebase Authentication.
• Trabalhar com dados no Cloud Firestore e no Firebase Data Connect
• Recuperar esquemas do Firebase Data Connect
• Entender as regras de segurança do Firestore e do Cloud Storage para Firebase
• Enviar mensagens com o Firebase Cloud Messaging

Algumas das ferramentas usam o Gemini no Firebase para ajudar você a:

• Gerar esquema e operações do Firebase Data Connect
• Consultar o Gemini sobre produtos do Firebase

Estas são apenas listas parciais. Consulte a seção de recursos do servidor para obter uma lista completa das ferramentas disponíveis para o editor.

Configure seu cliente MCP

O servidor MCP do Firebase pode trabalhar com qualquer cliente MCP que ofereça suporte à E/S padrão (stdio) como meio de transporte.

Quando o servidor MCP do Firebase faz chamadas de função, ele usa as mesmas credenciais de usuário que autorizam a CLI do Firebase no ambiente em que ela está sendo executada. Pode ser um usuário conectado ou credenciais padrão do aplicativo, dependendo do ambiente.

Antes de começar

Verifique se você tem uma instalação funcional do Node.js e do npm.

Configuração básica

Confira as instruções básicas de configuração para usar o servidor MCP do Firebase com algumas ferramentas de assistência de IA conhecidas:

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

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

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

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

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

claude mcp add firebase npx -- -y firebase-tools@latest mcp

claude mcp list

firebase: npx -y firebase-tools@latest mcp - ✓ Connected

{
  "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"]
  }
}

Configuração opcional

Além da configuração básica de cada cliente, mostrada anteriormente, há dois parâmetros opcionais que você pode especificar:

• --dir ABSOLUTE_DIR_PATH: o caminho absoluto de um diretório que contém firebase.json, para definir um contexto de projeto para o servidor MCP. Se não for especificado, as ferramentas get_project_directory e set_project_directory ficarão disponíveis e o diretório padrão será o diretório de trabalho em que o servidor MCP foi iniciado.

• --only FEATURE_1,FEATURE_2: uma lista separada por vírgulas de grupos de recursos a serem ativados. Utilize para limitar as ferramentas expostas apenas aos recursos que você está usando ativamente. Observe que as ferramentas principais estão sempre disponíveis

Exemplo:

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

Recursos do servidor MCP

O servidor MCP do Firebase oferece três categorias diferentes de recursos de MCP:

• Comandos: uma biblioteca de comandos pré-gravados que podem ser executados e são otimizados para desenvolver e executar um app com o Firebase.

• Ferramentas: um conjunto de ferramentas destinadas ao uso por LLMs que ajudam a trabalhar diretamente com seu projeto do Firebase (com sua aprovação).

• Recursos: arquivos de documentação destinados ao uso por LLMs para dar mais orientação e contexto para concluir uma tarefa ou meta.

Comandos

O servidor MCP do Firebase vem com uma biblioteca de comandos pré-gravados otimizados para desenvolver e executar um app com o Firebase. É possível executar esses comandos para concluir várias tarefas ou metas comuns.

A tabela a seguir descreve os comandos disponibilizados pelo servidor MCP.

A maioria das ferramentas de desenvolvimento compatíveis com o MCP oferece uma maneira conveniente de executar esses comandos. Por exemplo, a CLI do Gemini disponibiliza esses comandos como comandos de barra:

/firebase:init

Na CLI do Gemini, comece a digitar /firebase: para conferir uma lista de comandos disponíveis.

Ferramentas

O servidor MCP do Firebase também oferece várias ferramentas destinadas ao uso por LLMs que ajudam a trabalhar diretamente com seu projeto do Firebase (com sua aprovação). Ao contrário dos comandos, você não chama essas ferramentas diretamente. Em vez disso, modelos que suportam a chamada de função (como Gemini, Claude e GPT) podem chamar essas ferramentas automaticamente para realizar tarefas de desenvolvimento quando necessário.

A tabela a seguir descreve as ferramentas disponibilizadas pelo servidor MCP.

Recursos

O servidor MCP fornece recursos, que são arquivos de documentação destinados ao uso por LLMs. Os modelos que oferecem suporte ao uso de recursos incluem automaticamente os recursos relevantes no contexto da sessão.

A tabela a seguir descreve os recursos disponibilizados pelo servidor MCP.