התחברות לשרתי Model Context Protocol ‏ (MCP)

שרתי MCP מספקים ל-Gemini כלים נוספים ומקורות נתונים. לדוגמה, אם מוסיפים את שרת ה-MCP של Firebase, אפשר להשתמש בשפה טבעית כדי לחקור את נתוני Cloud Firestore בזמן שיוצרים את האפליקציה או מנפים בה באגים.

דרישות מוקדמות

אם נדרש על ידי שרת ה-MCP, מוודאים שיש לכם התקנה תקינה של Node.js ו-npm.

בחירת שרת MCP תואם

‫Firebase Studio כולל תמיכה בסיסית בשרתי MCP, אבל לא כל שרתי MCP תואמים. כשבוחרים שרת MCP, חשוב לקחת בחשבון את פרטי התאימות הבאים:

  • נתמך:

    • שרתים של קלט/פלט רגיל (stdio) או של אירועים שנשלחים מהשרת (SSE)/העברת HTTP שניתנת להזרמה
    • אימות באמצעות מפתח API באמצעות כותרות HTTP או משתני סביבה
    • כלים שסופקו על ידי שרתי MCP

  • לא נתמך:

    • שרתים שנדרש עבורם ממשק משתמש גרפי או סשן במחשב
    • הנחיות, דגימה או משאבים אחרים שסופקו על ידי שרתי MCP

הוספת שרת MCP

כדי להוסיף שרת MCP, צריך ליצור או לערוך את קובץ התצורה שלו.

שלב 1: יוצרים את קובץ התצורה

גם צ'אט אינטראקטיבי וגם Gemini CLI יכולים להתחבר לשרתי MCP, אבל הם משתמשים בקובצי הגדרה שונים:

  • הצ'אט האינטראקטיבי משתמש ב-.idx/mcp.json.
  • Gemini CLI משתמש ב-.gemini/settings.json.

יוצרים קובץ אחד או את שני הקבצים לפי ההוראות הבאות.

צ'אט אינטראקטיבי

בתצוגה Code, יוצרים .idx/mcp.json באחת מהשיטות הבאות:

  • לוח הפקודות: פותחים את לוח הפקודות (Shift+Ctrl+P) ומשתמשים בפקודה Firebase Studio: Add MCP Server.
  • בצ'אט האינטראקטיבי: לוחצים על התאמה אישית של סמל כלי העריכה התאמה אישית של כלים בצ'אט האינטראקטיבי ובוחרים באפשרות הוספת שרת MCP.
  • סייר: בסייר (Ctrl+Shift+E), לוחצים לחיצה ימנית על הספרייה .idx ובוחרים באפשרות קובץ חדש. נותנים לקובץ את השם mcp.json.

Gemini CLI

בתצוגה Code, יוצרים .gemini/settings.json:

  1. בסייר (Ctrl+Shift+E), בודקים אם התיקייה .gemini קיימת. אם לא, לוחצים לחיצה ימנית על חלונית הסייר ובוחרים באפשרות תיקייה חדשה. נותנים לתיקייה את השם .gemini.
  2. לוחצים לחיצה ימנית על הספרייה .gemini ובוחרים באפשרות New file (קובץ חדש). נותנים שם לקובץ settings.json.

לפרטים על השימוש בשרתי MCP עם Gemini CLI, אפשר לעיין במסמכי התיעוד המלאים.

