Firebase MCP 서버

bookmark_border 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Firebase MCP 서버를 사용하여 AI 기반 개발 도구를 Firebase 프로젝트에서 사용할 수 있습니다. Firebase MCP 서버는 Claude Desktop, Cline, Cursor, Visual Studio Code Copilot, Windsurf Editor 등 MCP 클라이언트 역할을 할 수 있는 모든 도구와 호환됩니다.

Firebase MCP 서버를 사용하도록 구성된 편집기는 AI 기능을 사용하여 다음 작업을 할 수 있습니다.

• Firebase 프로젝트 만들기 및 관리
• Firebase 인증 사용자 관리
• Cloud Firestore 및 Firebase Data Connect에서 데이터 작업
• Firebase Data Connect 스키마 검색
• Firestore 및 Firebase용 Cloud Storage의 보안 규칙 이해
• Firebase 클라우드 메시징으로 메시지 보내기

이는 일부 목록일 뿐입니다. 편집기에서 사용할 수 있는 도구의 전체 목록은 서버 기능 섹션을 참고하세요.

시작하기 전에

1. Node.js 및 npm이 설치되어 있고 작동하는지 확인합니다.

2. 다음 명령어를 실행하여 Firebase CLI를 인증합니다.

   npx -y firebase-tools@latest login --reauth

   Firebase MCP 서버는 CLI를 사용하여 Firebase 프로젝트의 인증을 처리합니다. MCP 서버를 사용하기 전에 CLI로 인증해야 합니다. 로그인하지 않고 서버를 사용하려고 하거나 인증 토큰이 만료된 경우 서버에 재인증하라는 오류 메시지가 표시됩니다.

MCP 클라이언트 설정

Firebase MCP 서버는 전송 매체로 표준 I/O(stdio)를 지원하는 모든 MCP 클라이언트와 함께 작동할 수 있습니다. 다음은 몇 가지 인기 도구에 관한 구체적인 안내입니다.

기본 구성

Claude Desktop

Firebase MCP 서버를 사용하도록 Claude Desktop을 구성하려면 claude_desktop_config.json 파일을 수정합니다. Claude > Settings(설정) 메뉴에서 이 파일을 열거나 만들 수 있습니다. Developer(개발자) 탭을 선택한 다음 Edit Config(구성 수정)을 클릭합니다.

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

Cline

Firebase MCP 서버를 사용하도록 Cline을 구성하려면 cline_mcp_settings.json 파일을 수정합니다. 이 파일은 Cline 창 상단의 MCP Servers 아이콘을 클릭한 다음 Configure MCP Servers(MCP 서버 구성) 버튼을 클릭하여 열거나 만들 수 있습니다.

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

커서

Firebase MCP 서버를 사용하도록 Cursor를 구성하려면 .cursor/mcp.json 파일(특정 프로젝트만 구성) 또는 ~/.cursor/mcp.json 파일(모든 프로젝트에서 MCP 서버를 사용 설정)을 수정합니다.

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

Visual Studio Code Copilot

단일 프로젝트를 구성하려면 작업공간에서 .vscode/mcp.json 파일을 수정합니다.

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
  }
}

여는 모든 프로젝트에서 서버를 사용할 수 있도록 하려면 사용자 설정을 수정합니다.

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
    }
  }
}

Windsurf Editor

Windsurf Editor를 구성하려면 ~/.codeium/windsurf/mcp_config.json 파일을 수정합니다.

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

선택적 구성

앞에서 설명한 각 클라이언트의 기본 구성 외에도 지정할 수 있는 두 가지 선택적 파라미터가 있습니다.

• --dir ABSOLUTE_DIR_PATH: MCP 서버의 프로젝트 컨텍스트를 설정하기 위해 firebase.json이 포함된 디렉터리의 절대 경로입니다. 지정하지 않으면 get_project_directory 및 set_project_directory 도구를 사용할 수 있게 되며 기본 디렉터리는 MCP 서버가 시작된 작업 디렉터리입니다.

• --only FEATURE_1,FEATURE_2: 활성화할 특성 그룹의 쉼표로 구분된 목록입니다. 이를 사용하여 활발하게 사용 중인 특성에만 노출되는 도구를 제한합니다. 핵심 도구는 항상 사용할 수 있습니다.

예를 들면 다음과 같습니다.

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

MCP 서버 기능