Firebase MCP サーバーを使用すると、AI を活用した開発ツールで Firebase プロジェクトを操作できるようになります。Firebase MCP サーバーは、Claude Desktop、Cline、Cursor、Visual Studio Code Copilot、Windsurf Editor を含め、MCP クライアントとして機能できる任意のツールと連携できます。
Firebase MCP サーバーを使用するように構成されたエディタでは、AI 機能を使って次のことができます。
- Firebase プロジェクトを作成、管理する
- Firebase Authentication ユーザーを管理する
- Cloud Firestore と Firebase Data Connect でデータを操作する
- Firebase Data Connect スキーマを取得する
- Firestore と Cloud Storage for Firebase のセキュリティ ルールを理解する
- Firebase Cloud Messaging を使用してメッセージを送信する
これは一例にすぎません。エディタで利用可能なツールの一覧については、サーバー機能セクションをご覧ください。
始める前に
Node.js と npm が正常にインストールされていることを確認します。
次のコマンドを実行して 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 > 設定] メニューから開くか作成できます。[開発者] タブを選択し、[構成を編集] をクリックします。
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "experimental:mcp"]
}
}
}
Cline
Firebase MCP サーバーを使用するように Cline を構成するには、cline_mcp_settings.json
ファイルを編集します。Cline ペインの上部にある MCP サーバー アイコンをクリックし、[MCP サーバーを構成] ボタンをクリックして、このファイルを開くか作成します。
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "experimental:mcp"],
"disabled": false
}
}
}
Cursor
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"]
}
}
オプションの構成
前述の各クライアントの基本構成に加えて、指定できるオプション パラメータが 2 つあります。
--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 サーバー機能
ツール名 | 特徴グループ | 説明 |
---|---|---|
firebase_get_project | core | 現在アクティブな Firebase プロジェクトに関する情報を取得します。 |
firebase_list_apps | core | 現在の Firebase プロジェクトに登録されているアプリを取得します。 |
firebase_get_admin_sdk_config | core | 現在のプロジェクトの Admin SDK 構成を取得します。 |
firebase_get_sdk_config | core | 指定したプラットフォームの Firebase SDK 構成情報を取得します。プラットフォームまたは app_id のいずれかを指定する必要があります。 |
firebase_create_project | core | 新しい Firebase プロジェクトを作成します。 |
firebase_create_app | core | Firebase プロジェクトにウェブ、iOS、Android 用の新しいアプリを作成します。 |
firebase_create_android_sha | core | ��存の Android アプリに SHA 証明書ハッシュを追加します。 |
firebase_get_environment | core | 現在の認証済みユーザー、プロジェクト ディレクトリ、アクティブなプロジェクトなど、現在の Firebase 環境に関する情報を取得します。 |
firebase_update_environment | core | プロジェクト ディレクトリ、アクティブなプロジェクト、アクティブなユーザー アカウントなど、Firebase 環境の構成を更新します。firebase_get_environment を使用して、現在構成されている環境を確認します。 |
firebase_init | core | ワークスペースで選択した Firebase 機能を初期化します。すべての機能は省略可能です。設定するプロダクトのみを指定してください。新しい機能を既存のプロジェクト ディレクトリに初期化できますが、既存の機能を再初期化すると、構成が上書きされる可能性があります。 |
firestore_delete_document | firestore | ドキュメントの完全パスで、現在のプロジェクトのデータベースから Firestore ドキュメントを削除します。ドキュメントの正確なパスがわかっている場合に使用します。 |
firestore_get_documents | firestore | ドキュメントの完全パスで、現在のプロジェクトのデータベースから 1 つ以上の Firestore ドキュメントを取得します。ドキュメントの正確なパスがわかっている場合に使用します。 |
firestore_list_collections | firestore | 現在のプロジェクトの Firestore データベースからコレクションのリストを取得します。 |
firestore_query_collection | firestore | ドキュメントの完全パスを持つコレクションで、現在のプロジェクトのデータベース内のコレクションから 1 つ以上の Firestore ドキュメントを取得します。コレクションの正確なパスと、ドキュメントに適用するフィルタリング句がわかっている場合に使用します。 |
firestore_get_rules | firestore | 現在のプロジェクトのアクティブな Firestore セキュリティ ルールを取得します。 |
firestore_validate_rules | firestore | 指定された Firestore Rules ソースに構文エラーや検証エラーがないか確認します。検証するソースコードか、ソースファイルのパスの「いずれか」を指定します。 |
auth_get_user | auth | メールアドレス、電話番号、UID に基づいてユーザーを取得します。 |
auth_disable_user | auth | UID に基づいてユーザーを無効または有効にします。 |
auth_list_users | auth | 指定された上限まで、プロジェクト内のすべてのユーザーを取得します。 |
auth_set_claim | auth | 特定のユーザーのアカウントにカスタム クレームを設定します。ユーザーに関連付けられた信頼できる値を作成するために使用します(管理者としてマークするなど)。クレームのサイズには上限があり、名前と値は簡潔にする必要があります。value パラメータまたは json_value パラメータのいずれか「1 つのみ」を指定します。 |
auth_set_sms_region_policy | auth | Firebase Auth の SMS リージョン ポリシーを設定して、国コードの許可リストまたは拒否リストに基づいてテキスト メッセージを受信できるリージョンを制限します。このポリシーを設定すると、既存のポリシーがオーバーライドされます。 |
dataconnect_list_services | dataconnect | 現在のプロジェクトで使用可能な Firebase Data Connect サービスを列挙します。 |
dataconnect_get_schema | dataconnect | プロジェクト内の Firebase Data Connect スキーマに関する情報(Cloud SQL データソースや、データモデルを記述する GraphQL スキーマなど)を取得します。 |
dataconnect_get_connectors | dataconnect | プロジェクト内の Firebase Data Connect コネクタを取得します。これには、ク��イアント SDK がアクセスできる事前定義された GraphQL クエリが含まれています。 |
dataconnect_execute_graphql | dataconnect | Data Connect サービスまたはそのエミュレータに対して任意の GraphQL を実行します。 |
dataconnect_execute_graphql_read | dataconnect | Data Connect サービスまたはそのエミュレータに対して任意の GraphQL クエリを実行します。データは書き込めません。 |
dataconnect_execute_mutation | dataconnect | サービスまたはそのエミュレータに対して、デプロイされた Data Connect ミューテーションを実行します。データの読み取りと書き込みが可能です。 |
dataconnect_execute_query | dataconnect | サービスまたはそのエミュレータに対して、デプロイされた Data Connect クエリを実行します。データは書き込めません。 |
storage_get_rules | storage | 現在のプロジェクトのアクティブな Storage セキュリティ ルールを取得します。 |
storage_validate_rules | storage | 指定された Storage Rules ソースに構文エラーや検証エラーがないか確認します。検証するソースコードか、ソースファイルのパスの「いずれか」を指定します。 |
storage_get_object_download_url | storage | Firebase Storage 内のオブジェクトのダウンロー�� URL ��取得します。 |
messaging_send_message | messaging | Firebase Cloud Messaging 登録トークンまたはトピックにメッセージを送信します。特定の 1 回の呼び出しで指定できるのは、registration_token または topic のいずれか 1 つだけです。 |
remoteconfig_get_template | remoteconfig | プロジェクトの Remote Config テンプレートを取得します。 |
remoteconfig_publish_template | remoteconfig | プロジェクトの新しい Remote Config テンプレートを公開します。 |
remoteconfig_rollback_template | remoteconfig | プロジェクトの特定のバージョンの Remote Config テンプレートにロールバックします。 |
crashlytics_list_top_issues | crashlytics | アプリケーションで発生した Crashlytics の上位のクラッシュを列挙します。 |