이 페이지는 Cloud Translation API를 통해 번역되었습니다.

MCP, Gemini CLI 및 기타 에이전트와 함께 Firestore 사용

이 페이지에서는 Firestore 데이터베이스를 다양한 개발자 도구에 연결하는 방법을 보여줍니다.

통합 환경을 위해서는 Gemini CLI 전용 Firestore 확장 프로그램을 사용하는 것이 좋습니다. Google Cloud의 차세대 명령줄 인터페이스인 Gemini CLI는 기본 MCP 서버를 확장 프로그램에 직접 번들로 묶어 별도의 서버 설정이 필요하지 않습니다. Gemini CLI를 사용하도록 Gemini Code Assist를 구성하여 IDE에서 유사한 설정 이점을 누릴 수 있습니다.

모델 컨텍스트 프로토콜 (MCP)을 지원하는 다른 개발자 도구의 경우 데이터베이스용 MCP 도구 상자를 수동으로 구성하여 연결할 수 있습니다. MCP Toolbox는 인증 및 연결 풀링과 같은 작업을 관리하여 AI 에이전트를 데이터에 연결하는 오픈소스 MCP 서버입니다. 이렇게 하면 IDE에서 직접 자연어를 사용하여 데이터와 상호작용할 수 있습니다. 이러한 도구의 경우 이 메서드는 핵심 데이터베이스 상호작용 기능을 제공합니다. 이 페이지에서는 데이터베이스용 MCP Toolbox를 사용하여 다음 IDE 환경에서 개발자 지원 도구를 Firestore 인스턴스에 연결하는 방법을 설명합니다.

Gemini CLI
Gemini Code Assist
Cursor
Windsurf(Codium)
Visual Studio Code(Copilot)
Cline(VS Code 확장 프로그램)
Claude desktop
Claude code

Gemini CLI 및 확장 프로그램 정보

Gemini CLI는 코딩, 디버깅, 데이터 탐색, 콘텐츠 제작을 지원하여 개발 워크플로를 지원하도록 설계된 오픈소스 AI 에이전트입니다. 이 도구의 목표는 Data Cloud 서비스 및 널리 사용되는 오픈소스 데이터베이스와 상호작용하기 위한 에이전트 인터페이스를 제공하는 것입니다.

확장 프로그램 작동 방식

Gemini CLI는 확장성이 뛰어나 확장 프로그램을 통해 새로운 도구와 기능을 추가할 수 있습니다. GitHub URL, 로컬 디렉터리 또는 구성 가능한 레지스트리에서 확장 프로그램을 로드할 수 있습니다. 워크플로를 지원하는 새로운 도구, 슬래시 명령어, 프롬프트를 제공합니다.

Firestore용 Gemini CLI 확장 프로그램 사용

Gemini CLI와의 통합은 표준 MCP Toolbox 연결에 비해 추가 기능을 제공하는 전용 확장 프로그램을 통해 이루어집니다. 이 확장 프로그램은 간소화된 설치 프로세스와 도구 모음을 제공합니다. 오픈소스 확장 프로그램에는 설치, 구성, 사용 예시에 관한 자세한 정보가 포함되어 있습니다. 자세한 내용은 Gemini CLI 확장 프로그램 - Firestore을 참고하세요.

firestore-native 확장 프로그램에는 데이터베이스를 쿼리하고, 문서를 업데이트하고, Firestore 보안 규칙을 관리하는 도구가 포함되어 있습니다.

카테고리	도구	자연어 프롬프트 예시
문서 및 데이터 검색	`get_documents`	users-staging 컬렉션의 테스트 사용자 qa_user_123 및 qa_user_456의 Firestore 데이터를 보여 줘.
	`list_collections`	users-staging 컬렉션의 모든 하위 컬렉션을 나열합니다.
	`query_collection`	위시리스트에 product-glasses가 포함된 users-staging 컬렉션의 모든 사용자를 찾습니다.
문서 업데이트 및 삭제	`add_documents`	필드 이름: tester1 및 위치: USA를 사용하여 users-staging 컬렉션에 문서 qa_user_789를 추가합니다.
	`delete_documents`	users-staging 컬렉션에서 문서 qa_user_789를 삭제합니다.
	`update_document`	주문 컬렉션에서 ID가 order-987인 문서를 업데이트하여 상태를 'Shipped'로 설정합니다. 방금 찾은 20명의 테스트 사용자의 위시리스트에서 product-glasses(비활성)를 삭제해 줘.
보안 규칙 관리	`get_rules`	이 데이터베이스의 활성 Firestore 보안 규칙을 보여 줘.
보안 규칙 관리	`validate_rules`	new_rules.txt는 스테이징을 위해 작업 중인 새 Firestore 보안 규칙입니다. 확인해 주시겠어요?

시작하기 전에

Firestore용 Gemini CLI 확장 프로그램의 도구를 사용하려면 다음 Identity and Access Management (IAM) 역할 중 하나 또는 이에 상응하는 권한이 있는 커스텀 역할이 있어야 합니다.

