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

תצוגה מקדימה

השימוש במוצר הזה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש במוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

שרת ה-MCP של Google Developer Knowledge מאפשר לכלי פיתוח מבוססי-AI לחפש בתיעוד הרשמי למפתחים של Google ולאחזר מידע על מוצרי Google כמו Firebase,‏ Google Cloud,‏ Android,‏ מפות Google ועוד. חיבור אפליקציית ה-AI ישירות לספריית התיעוד הרשמית שלנו מבטיח שהקוד וההנחיות שתקבלו יהיו עדכניים ומבוססים על הקשר מהימן.

אחרי שמגדירים את השרת, כלים משולבים יכולים לעזור בבקשות כמו:

• הדרכה בנושא הטמעה

  • לדוגמה: מה הדרך הכי טובה להטמיע הודעות פוש באמצעות העברת הודעות בענן ב-Firebase באפליקציית Android?

• יצירת קוד והסבר

  • לדוגמה: חפש במסמכי Google דוגמה ל-Python להצגת רשימה של כל הקטגוריות בפרויקט Cloud Storage.

• פתרון בעיות וניפוי באגים

  • לדוגמה: למה מופיע סימן מים עם הכיתוב 'למטרות פיתוח בלבד' במפתח Google Maps API שלי?

• ניתוח השוואתי וסיכום

  • לדוגמה: עזור לי לבחור בין Cloud Run לבין Cloud Functions עבור מיקרו-שירות חדש. תצור טבלת Markdown שמשווה בין היבטים מרכזיים כמו תרחיש השימוש העיקרי, מספר המשתמשים בו-זמנית ומודל התמחור.

יכולות של שרת ה-MCP

שרת ה-MCP של Google Developer Knowledge מספק לאפליקציית ה-AI שלכם את הכלים הבאים:

שם הכלי	תיאור
search_documents	מחפש במסמכי התיעוד למפתחים של Google (Firebase,‏ Google Cloud,‏ Android,‏ מפות Google ועוד) כדי למצוא דפים וקטעי מידע רלוונטיים לשאילתה שלכם. משתמשים ב-get_documents עם parent מתוצאות החיפוש כדי לקבל את התוכן המלא של הדף.
get_documents	קבלת התוכן המלא של כמה מסמכים באמצעות parents מתוצאות search_documents.

הכלי search_documents מחלק את מאמרי העזרה למקטעי טקסט קטנים יותר שעברו אופטימיזציה לחיפוש ולאחזור מבוססי-AI. כשמבצעים חיפוש, הכלי מחזיר תקציר של מסמך אחד או יותר שרלוונטיים לשאילתה. אם אתם רוצים לראות את התוכן המלא של הדף שמסביב לקטע מידע, אתם יכולים להשתמש ב-get_documents עם parent שמופיע בתוצאות החיפוש כדי לאחזר את התוכן המלא של הדף.

התקנה

שרת ה-MCP של Google Developer Knowledge הוא שרת MCP מרוחק שמשתמש ב-Developer Knowledge API כדי לחפש ולאחזר תיעוד. אפשר לבצע אימות באמצעות OAuth או מפתח API.

הערה: לא כל אפליקציות ה-AI תואמות לכל שיטת אימות. אם האפליקציה המועדפת לא מופיעה בקטע ההגדרה, נסו להשתמש בשיטת אימות נתמכת אחרת.

אימות באמצעות OAuth

בקטע הזה מוסבר איך לאמת את אפליקציית ה-AI באמצעות OAuth עם שרת ה-MCP של Developer Knowledge.

דרישה מוקדמת: הגדרת Google Cloud CLI

לפני שממשיכים, חשוב לוודא שיש לכם:

• פרויקט ב-Google Cloud
• התקנה מקומית של ה-CLI של gcloud

שלב 1: הפעלת Developer Knowledge API בפרויקט

