このページは Cloud Translation API によって翻訳されました。

MCP、Gemini CLI、その他のエージェントで Firestore を使用する

このページでは、Firestore データベースをさまざまなデベロッパーツールに接続する方法について説明します。

統合されたエクスペリエンスを実現するには、Gemini CLI 専用の Firestore 拡張機能を使用することをおすすめします。Google Cloud の次世代コマンドラインインターフェースである Gemini CLI は、基盤となる MCP サーバーを拡張機能に直接バンドルするため、個別のサーバー設定は不要です。Gemini CLI を使用するように Gemini Code Assist を構成すると、IDE で同様のセットアップのメリットが得られます。

Model Context Protocol（MCP）をサポートする他のデベロッパーツールについては、データベース向け MCP ツールボックスを手動で構成して接続できます。MCP ツールボックスは、認証や接続プーリングなどのタスクを管理して AI エージェントをデータに接続するオープンソースの MCP サーバーです。これにより、IDE から直接自然言語を使用してデータを操作できます。これらのツールでは、このメソッドはコアデータベース操作機能を提供します。このページでは、データベース向け MCP ツールボックスと次の 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`	users-staging コレクションで、商品 glasses がウィッシュリストに含まれているすべてのユーザーを検索します。
ドキュメントの更新と削除	`add_documents`	フィールド名: tester1 と場所: USA を含むドキュメント qa_user_789 を users-staging コレクションに追加します。
	`delete_documents`	users-staging コレクションからドキュメント qa_user_789 を削除します。
	`update_document`	orders コレクション内の 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 Rules 閲覧者	`roles/firebaserules.viewer`

Firestore を設定する

Google Cloud プロジェクトを新規作成するか、既存のプロジェクトを選択する。
プロジェクトで Firestore in Native Mode API を有効にします。
まだ作成していない場合は、Firestore データベースを作成します。
ローカル環境の認証を設定します。
- gcloud CLI をインストールする
- gcloud auth application-default login を実行して認証する

MCP クライアントを構成する

このセクションでは、データベース向け MCP ツールボックスを使用して 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 for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（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 for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```

MCP サーバーに接続する

Claude Desktop を開き、[Settings] に移動します。
[Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
次の構成を追加し、環境変数を実際の値に置き換えて保存します。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 for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```

MCP サーバーに接続する

VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをタップします。
[Configure MCP Servers] をクリックして構成ファイルを開きます。
次の構成を追加し、環境変数を実際の値に置き換えて保存します。FIRESTORE_DATABASE 変数は省略可能で、デフォルトは (default) です。

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

サーバーが正常に接続されると、緑色のアクティブステータスが表示されます。

Cursor

MCP Toolbox for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（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"
        }
      }
    }
  }

Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブステータスが表示されます。

Visual Studio Code（Copilot）

MCP Toolbox for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（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 for Databases をインストールする

ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティングシステム（OS）と CPU アーキテクチャに対応するバイナリを選択します。ツールボックスバージョン V0.15.0 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
version は、ツールボックスのバージョン番号（v0.15.0 など）に置き換えます。
バイナリを実行可能にします。
```
chmod +x toolbox
```
インストールを確認します。
```
./toolbox --version
```

MCP サーバーに接続する

Windsurf を開き、Cascade アシスタントに移動します。
MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
次の構成を追加し、環境変数を実際の値に置き換えて保存します。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 Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する

Claude Desktop

MCP Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する

Cline

MCP Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する

Cursor

MCP Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する

Visual Studio Code（Copilot）

MCP Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する

Windsurf

MCP Toolbox for Databases をインストールする

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

MCP サーバーに接続する