Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

שימוש ב-Firestore עם MCP,‏ Gemini CLI וסוכנים אחרים

בדף הזה מוסבר איך לחבר את מסד הנתונים של Firestore לכלי פיתוח שונים.

כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף הייעודי של Firestore ל-Gemini CLI.‏ Gemini CLI הוא ממשק שורת הפקודה (CLI) מהדור הבא של Google Cloud, והוא כולל את שרת ה-MCP הבסיסי ישירות בתוסף, כך שלא צריך להגדיר שרת נפרד. אפשר להגדיר את Gemini Code Assist לשימוש ב-Gemini CLI, וליהנות מיתרונות דומים בהגדרה בסביבת הפיתוח המשולבת (IDE).

כדי לחבר כלי פיתוח אחרים שתומכים ב-Model Context Protocol‏ (MCP), צריך להגדיר ידנית את MCP Toolbox for Databases. ‫MCP Toolbox הוא שרת MCP בקוד פתוח שמחבר סוכני AI לנתונים שלכם באמצעות ניהול משימות כמו אימות ואיגום חיבורים. כך תוכלו לקיים אינטראקציה עם הנתונים שלכם באמצעות שפה טבעית ישירות מ-IDE. השיטה הזו מספקת יכולות בסיסיות של אינטראקציה עם מסד הנתונים. בדף הזה מוסבר איך להשתמש ב-MCP Toolbox for Databases כדי לחשוף את הכלים לסיוע למפתחים למופע של Firestore באמצעות סביבות הפיתוח המשולבות (IDE) הבאות:

Gemini CLI
Gemini Code Assist
Cursor
‫Windsurf (Codium)
קוד Visual Studio (Copilot)
‫Cline (תוסף ל-VS Code)
Claude למחשב
Claude code

מידע על Gemini CLI ותוספים

‫Gemini CLI הוא סוכן AI בקוד פתוח שנועד לעזור בתהליכי פיתוח, למשל בכתיבת קוד, באיתור באגים, בחיפוש נתונים וביצירת תוכן. המטרה שלו היא לספק ממשק סוכני לביצוע אינטראקציה עם שירותי Data Cloud ומסדי נתונים פופולריים בקוד פתוח.

איך תוספים פועלים

‫Gemini CLI הוא כלי שניתן להרחבה בקלות, ומאפשר להוסיף כלים ויכולות חדשים באמצעות תוספים. אפשר לטעון את התוספים מכתובת URL ב-GitHub, מספרייה מקומית או ממאגר תוספים שניתן להגדרה. התוספים מספקים כלים חדשים, פקודות עם לוכסן (/) והנחיות שיעזרו לכם בתהליך העבודה.

שימוש בתוסף ל-Gemini CLI עבור Firestore

השילוב עם Gemini CLI מתבצע באמצעות תוסף ל-Gemini CLI שמציע יכולות נוספות בהשוואה לחיבור הרגיל של MCP Toolbox. התוסף מציע תהליך התקנה יעיל וערכת כלים. התוסף בקוד פתוח מכיל מידע מפורט על התקנה, הגדרה ודוגמאות לשימוש. למידע נוסף, אפשר לעיין במאמר Gemini CLI Extension - Firestore.

התוסף firestore-native כולל כלים לשליחת שאילתות למסד הנתונים, לעדכון מסמכים ולניהול כללי האבטחה של Firestore.

קטגוריה	כלים	דוגמה להנחיה בשפה טבעית
שליפת מסמכים ונתונים	`get_documents`	תציג לי את נתוני Firestore של משתמשי הבדיקה qa_user_123 ו-qa_user_456 מהאוסף users-staging.
	`list_collections`	הצגת רשימה של כל אוספי המשנה באוסף users-staging.
	`query_collection`	מציאת כל המשתמשים באוסף users-staging שברשימת המשאלות שלהם מופיע המוצר product-glasses.
עדכונים ומחיקות של מסמכים	`add_documents`	מוסיפים את המסמך qa_user_789 לאוסף users-staging עם השדות name: tester1 ו-location: USA.
	`delete_documents`	מחיקת המסמך qa_user_789 מהאוסף users-staging.
	`update_document`	מעדכנים את המסמך עם מזהה ההזמנה order-987 באוסף ההזמנות כדי להגדיר את הסטטוס ל-Shipped (נשלח). עליך להסיר את המוצר glasses(inactive) מרשימת המשאלות של כל 20 משתמשי הבדיקה שמצאת.
ניהול כללי אבטחה	`get_rules`	תציג לי את כללי האבטחה הפעילים של Firestore במסד הנתונים הזה.
ניהול כללי אבטחה	`validate_rules`	‫new_rules.txt הוא כלל אבטחה חדש של Firestore שאני עובד עליו בשלב ההכנה. תוכל לאמת אותו בשבילי?

לפני שמתחילים

