Firebase Studio에서 작업을 시작하는 데 Firebase 프로젝트가 필요하지는 않지만 Firebase 제품을 사용하려면 연결해야 합니다. 개발 프로세스의 특정 시점에서 Firebase Studio가 프로젝트를 자동으로 만들거나 수동으로 연결할 수 있습니다. 이 가이드에서는 Firebase 프로젝트의 목적과 Firebase Studio에서 작업공간에 연결하는 방법을 설명합니다.
Firebase 프로젝트 이해
Firebase 프로젝트는 사용자 인증, 데이터 저장소, 호스팅, 분석 등 앱의 모든 백엔드 서비스를 위한 컨테이너라고 생각하면 됩니다. Firebase Studio 작업공간을 Firebase 프로젝트에 연결하면 Firebase 제품 모음을 앱에 통합할 수 있습니다.
Firebase 프로젝트에는 하나 이상의 Firebase 앱을 등록할 수 있습니다 (예: 앱의 무료 버전과 유료 버전 모두). 하지만 다음 사항에 유의하세요.
동일한 Firebase 프로젝트에 등록된 모든 Firebase 앱은 해당 프로젝트에 프로비저닝된 모든 동일한 리소스와 서비스를 공유하고 여기에 액세스할 수 있습니다.
여러 Firebase Studio 작업공간을 별도의 Firebase 프로젝트에 연결하는 것이 좋습니다. 이렇게 하면 여러 작업공간에서 동일한 백엔드 데이터와 리소스를 공유 (및 잠재적으로 덮어쓰기)하는 것을 방지할 수 있습니다.
워크스페이스를 Firebase 프로젝트에 연결한 후 Firebase Console에서 관리 및 구성 작업을 수행합니다. 여기에는 보안 규칙 보기, 사용자 계정 관리, 자세한 비정상 종료 보고서 보기, 저장된 데이터 직접 수정, A/B 테스트 결과 검토가 포함됩니다.
Firebase Studio 앱을 Firebase 프로젝트에 연결
앱에서 Firebase 서비스를 사용하려면 앱을 Firebase 프로젝트에 연결해야 합니다. 예를 들어 Firebase Authentication를 사용하려면 사용자 계정을 만들고 관리할 수 있도록 Firebase 프로젝트에 연결해야 합니다. 개발 과정의 특정 시점에 Firebase Studio에서 Firebase 프로젝트를 만들거나 직접 만들 수 있습니다.
Firebase 프로젝트에 자동 연결
App Prototyping agent를 사용하는 경우 다음과 같은 경우 Firebase Studio가 사용자를 대신하여 Firebase 프로젝트를 프로비저닝합니다.
Gemini API 키 자동 생성
앱을 Firebase 프로젝트에 연결하도록 요청
Cloud Firestore 또는 Firebase Authentication과 같은 Firebase 서비스에 앱을 연결하는 데 도움 요청
게시 버튼을 클릭하고 Firebase App Hosting을 설정합니다.
대화형 채팅 또는 Gemini CLI를 사용할 때 다음과 같은 경우 Gemini는 터미널 명령어 또는 Firebase MCP 서버를 사용하여 Firebase 프로젝트에 연결할 수 있습니다.
앱을 Firebase 프로젝트에 연결하도록 요청
Cloud Firestore 또는 Firebase Authentication과 같은 Firebase 서비스에 앱을 연결하는 데 도움 요청
Firebase 프로젝트에 수동으로 연결
Firebase Studio 앱을 Firebase 프로젝트에 수동으로 연결하려면 다음 단계를 따르세요.
새 프로젝트 만들기: 새 Firebase 프로젝트 만들기를 클릭하고 안내에 따라 새 프로젝트를 만듭니다.
기존 프로젝트 열기: 사용할 프로젝트를 클릭합니다.
프로젝트 ID를 기록합니다. Firebase Console에서 settings > 프로젝트 설정을 클릭합니다. 상단 창에 프로젝트 ID가 표시됩니다.
Firebase Studio에서 앱을 엽니다.Prototyper view, click
Switch to Code to open Code view.에서 App Prototyping agent를 사용하는 경우
Firebase 프로젝트를 연결합니다. 터미널 (Shift+Ctrl+C)에서 다음 명령어를 실행합니다.
touch firebase.json
이렇게 하면 디렉터리에 Firebase 구성 파일이 있는지 확인할 수 있습니다.
firebase login --reauth
메시지에 따라 계정을 승인합니다.
firebase use <your project ID><your-project-ID>을 앞에서 기록한 프로젝트 ID로 바꿉니다.
앱에 연결된 Firebase 프로젝트 변경
Firebase Studio 작업공간과 연결된 Firebase 프로젝트를 변경하려면 새 프로젝트 ID를 사용하여 Firebase 프로젝트에 수동으로 연결의 안내를 따르세요.
앱에 연결된 Firebase 프로젝트 확인
Firebase 프로젝트가 이미 연결되어 있는지 확인하려면 Firebase Studio 작업공간 상단을 확인하세요. 연결된 프로젝트 ID가 있는 경우 작업공간 이름 옆에 표시됩니다. 프로젝트 ID를 클릭하여 Firebase Console에서 해당 프로젝트를 바로 열 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-09(UTC)"],[],[],null,["While you don't need a Firebase project to start working in Firebase Studio,\nconnecting one is essential for using Firebase products. At certain points in\nyour development process, Firebase Studio might automatically create a\nproject for you, or you can choose to connect one manually. This guide explains\nthe purpose a Firebase project serves and how to connect one to your\nworkspace in Firebase Studio.\n\nUnderstand Firebase projects\n\nThink of a Firebase project as a container for all of your app's backend\nservices, including user authentication, data storage, hosting, analytics, and\nmore. By connecting your Firebase Studio workspace to a Firebase project,\nyou can integrate a\n[suite of Firebase products](https://firebase.google.com/products) into your\napp.\n\nA Firebase project can have one or more Firebase Apps registered to it (for\nexample, both the free and paid versions of an app), but keep in mind the\nfollowing:\n\n- All Firebase Apps registered to the same Firebase project share and have access to all the same resources and services provisioned for that project.\n- If Firebase Studio [automatically creates a Firebase project for you](#connect-auto), it creates a new project and links it to your Firebase Studio workspace.\n- If you [duplicate a Firebase Studio workspace](/docs/studio/get-started-workspace#duplicate-workspace) that's linked to a Firebase project, the duplicated workspace is linked to the same project.\n\nConsider connecting different Firebase Studio workspaces to separate\nFirebase projects. This prevents multiple workspaces from sharing (and\npotentially overwriting) the same backend data and resources.\n\nAfter connecting your workspace to a Firebase project, visit the\n[Firebase console](https://console.firebase.google.com/) for\nadministrative and configuration tasks. This includes viewing security rules,\nmanaging user accounts, viewing detailed crash reports, editing stored data\ndirectly, and reviewing A/B test results.\n\nConnect a Firebase Studio app to a Firebase project\n\nIn order to use Firebase services in your app, you'll need to connect your app\nto a Firebase project. For example, if you want to use Firebase Authentication, you'll\nneed to connect to a Firebase project so that you can\ncreate and manage user accounts. At certain points during the development\nprocess, Firebase Studio creates a Firebase project for you, or you can\nchoose to do so manually.\n\nAutomatically connect to a Firebase project\n\nWhen using the App Prototyping agent, Firebase Studio provisions a\nFirebase project on your behalf when you:\n\n- Auto-generate a Gemini API key\n- Ask to connect your app to a Firebase project\n- Ask for help connecting your app to Firebase services, such as Cloud Firestore or Firebase Authentication\n- Click the **Publish** button and set up Firebase App Hosting\n\nWhen using interactive chat or Gemini CLI,\nGemini can use terminal commands or the\n[Firebase MCP server](/docs/cli/mcp-server) to connect to a Firebase project\nwhen you:\n\n- Ask to connect your app to a Firebase project\n- Ask for help connecting your app to Firebase services, such as Cloud Firestore or Firebase Authentication\n\nManually connect to a Firebase project\n\nTo manually connect your Firebase Studio app to a Firebase project:\n\n1. In the [Firebase console](https://console.firebase.google.com/)\n create a new project or open an existing project:\n\n - **Create a new project** : Click **Create a new Firebase project** and follow the instructions to create a new project.\n - **Open an existing project**: Click the project you want to use.\n2. **Note your project ID.** In the Firebase console, click\n settings \\\u003e [**Project\n settings**](//console.firebase.google.com/project/_/settings/general/). The\n project ID is displayed in the top pane.\n\n3. **Open your app in Firebase Studio.** If you're using\n the App Prototyping agent in Prototyper view, click **Switch to Code** to open Code view.\n\n4. **Connect your Firebase project.** In the terminal (`Shift+Ctrl+C`), run the\n following commands:\n\n 1. `touch firebase.json` This ensures a Firebase configuration file exists in your directory.\n 2. `firebase login --reauth` Follow the prompts to authorize your account.\n 3. `firebase use \u003cyour project ID\u003e` Replace `\u003cyour-project-ID\u003e` with the project ID you noted earlier.\n\nChange the Firebase project connected to your app\n\nTo change the Firebase project associated with your Firebase Studio\nworkspace, follow the instructions in\n[Manually connect to a Firebase project](#connect-manual) using the new project\nID.\n| **Important:** Any Firebase services you set up for the original project won't transfer over. You must set them up again in the new project.\n\nIdentify the Firebase project connected to your app\n\nTo confirm if a Firebase project is already connected, check the top of your\nFirebase Studio workspace. The connected project ID, if one exists, is shown\nnext to the name of your workspace. You can click the project ID to open that\nproject directly in the Firebase console.\n\nNext steps\n\n- [Understand Firebase projects](/docs/projects/learn-more)\n- [Integrate with Google and Firebase services](/docs/studio/google-integrations)\n- [Monitor and protect web apps](/docs/studio/monitor)"]]
Switch to Code to open Code view.에서 App Prototyping agent를 사용하는 경우