שלב 2: עריכת הגדרות השרת

  1. פותחים את קובץ התצורה של השרת.

  2. מוסיפים את הגדרות השרת לתוכן של הקובץ. לדוגמה, כדי להוסיף את שרת ה-MCP של Firebase, מזינים:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "mcp"
      ]
    }
  }
}

    קובץ תצורה זה מורה ל-Gemini באיזה שרת MCP רוצים להשתמש. בדוגמה הזו מוצג שרת יחיד בשם firebase שישתמש בפקודה npx כדי להתקין ולהפעיל את firebase-tools@latest.

    אם השרת שלכם דורש אימות באמצעות מפתח API, אתם יכולים להגדיר אותו באחת מהדרכים הבאות:

    • לשרתי HTTP MCP מרוחקים שדורשים מפתח API בכותרות של בקשות, משתמשים בשדה headers. לדוגמה, כדי להגדיר את שרת ה-MCP של GitHub:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • לשרתי MCP מקומיים של stdio שדורשים מפתח API במשתני סביבה, משתמשים בשדה env. לדוגמה, כדי להגדיר בנייה מקומית של שרת MCP של GitHub:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

    • כדי להימנע מהוספת סודות בקידוד קשיח ב-mcp.json, אפשר להשתמש בתחביר ${env:VARIABLE_NAME}. הערכים יוחלפו במשתני סביבה שמוגדרים בקובץ .env או .env.local בתיקיית הבסיס של סביבת העבודה. לדוגמה:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
      }
    }
  }
}

  3. במסוף (Shift+Ctrl+C), מריצים את הפקודות הנדרשות כדי להשלים את ההתקנה. לדוגמה, כדי להשתמש בשרת ה-MCP של Firebase, מזינים את הפקודה הבאה כדי להיכנס לחשבון:

    firebase login --no-localhost

    פועלים לפי ההוראות במסוף כדי לאשר את ההפעלה. חלק מהכלים דורשים פרויקט Firebase מקושר. אפשר להשתמש בשרת Firebase MCP כדי ליצור פרויקט, או להריץ את הפקודה הבאה כדי לאתחל פרויקט Firebase:

    firebase init

    הפעולה הזו יוצרת קובץ firebase.json בספריית הבסיס.

שימוש בכלים של MCP

אחרי שמתקינים את שרת ה-MCP שרוצים להשתמש בו, הכלים או הנתונים שהוא מספק זמינים ב:

  • Gemini CLI
  • צ'אט אינטראקטיבי כשמשתמשים במצבים Agent Mode ו-Agent (Auto-run)
  • ‫App Prototyping agent

לדוגמה, אם מוסיפים את שרת ה-MCP של Firebase, אפשר לבקש מ-Gemini לאחזר את הגדרות ה-SDK של הפרויקט הנוכחי, לאחזר נתונים שמאוחסנים ב-Cloud Firestore וב-Realtime Database, לעזור בהגדרת שירותי Firebase, ועוד.

בצ'אט אינטראקטיבי, מקלידים / כדי לראות רשימה של הנחיות MCP זמינות.

רשימת ההנחיות הזמינות של MCP

בדיקה או התאמה של הכלים

אתם יכולים להגדיר אילו כלים יהיו פעילים בצ'אט האינטראקטיבי:

  1. לוחצים על התאמה אישית של סמל כלי העריכה התאמה אישית של כלים בצ'אט האינטראקטיבי כדי לראות רשימה של כל הכלים הזמינים משרתי ה-MCP שהגדרתם.
  2. משתמשים בתיבות הסימון כדי להפעיל או להשבית שרת שלם או כלים בודדים.

רשימת הכלים הזמינים של MCP

פתרון בעיות בשרתי MCP

אם נתקלתם בבעיות בשרת MCP, תוכלו לבצע את השלבים הבאים כדי לאבחן את הבעיה.

בדיקת היומנים לאיתור שגיאות

  1. פותחים את חלונית הפלט (Shift+Ctrl+U).
  2. בתפריט הנפתח, בוחרים באפשרות Gemini.
  3. בודקים אם יש הודעות שמתחילות בתג [MCPManager]. ביומנים האלה אפשר לראות אילו שרתים הוגדרו, אילו כלים נוספו בהצלחה והודעות שגיאה.

בנייה מחדש של הסביבה

אם שרת MCP לא מצליח להתקין או להתחבר, נסו לבנות מחדש את סביבת העבודה:

  1. פותחים את לוח הפקודות (Shift+Ctrl+P).
  2. מריצים את הפקודה Firebase Studio: Rebuild Environment.
  3. אחרי שה-Workspace נבנה מחדש, בודקים אם שרת ה-MCP מתחבר.

אם לא נעשה שימוש בכלים

אם שרת ה-MCP מתחבר אבל Gemini לא משתמש בכלים שלו:

  • התחלת שיחת צ'אט חדשה: כך מוודאים ש-Gemini יקבל את ההגדרה העדכנית של הכלי. איך מנהלים את היסטוריית הצ'אט
  • היו ספציפיים בהנחיה: אם Gemini יכול לבצע את המשימה בלי להשתמש בכלי MCP, יכול להיות שהוא ינסה שיטה אחרת. אם רוצים להשתמש בכלי ספציפי, כדאי לנסות לתת לו שם. לדוגמה: "Use firebase_get_sdk_config to get the SDK config for the current project."
  • הצטרפות ל-Google Developer Program: בדיקה אם החשבון רשום.

השלבים הבאים