1. פותחים את הדף של Developer Knowledge API בספריית Google APIs.
2. מוודאים שבחרתם את הפרויקט הנכון שבו אתם רוצים להשתמש ב-API.
3. לוחצים על הפעלה. לא נדרשים תפקידים ספציפיים ב-IAM כדי להפעיל את ה-API או להשתמש בו.

שלב 2: בחירה של שיטת האימות

שיטת האימות שתבחרו תלויה בשאלה אם העוזר האישי מבוסס-AI שלכם תומך ב-Application Default Credentials ‏(ADC) באמצעות ה-CLI של gcloud, או שהוא דורש מזהה לקוח OAuth עצמאי. עוזרים כמו Gemini CLI יכולים להשתמש בכניסה הקיימת שלכם ל-Google Cloud כדי להגדיר את החיבור בצורה חלקה, בעוד שאחרים, כמו Antigravity, דורשים ליצור פרטי כניסה משלכם ולספק אותם באופן ידני כדי ליצור חיבור מאובטח.

בוחרים את הכרטיסייה שמתאימה לדרישות ההגדרה של עוזר ה-AI הספציפי.

ADC

חיבור החשבון

1. כדי להעניק לשרת ה-MCP את היכולת לפעול בשמכם, מריצים את הפקודה הבאה ומחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud:

   gcloud auth application-default login
   --project=PROJECT_ID
   

2. כשמתבקשים לעשות זאת, בוחרים חשבון ולוחצים על המשך.

הגדרת אפליקציית ה-AI

אחרי האימות, השלב האחרון הוא לספק לאפליקציית ה-AI את פרטי הגדרת השרת. מבנה ה-JSON המדויק משתנה בהתאם לאפליקציה, אבל אפשר להשתמש בדוגמה הבאה כתבנית.

1. כדי להגדיר את Gemini CLI או את Gemini Code Assist, צריך לערוך או ליצור אחד מהקבצים הבאים:

   • בפרויקט: .gemini/settings.json
   • בספריית הבית: ~/.gemini/settings.json

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "httpUrl": "https://developerknowledge.googleapis.com/mcp",
         "authProviderType": "google_credentials",
         "oauth": {
           "scopes": [
             "https://www.googleapis.com/auth/cloud-platform"
           ]
        },
         "timeout": 30000,
         "headers": {
           "X-goog-user-project": "PROJECT_ID"
         }
       }
     }
   }
   

   כדי לבדוק אם שרת ה-MCP פועל כמו שצריך, ממשיכים אל אימות ההתקנה.

פרטי כניסה ידניים

מגדירים את מסך ההסכמה של OAuth

מגדירים את מסך ההסכמה ל-OAuth בפרויקט ומוסיפים את עצמכם כמשתמש לבדיקה. אם כבר ביצעתם את השלב הזה בפרויקט בענן שלכם ב-Google Cloud, אתם יכולים לדלג לשלב הבא.

1. פותחים את הדף 'סקירה כללית של אימות' במסוף Google Cloud ולוחצים על תחילת העבודה.
2. מזינים שם אפליקציה, בוחרים כתובת אימייל לתמיכה ולוחצים על הבא.
3. בקטע קהל, בוחרים באפשרות חיצוני ולוחצים על הבא.
4. מזינים את כתובת האימייל בקטע פרטים ליצירת קשר ולוחצים על הבא.
5. קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API ומסכימים לה, ואז לוחצים על Continue.
6. לוחצים על יצירה.

הוספת משתמשי בדיקה

1. בפלטפורמת האימות של Google, לוחצים על קהל.
2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
3. מזינים את כתובת האימייל שלכם ושל משתמשים מורשים אחרים לבדיקה, ואז לוחצים על שמירה.

יצירת לקוח OAuth

כדי לבצע אימות כמשתמש קצה ולגשת לנתוני משתמשים באפליקציה, צריך ליצור מזהה לקוח ב-OAuth 2.0. מזהה הלקוח משמש לזיהוי של אפליקציה אחת בשרתי OAuth של Google.

