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

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

כדי להתחבר לשרת ה-MCP של Developer Knowledge מהאפליקציה או מקוד הסוכן שלכם במקום מסביבת פיתוח משולבת (IDE), עיינו במאמר חיבור באמצעות ערכות SDK של MCP.

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

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

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

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

בחירת שיטת אימות

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

• מפתח API: הכי מתאים לסביבות פיתוח משולבות (IDE) של צד שלישי ולסוכני CLI כמו Claude Code,‏ Cursor,‏ GitHub Copilot,‏ Codex ולקוחות אחרים של MCP מרחוק. מעבירים את מפתח ה-API בכותרת X-Goog-Api-Key באמצעות HTTPS.
• ‫OAuth ו-ADC: הכי מתאים ל-Google Antigravity, שכולל תמיכה מובנית בApplication Default Credentials (ADC), או לתהליכי עבודה ארגוניים שדורשים טוקן למוכ"ז של OAuth 2.0 או מזהה לקוח נפרד של OAuth 2.0 במקום מפתח API.

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

בוחרים כרטיסייה כדי ליצור את פרטי הכניסה:

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

הגדרת סביבת הפיתוח המשולבת (IDE) או סוכן התכנות

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

כדי להשתמש בטוקן למוכ"ז של ADC או במזהה לקוח של OAuth 2.0 עם Claude Code,‏ Cursor,‏ GitHub Copilot או Codex, צריך לפעול לפי ההוראות שבכרטיסייה אחר.

בהתאם לתבנית שבה משתמשים, מחליפים את ה-placeholder הבאים:

• ‫API key ‏ (YOUR_API_KEY): מחליפים במחרוזת הגולמית של מפתח ה-API.
• ‫Project ID‏ (PROJECT_ID): מחליפים במזהה הפרויקט שלכם ב-Google Cloud.

• טוקן גישה (ACCESS_TOKEN): מחליפים בטוקן למוכ"ז מ-gcloud auth application-default print-access-token.

{
  "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"
      }
    }
  }
}

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

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

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

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

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

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

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

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

אימות החיבור

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

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

אם הנציג מפעיל את search_documents או את answer_query ומחזיר מידע מהמסמכים של Google, השרת מחובר ופעיל.

שימוש במיומנות של סוכן הידע למפתחים

כדי ללמד את ה-Assistant מתי ואיך להשתמש בכלים הבסיסיים שמוצעים על ידי שרת ה-MCP של Developer Knowledge, צריך להתקין את סקיל הסוכן הרשמי של retrieving-developer-knowledge.

מיומנות של סוכן היא קבוצת הוראות שעוזר ה-AI לעזרה בתכנות קורא לפני שהוא מתחיל משימה. הסקיל retrieving-developer-knowledge פועל עם כל עוזר דיגיטלי שתומך בתקן הפתוח של Agent Skills, ועוזר לו לבצע את הפעולות הבאות:

• בחירת הכלי הנכון: עוזרת לכם להנחות את העוזר הדיגיטלי להשתמש ב-answer_query לשאלות כלליות מסוג 'איך עושים' ולהשוואות, וב-search_documents (עם שתיים עד חמש מילות מפתח ממוקדות) כשמחפשים דגלים מדויקים של CLI, הרשאות IAM או תחביר קוד.
• Check for errors before answering: הנחיה לעוזר הדיגיטלי לוודא שהחיפוש במסמכים הצליח לפני שהוא כותב תשובה, כדי שהוא לא יפרש בטעות שגיאה במפתח ה-API או במכסה כחוסר במסמכים, או ינחש על סמך נתוני אימון ישנים יותר.
• חזרה ל-API בארכיטקטורת REST: נותנת לעוזר הדיגיטלי פקודות curl כדי לקרוא ישירות ל-Developer Knowledge API אם כלי העריכה לא תומך בשרתי MCP או אם החיבור ל-MCP נכשל.

התקנת הסקיל של הסוכן

בוחרים את העוזר לתכנות כדי להתקין את היכולת retrieving-developer-knowledge בספריית הפרויקט:

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

npx skills add google/skills --skill retrieving-developer-knowledge

כדי לעדכן את המיומנויות המותקנות לגרסה העדכנית, מריצים את הפקודה:

npx skills update

כדי לראות את ההוראות המלאות ואת מדריכי העזר, עיינו בספרייה retrieving-developer-knowledge ב-GitHub.

אופטימיזציה של חלון ההקשר והשימוש בטוקנים

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

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

• התקנת יכולת של סוכן (מומלץ): מתקינים את היכולת של סוכן retrieving-developer-knowledge כדי שהעוזר הדיגיטלי יבחר באופן אוטומטי את כלי החיפוש המתאים (answer_query או search_documents), ישתמש בחיפושים של מילות מפתח קצרות ויוריד דפים מלאים רק כשצריך.

• להסתמך על אחזור דו-שלבי: הסוכן יתחיל בשיחה עם search_documents. התשובה כוללת קטעי מידע ממוקדים (chunks) שמכילים בדרך כלל את התחביר המדויק או את חתימת ה-API שאתם צריכים, בלי לצרוך טוקנים עבור הדף כולו. תנחה את הסוכן להתקשר אל get_documents רק אם יש צורך בהקשר הסביבתי.

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