כדי להשתמש בכלים בתוסף Gemini CLI ל-Firestore, אתם צריכים להיות בעלי אחד מהתפקידים הבאים בניהול הזהויות והרשאות הגישה (IAM), או תפקיד בהתאמה אישית עם הרשאות שוות ערך:

משימה	שם התפקיד	התפקיד שנדרש בניהול זהויות והרשאות גישה (IAM)
קריאה וכתיבה של נתונים במסד נתונים ב-Firestore	משתמש Cloud Datastore	`roles/datastore.user`
צפייה בכללי אבטחה ובדיקה שלהם	Firebase Rules Viewer	`roles/firebaserules.viewer`

הגדרת Firestore

יוצרים פרויקט חדש Google Cloud או בוחרים פרויקט קיים.
מפעילים את Firestore במצב Native API בפרויקט.
אם עדיין לא עשיתם זאת, צרו מסד נתונים של Firestore.
מגדירים אימות לסביבה המקומית.
- התקנת ה-CLI של gcloud
- מריצים את הפקודה gcloud auth application-default login כדי לבצע אימות

הגדרת לקוח ה-MCP

בקטע הזה מוסבר איך להגדיר כלים שונים למפתחים כדי להתחבר למופע של Firestore באמצעות MCP Toolbox for Databases. ערכת הכלים פועלת כשרת Model Context Protocol‏ (MCP) בקוד פתוח, שממוקם בין סביבת הפיתוח המשולבת (IDE) לבין מסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלים שלכם מבוססי-AI. בוחרים את הכרטיסייה של אחד מהכלים הבאים כדי לראות את הוראות ההגדרה.

Gemini CLI

מתקינים את Gemini CLI.
כדי להתקין את התוסף של Firestore ל-Gemini CLI ממאגר GitHub, משתמשים בפקודה הבאה:
```
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"
```
התוסף ל-Gemini CLI ל-Firestore משתמש בפרטי הכניסה שמוגדרים כברירת מחדל באפליקציה (ADC) לצורך אימות.
מפעילים את Gemini CLI במצב אינטראקטיבי:
‫
```
gemini
```
ממשק ה-CLI טוען באופן אוטומטי את התוסף Firestore ל-Gemini CLI ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מסד הנתונים.

Gemini Code Assist

מומלץ להגדיר את Gemini Code Assist לשימוש ב-Gemini CLI. בגישה הזו אין צורך להגדיר שרת MCP באופן ידני.

מוודאים שהתקנתם והגדרתם את Gemini CLI ואת התוסף firestore-native.
איך מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI
מתחילים אינטראקציה עם מסד הנתונים של Firestore באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.

Claude code

התקנה של MCP Toolbox for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/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 למחשב

התקנה של MCP Toolbox for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/windows/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
הופכים את הקובץ הבינארי לקובץ הפעלה.
```
chmod +x toolbox
```
מאמתים את ההתקנה.
```
./toolbox --version
```

חיבור לשרת ה-MCP

פותחים את Claude Desktop ועוברים אל הגדרות.
בכרטיסייה 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.

קלין

התקנה של MCP Toolbox for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/windows/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
הופכים את הקובץ הבינארי לקובץ הפעלה.
```
chmod +x toolbox
```
מאמתים את ההתקנה.
```
./toolbox --version
```

התחברות לשרת ה-MCP

פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers (שרתי MCP).
לוחצים על Configure 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 for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/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 ‏ (Copilot)

התקנה של MCP Toolbox for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/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"
        }
      }
    }
  }

גלישת רוח

התקנה של MCP Toolbox for Databases

מורידים את הגרסה האחרונה של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה V0.15.0 ואילך של Toolbox.
‫linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/windows/amd64/toolbox
מחליפים את version במספר הגרסה של הכלי, לדוגמה v0.15.0.
הופכים את הקובץ הבינארי לקובץ הפעלה.
```
chmod +x toolbox
```
מאמתים את ההתקנה.
```
./toolbox --version
```

התחברות לשרת ה-MCP

פותחים את Windsurf ועוברים אל Cascade assistant.
לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים. המשתנה FIRESTORE_DATABASE הוא אופציונלי, וערך ברירת המחדל שלו הוא (default).

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

שימוש ב-Firestore עם MCP,‏ Gemini CLI וסוכנים אחרים

מידע על Gemini CLI ותוספים

איך תוספים פועלים

שימוש בתוסף ל-Gemini CLI עבור Firestore

לפני שמתחילים

הגדרת Firestore

הגדרת לקוח ה-MCP

Gemini CLI

Gemini Code Assist

Claude code

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

התחברות לשרת ה-MCP

‫Claude למחשב

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

חיבור לשרת ה-MCP

קלין

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

התחברות לשרת ה-MCP

סמן

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

התחברות לשרת ה-MCP

קוד Visual Studio ‏ (Copilot)

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

חיבור לשרת ה-MCP

גלישת רוח

התקנה של MCP Toolbox for Databases

‫linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

התחברות לשרת ה-MCP