1. בפלטפורמת Google Auth, לוחצים על Clients (לקוחות).
2. לוחצים על Create client.
3. בבורר Application type (סוג האפליקציה), בוחרים באפשרות Desktop app (אפליקציה למחשב).
4. בשדה Name, מקלידים שם לפרטי הכניסה. השם הזה מוצג רק במסוף Google Cloud.
5. לוחצים על יצירה. מופיע מסך ליצירת לקוח OAuth, שבו מוצגים מזהה הלקוח החדש וסוד הלקוח.
6. לוחצים על אישור. פרטי הכניסה החדשים שנוצרו מופיעים בקטע מזהי לקוח ב-OAuth 2.0.
7. לוחצים על מזהה הלקוח החדש שיצרתם. בקטע Client secrets, לוחצים על סמל ההורדה כדי לשמור את קובץ ה-JSON. תשתמשו בערכים client_id ו-client_secret בקובץ הזה בשלב הבא.

הגדרת אפליקציית ה-AI

בשלב הבא, צריך לספק לאפליקציית ה-AI את פרטי הגדרת השרת. השלבים המדויקים משתנים בהתאם לאפליקציה, אבל אפשר להשתמש בדוגמה הבאה כתבנית.

כדי להגדיר את Antigravity לשימוש בשרת MCP:

1. ב-Antigravity, לוחצים על התפריט אפשרויות נוספות בחלונית Agent > שרתי MCP > ניהול שרתי MCP.

2. בחלק העליון של החלונית Manage MCP Servers (ניהול שרתי MCP) שנפתחת, לוחצים על View raw config (הצגת ההגדרות הגולמיות) כדי לערוך את הקובץ mcp_config.json:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "serverUrl": "https://developerknowledge.googleapis.com/mcp"
       }
     }
   }
   

3. חוזרים אל ניהול שרתי MCP ולוחצים על רענון.

הוספת פרטי כניסה של OAuth

בפעם הראשונה שתנסו להשתמש בשרת ה-MCP של Developer Knowledge, העוזר האישי מבוסס-AI יבקש מכם להשלים את ההגדרה:

1. אפשר לבקש מהסוכן להשתמש בשרת ה-MCP של Developer Knowledge באמצעות הנחיה כמו:

   How do I list Cloud Storage buckets?
   

2. אם מופיעה הודעה שמבקשת לרשום כתובות URI להפניה או יותר, לוחצים על האפשרות להמשך. מכיוון שהגדרתם את מזהה הלקוח כאפליקציה למחשב, אין צורך להוסיף את כתובות ה-URI הספציפיות האלה בפלטפורמת האימות של Google.

3. כשהעוזר האישי מבוסס-AI יבקש מכם את מזהה הלקוח ואת המפתח הסודי של הלקוח, תצטרכו להדביק כל מפתח מתאים מקובץ ה-JSON של המפתח הסודי של הלקוח ששמרתם קודם.

4. כשמתבקשים לעשות זאת, בוחרים חשבון ולוחצים על המשך.

5. חוזרים לעוזר האישי מבוסס-AI. הסוכן או הסוכנת יטפלו עכשיו בבקשה שלך באמצעות השרת שאומת לאחרונה.

אימות באמצעות מפתח API

בקטע הזה מוסבר איך לאמת את אפליקציית ה-AI באמצעות מפתח API בשרת ה-MCP של Developer Knowledge.

שלב 1: יצירת מפתח API

אפשר ליצור מפתח API של Developer Knowledge בפרויקט Google Cloud באמצעות מסוף Google Cloud או ה-CLI של gcloud:

Google Cloud Console

הפעלת ה-API

1. פותחים את הדף של Developer Knowledge API בספריית Google APIs.
2. מוודאים שבחרתם את הפרויקט הנכון שבו אתם רוצים להשתמש ב-API.
3. לוחצים על הפעלה. לא נדרשים תפקידים ספציפיים ב-IAM כדי להפעיל את ה-API או להשתמש בו.