작업	역할 이름	필요한 Identity and Access Management (IAM) 역할
Firestore 데이터베이스에서 데이터 읽기 및 쓰기	Cloud Datastore 사용자	`roles/datastore.user`
보안 규칙 보기 및 테스트	Firebase 규칙 뷰어	`roles/firebaserules.viewer`

Firestore 설정

새 Google Cloud 프로젝트를 만들거나 기존 프로젝트를 선택합니다.
프로젝트에서 Firestore in Native Mode API를 사용 설정합니다.
아직 만들지 않았다면 Firestore 데이터베이스를 만듭니다.
로컬 환경의 인증을 설정합니다.
- gcloud CLI 설치
- gcloud auth application-default login를 실행하여 인증

MCP 클라이언트 구성

이 섹션에서는 데이터베이스용 MCP Toolbox를 사용하여 Firestore 인스턴스에 연결하도록 다양한 개발자 도구를 구성하는 방법을 설명합니다. 이 도구 상자는 IDE와 데이터베이스 사이에 위치하는 오픈소스 Model Context Protocol (MCP) 서버 역할을 하여 AI 도구를 위한 안전하고 효율적인 제어 영역을 제공합니다. 구성 안내를 보려면 다음 도구 중 하나의 탭을 선택하세요.

Gemini CLI

Gemini CLI를 설치합니다.
다음 명령어를 사용하여 GitHub 저장소에서 Gemini CLI용 Firestore 확장 프로그램을 설치합니다.
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Firestore 데이터베이스에 연결하도록 환경 변수를 설정합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
Firestore용 Gemini CLI 확장 프로그램은 인증에 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용합니다.
대화형 모드에서 Gemini CLI를 시작합니다.
```
gemini
```
CLI는 Gemini CLI 확장 프로그램 및 해당 도구용 Firestore 확장 프로그램을 자동으로 로드하며, 이를 사용하여 데이터베이스와 상호작용할 수 있습니다.

Gemini Code Assist

Gemini CLI를 사용하도록 Gemini Code Assist를 구성하는 것이 좋습니다. 이 방법을 사용하면 MCP 서버를 수동으로 구성할 필요가 없습니다.

Gemini CLI와 firestore-native 확장 프로그램이 설치되고 구성되어 있는지 확인합니다.
Gemini CLI를 사용하도록 Gemini Code Assist 구성
Gemini Code Assist 채팅 내에서 직접 자연어를 사용하여 Firestore 데이터베이스와 상호작용을 시작하세요.

Claude code

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

Claude Code를 설치합니다.
프로젝트 루트에 .mcp.json 파일이 없으면 만듭니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

새 구성을 적용하려면 Claude 코드를 다시 시작하세요.

Claude Desktop

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

Claude Desktop을 열고 설정으로 이동합니다.
개발자 탭에서 구성 수정을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Claude Desktop을 다시 시작합니다.
새 채팅 화면에 사용 가능한 새 MCP 서버와 함께 망치 (MCP) 아이콘이 표시됩니다.

Cline

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

VS Code에서 Cline 확장 프로그램을 열고 MCP Servers 아이콘을 탭합니다.
MCP 서버 구성을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

서버가 성공적으로 연결되면 녹색 활성 상태가 표시됩니다.

커서

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

프로젝트 루트에 .cursor 디렉터리가 없으면 만듭니다.
.cursor/mcp.json 파일이 없으면 만들고 엽니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

커서를 열고 설정 > 커서 설정 > MCP로 이동합니다. 서버가 연결되면 녹색 활성 상태가 표시됩니다.

Visual Studio Code(Copilot)

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

VS Code를 열고 프로젝트 루트에 .vscode 디렉터리가 없으면 만듭니다.
.vscode/mcp.json 파일이 없으면 만들고 엽니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

데이터베이스용 MCP 도구 상자 설치

Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. Toolbox 버전 V0.15.0 이상을 사용해야 합니다.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version을 Toolbox 버전 번호(예: v0.15.0)로 바꿉니다.
바이너리를 실행 가능하게 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 서버에 연결

Windsurf를 열고 Cascade 어시스턴트로 이동합니다.
MCP 아이콘을 클릭한 다음 구성을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 환경 변수를 값으로 바꾼 후 저장합니다. FIRESTORE_DATABASE 변수는 선택사항이며 기본값은 (default)입니다.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

MCP, Gemini CLI 및 기타 에이전트와 함께 Firestore 사용

Gemini CLI 및 확장 프로그램 정보

확장 프로그램 작동 방식

Firestore용 Gemini CLI 확장 프로그램 사용

시작하기 전에

Firestore 설정

MCP 클라이언트 구성

Gemini CLI

Gemini Code Assist

Claude code

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결

Claude Desktop

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결

Cline

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결

커서

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결

Visual Studio Code(Copilot)

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결

Windsurf

데이터베이스용 MCP 도구 상자 설치

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP 서버에 연결