• כתיבת פרומפטים ספציפיים וממוקדים: מומלץ להימנע מפרומפטים כלליים מדי כמו 'תסביר לי על כל Firebase'. במקום זאת, צריך לציין את מוצר היעד, הפלטפורמה והשפה:

  How do I write a Firestore transaction in Dart with error handling?
  

• הוספת כללים מותאמים אישית לסוכן: אם אתם לא משתמשים במיומנות retrieving-developer-knowledge, הוסיפו הנחיות ברמת הפרויקט לקובצי ההוראות של העוזר הדיגיטלי (לדוגמה, .cursorrules,‏ CLAUDE.md או .github/copilot-instructions.md) כדי להגביל את השליפה האוטומטית של דפים מלאים:

  When searching Google developer documentation, inspect search_documents
  snippets first. Do not call get_documents unless the snippet lacks
  necessary code context.
  

הגדרות אבטחה ובטיחות אופציונליות

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

מידע נוסף על אבטחה וניהול של MCP זמין במאמר בנושא אבטחה ובטיחות של AI.

שימוש ב-Model Armor

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

כשמפעילים את Model Armor עם הפעלת רישום ביומן, המערכת רושמת ביומן את כל מטען הנתונים. יכול להיות שהפעולה הזו תחשוף מידע רגיש ביומנים שלכם.

ניתוב בקשות MCP ל-Model Armor

הפעלת Model Armor

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

הגדרת הגנה לשרתי MCP מרוחקים

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

מגדירים את הגדרות האבטחה המינימליות של "הגנה מוגברת על המודל" עם הסרת תוכן זדוני או רגיש ב-MCP. מידע נוסף זמין במאמר בנושא הגדרת ערכי סף ב-Model Armor.

דוגמה לפקודה:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud.

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

• ‫INSPECT_AND_BLOCK: סוג האכיפה שבודק את התוכן בשרת MCP של Google וחוסם הנחיות ותשובות שתואמות למסננים.
• ‫ENABLED: ההגדרה שמפעילה מסנן או אכיפה.
• ‫MEDIUM_AND_ABOVE: רמת הסמך של הגדרות הסינון של "אתיקה של בינה מלאכותית – תוכן מסוכן". אפשר לשנות את ההגדרה הזו, אבל ערכים נמוכים יותר עלולים להוביל ליותר תוצאות חיוביות כוזבות. מידע נוסף זמין במאמר בנושא רמות הסמך של Model Armor.

השבתת הסריקה של תנועת MCP באמצעות Model Armor

כדי להפסיק את הסריקה האוטומטית של Model Armor לתנועה אל שרתי Google MCP וממנה, על סמך הגדרות האבטחה המינימליות של הפרויקט, מריצים את הפקודה הבאה:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud. ‫Model Armor לא מחיל באופן אוטומטי את הכללים שמוגדרים בהגדרות המינימום של הפרויקט על תנועה בשרת Google MCP.

הגדרות האבטחה המינימליות וההגדרות הכלליות של "הגנה מוגברת על המודל" יכולות להשפיע על יותר מאשר רק MCP. מכיוון ש-Model Armor משתלב עם שירותים כמו Vertex AI, כל שינוי שתבצעו בהגדרות האבטחה המינימליות יכול להשפיע על סריקת התנועה ועל התנהגויות הבטיחות בכל השירותים המשולבים, ולא רק ב-MCP.

שינוי ההגדרות של Model Armor

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

פתרון בעיות

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

שגיאות בהגדרה ובחיבור

שגיאות במפתח ה-API

שגיאות ב-OAuth וב-ADC

שגיאות שקשורות למכסה ולמסנן הבטיחות

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

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

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

• רק תיעוד ציבורי: השרת מבצע אינדקס רק של תיעוד שזמין לציבור ומפורט בהפניה לקורפוס. הוא לא כולל מסמכים פנימיים, מאגרים פרטיים ומשאבים של צד שלישי.
• אנגלית: השרת מוסיף לאינדקס ומחזיר מסמכים באנגלית בלבד.
• תלות ברשת ו-VPC Service Controls: מכיוון ששרת ה-MCP של Developer Knowledge הוא שירות מרוחק שמתארח, ללקוח שלכם צריכה להיות קישוריות לרשת כדי להגיע אל https://developerknowledge.googleapis.com.
  • בתוך רשתות VPC של Google Cloud: לא נדרשת תעבורת נתונים יוצאת לאינטרנט הציבורי. אפשר להגיע אל developerknowledge.googleapis.com באופן פרטי בלי כתובות IP חיצוניות או Cloud NAT, על ידי ניתוב התנועה באמצעות גישה פרטית ל-Google (private.googleapis.com / 199.36.153.8/30) או נקודת קצה (endpoint) של Private Service Connect ‏(PSC) שמטרגטת את החבילה all-apis.
  • ‫VPC Service Controls‏ (VPC-SC): developerknowledge.googleapis.com לא נתמך ב-VIP המוגבל (restricted.googleapis.com / 199.36.153.4/30) או בנקודות הקצה של PSC vpc-sc. אם המסלולים של ה-VPC שלכם מ-*.googleapis.com אל restricted.googleapis.com, צריך להגדיר מדיניות תגובה ספציפית של Cloud DNS או רשומת DNS פרטית עבור developerknowledge.googleapis.com כדי שהיא תפנה אל private.googleapis.com (199.36.153.8/30).