יצירה ואבטחה של מפתח API

1. במסוף Google Cloud, בפרויקט שבו הפעלתם את ה-API, עוברים אל הדף Credentials.
2. לוחצים על Create credentials ובתפריט בוחרים באפשרות API key. בתיבת הדו-שיח API key created (מפתח API נוצר) מוצגת המחרוזת של המפתח החדש שיצרתם.
3. לוחצים על עריכת מפתח API.
4. בשדה Name (שם), מזינים שם למפתח.
5. בקטע API restrictions, בוחרים באפשרות Restrict key.
6. ברשימה Select APIs, מפעילים את Developer Knowledge API ולוחצים על OK.
   • הערה: אם הפעלתם עכשיו את Developer Knowledge API, יכול להיות שיחלוף זמן מה עד שהוא יופיע ברשימה Select APIs.
7. לוחצים על שמירה.

אחרי שיוצרים את המפתח, לוחצים על הצגת המפתח כדי לראות אותו. חשוב לרשום את המפתח כדי להשתמש בו כשמגדירים את אפליקציית ה-AI.

‫CLI של gcloud

1. אם עדיין לא עשיתם זאת, מורידים ומתקינים את ה-CLI של gcloud.

2. מפעילים את Developer Knowledge API, ומחליפים את PROJECT_ID במזהה הפרויקט בענן ב-Google Cloud:

   gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
   

3. יוצרים מפתח API באמצעות אותו מזהה פרויקט ב-Google Cloud:

   gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
   

   הפקודה הזו מחזירה מחרוזת של מפתח API. חשוב לרשום את המפתח כדי להשתמש בו כשמגדירים את אפליקציית ה-AI.

4. כדי לאבטח את מפתח ה-API, צריך להוסיף הגבלות על מפתחות API. כדי לשפר את האבטחה, כדאי להגביל את מפתח ה-API ל-Developer Knowledge API.

הערה: כדי לראות את השימוש במכסה של מפתח ה-API הפרטי ולנהל אותו, צריך לעבור אל הדף IAM & Admin > Quotas & System Limits במסוף Google Cloud, לבחור באפשרות Service ואז לבחור באפשרות Developer Knowledge API בשדה המסנן.

שלב 2: הפעלת שרת ה-MCP של Developer Knowledge בפרויקט

הערה: אחרי 17 במרץ, השרת של Developer Knowledge MCP מופעל אוטומטית כשמפעילים את Developer Knowledge API.

כדי להפעיל את שרת ה-MCP של מפתח בפרויקט Google Cloud, מורידים ומתקינים את ה-CLI של gcloud, ואז מריצים את הפקודה הבאה ומחליפים את PROJECT_ID במזהה פרויקט Google Cloud:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

אם שירות הידע למפתחים לא מופעל בפרויקט Google Cloud שלכם, תתבקשו להפעיל את השירות לפני הפעלת שרת ה-MCP המרוחק.

כשיטה מומלצת לאבטחה, מומלץ להפעיל שרתי MCP רק בשירותים שנדרשים כדי שאפליקציית ה-AI שלכם תפעל.

טיפ: אם נתקלתם בשגיאה בהרצת הפקודה gcloud, מריצים את הפקודה gcloud components update beta כדי לעדכן את הרכיבים, ואז מנסים שוב.

שלב 3: הגדרת אפליקציית ה-AI

במאמר הזה מוסבר איך להגדיר אפליקציות פופולריות מבוססות-AI. מחליפים את YOUR_API_KEY במפתח Developer Knowledge API שיצרתם בשלב הקודם:

Gemini CLI

כדי להגדיר את Gemini CLI, מריצים את הפקודה הבאה:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

לחלופין, אפשר לערוך או ליצור אחד מקובצי ההגדרות הבאים:

• בפרויקט: .gemini/settings.json
• בספריית הבית: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

כדי להגדיר את Gemini Code Assist, עורכים או יוצרים אחד מקובצי ההגדרות הבאים:

• בפרויקט: .gemini/settings.json
• בספריית הבית: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

כדי להגדיר את Claude Code, מריצים את הפקודה הבאה בתיקיית האפליקציה.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

סמן

כדי להגדיר את Cursor, עורכים את .cursor/mcp.json (לפרויקט ספציפי) או את ~/.cursor/mcp.json (לכל הפרויקטים).

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

‫GitHub Copilot

כדי להגדיר את GitHub Copilot ב-VS Code לפרויקט יחיד, עורכים את הקובץ .vscode/mcp.json בסביבת העבודה.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

כדי שהשרת יהיה זמין בכל פרויקט, צריך לערוך את הגדרות המשתמש. לוחצים על הלחצן פתיחת ההגדרות (JSON).

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

גלישת רוח

כדי להגדיר את Windsurf Editor, עורכים את הקובץ ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

אימות התקנה

אחרי שמגדירים את אפליקציית ה-AI, פותחים אותה ומזינים הנחיה כמו:

How do I list Cloud Storage buckets?

אם אתם רואים קריאה לכלי search_documents או לכלי אחר של שרת MCP של Developer Knowledge, השרת פועל בצורה תקינה.

ניהול השימוש בטוקנים

אחזור תוכן של מסמך – במיוחד כשמשתמשים ב-batch_get_documents – צורך טוקנים בחלון ההקשר של אפליקציית ה-AI. חלק מדפי התיעוד למפתחי Google גדולים מאוד, ולכן אחזור של כמה מסמכים יכול להוביל במהירות לעלויות גבוהות יותר, לזמני תגובה ארוכים יותר של המודל ולגלישה על גדות חלון ההקשר.

כדי לשפר את הביצועים ולמנוע חיוב לא צפוי, כדאי ליצור הנחיות ספציפיות שמכוונות רק למידע שאתם צריכים. אל תגישו בקשות רחבות מדי (לדוגמה, "השוואה בין כל המוצרים של Firebase") שמאלצות את הסוכן לעכל כמויות עצומות של נתונים בבת אחת.

מסמכים כלולים

במאמר הפניה לקורפוס מוסבר אילו מסמכים נסרקים על ידי השרת.

מגבלות ידועות

• היקף התוכן: רק דפים שגלויים לכולם בהפניה למאגר המידע נכללים. התוכן לא כולל תוכן ממקורות אחרים כמו GitHub, אתרי OSS, בלוגים או YouTube.
• תוצאות באנגלית בלבד: השרת תומך רק בתוצאות באנגלית.
• תלוי ברשת: הכלים של השרת מסתמכים על שירותים פעילים של Google Cloud. אם השגיאות נמשכות, צריך לבדוק את החיבור לאינטרנט ואת ההגדרה של מפתח ה-API של Developer Knowledge.

פתרון בעיות

אם נתקלים בבעיות, כדאי לבדוק את הדברים הבאים:

• קובץ התצורה של MCP בכלי ה-AI מפורמט בצורה נכונה.
• אם משתמשים בשיטת האימות של API, צריך להשתמש במפתח API תקין של Developer Knowledge בקובץ התצורה שבו מופעל Developer Knowledge API.
• לא חרגתם מהמכסה של Developer Knowledge API.

Model Armor

אם אתם משתמשים ב-הגנה מוגברת על המודל כדי להגן על האפליקציה, יכול להיות שתיתקלו בשגיאות 403 PERMISSION_DENIED בשאילתות מסוימות. השרת של Developer Knowledge MCP מחזיר רק תיעוד ציבורי ממקורות מהימנים של Google, ולכן מומלץ להגדיר את המסננים של הזרקת הנחיות ופריצה (PIJB) לרמות מהימנות של HIGH_AND_ABOVE כדי לצמצם את התוצאות החיוביות הכוזבות. אם תרחיש השימוש שלכם לא כולל כלים אחרים שניגשים לנתונים פרטיים או רגישים, אפשר גם להשבית את המסננים של PIJB.