Developer Knowledge API ושרת MCP של גוגל: תיעוד רשמי לסוכן הקוד שלכם, והמגבלות שגוגל מפרטת
מה ה-Developer Knowledge API של גוגל, שרת ה-MCP, פקודות gcloud וה-agent skill עושים, איך האימות עובד, ומגבלות הטריות וההיקף שגוגל מתעדת. נקרא מהתיעוד של גוגל עצמה.
סוכני קוד לעתים קרובות כותבים מול תיעוד מיושן. התשובה של גוגל למוצרים שלה עצמה היא ה-Developer Knowledge API ושרת MCP תואם שמשרתים את התיעוד הציבורי למפתחים של גוגל כ-Markdown.
ה-API עצמו לא חדש. גוגל הכריזה על public preview ב-4 בפברואר 2026, וב-7 באוקטובר פרסמה פוסט שמוסיף ממשק gcloud, agent skill וספריות לקוח. המאמר הזה קורא את הפוסט ההוא ועוד את עמוד ה-API, עמוד שרת ה-MCP ואת ההכרזה המקורית. לא השתמשתי בו.
מה הוא מציע
גוגל מתארת את ה-API כמקור האמת התכנותי לתיעוד הציבורי למפתחים שלה, מכסה מוצרים כמו Firebase, Google Cloud, Android ו-Google Maps Platform. הוא חושף שלוש פונקציות:
SearchDocumentChunks: מציאת URIs וקטעים רלוונטיים של עמודים לשאילתה.GetDocumentו-BatchGetDocuments: שליפת ה-Markdown המלא של תוצאות.AnswerQuery: יצירת תשובות שאוחזו מקורפוס התיעוד.
שרת ה-MCP ממפה אותן לשלושה כלים: search_documents, get_documents ו-answer_query. גוגל ממליצה על דפוס חפש-ואז-שלוף, כך שהסוכן קורא קטעים קצרים קודם ומושך עמודים מלאים רק כשצריך, מה שהיא אומרת ששומר על שימוש טוקנים נמוך.
דרכים להשתמש בו
לפי התיעוד של גוגל:
- נקודות קצה REST ו-RPC, ועוד ספריות לקוח ל-C#, Go, Java, Node.js ו-TypeScript, PHP, Python ו-Ruby.
- gcloud CLI, למשל
gcloud developer-knowledge answer-query --query="...",documents search-chunksו-documents describe. הפוסט של גוגל אומר שזה בא מותקן מראש ב-Cloud Shell. - שרת MCP, לעוזרי קוד. גוגל מכנה את Claude Code, Cursor, GitHub Copilot, Codex ו-Antigravity ככלים שזה עובד איתם.
- Agent skill, מותקן עם
npx skills add google/skills --skill retrieving-developer-knowledge. הוא אומר לעוזר איזה כלי לבחור, איך לטפל בשגיאות, ואיך ליפול חזרה ל-REST API עם curl אם שרת ה-MCP לא זמין.
ההדרכה של גוגל לבחירה: השתמשו ב-API ישירות אם אתם רוצים כלים מותאמים, צריכים לסנן תוצאות לפי data_source או update_time, או רוצים לעבד תוצאות לפני שהן מגיעות למודל. השתמשו בשרת ה-MCP וב-skill אם אתם רוצים לחבר עוזר בלי לכתוב הגדרות כלים ורוצים עדכונים אוטומטיים כשהשרת מוסיף יכולות.
אימות
עמוד ה-MCP מתאר שתי גישות:
- מפתח API, מועבר בכותרת
X-Goog-Api-Keyעל HTTPS. גוגל ממליצה עליו ל-IDEs של צד שלישי וסוכני CLI. צריך פרויקט Google Cloud, ומפעילים את ה-Developer Knowledge API שם. העמוד מציע להגביל את המפתח ל-Developer Knowledge API. - OAuth ו-Application Default Credentials, מתאים ל-Antigravity או התקנות ארגוניות שצריכות טוקן bearer של OAuth 2.0.
עמוד ה-API מפרט שני scopes מקובלים של OAuth: cloud-platform ו-devprofiles.full_control. הוא אומר שלא צריך תפקידי IAM ספציפיים כדי להפעיל או להשתמש ב-API.
פרט אחד מעמוד ה-MCP: אם אתם מתכננים לעשות שימוש חוזר באותו מפתח לקריאות מודל כמו GEMINI_API_KEY, צריך גם לאפשר את ה-Generative Language API עליו. חשבו על זה לפני שמשתפים מפתח אחד על פני שימושים.
מגבלות שגוגל מפרטת
- היקף. רק עמודים ציבוריים בקורפוס המפורסם כלולים. תוכן מ-GitHub, אתרי קוד פתוח, בלוגים ו-YouTube לא.
- איכות Markdown. ה-Markdown נוצר מ-HTML, אז יכולות להיות אי-התאמות או בעיות פורמט.
- טריות. עמוד ה-API מצהיר על יעד של אינדוקס מחדש תוך 48 שעות מפרסום, אז עדכונים זמינים תוך יומי עסקים. ההכרזה מפברואר אמרה שהתיעוד אונדקס מחדש תוך 24 שעות במהלך ה-public preview, והפוסט מאוקטובר אומר שהתוכן מאונדקס בתדירות גבוהה. שלוש ההצהרות נבדלות, אז אל תניחו פיגור ספציפי.
- סטטוס. הסטטוס היחיד שמצאתי הוא הכרזת ה-public preview מפברואר. לא מצאתי הצהרת זמינות כללית בעמודים שקראתי.
מה הייתי בודק
אלה הצעות שלי שלא נבדקו.
1. שאלו את הסוכן שאלה על API של גוגל שהשתנה לאחרונה והשוו את תשובתו עם עמוד התיעוד החי.
2. בדקו אם מקרה השימוש שלכם צריך תוכן מחוץ לקורפוס, כמו דוגמאות GitHub, כי אלה מוחרגות.
3. התייחסו לפלט answer_query כטקסט מיוצר. בדקו אותו נקודתית מול העמוד שהוא מצטט.
4. החליטו איפה מפתח ה-API גר ומי יכול לקרוא אותו.
מה לא הייתי מסיק
- שסוכנים עם השרת הזה מפסיקים להזות על APIs של גוגל. גוגל טוענת שזה מפחית אותם, אבל אין לי מדידה.
- שתיעוד ישן מיומי עסקים תמיד חסר. גוגל מצהירה על יעד, לא על ערובה.
- שזה מכסה ספריות שאינן של גוגל. ההיקף הוא התיעוד הציבורי של גוגל.
שאלות נפוצות
מהו ה-Developer Knowledge API?
הגישה התכנותית של גוגל לתיעוד הציבורי למפתחים שלה: חיפוש, שליפה כ-Markdown, ותשובות ממולחות.
אילו כלים שרת ה-MCP חושף?
search_documents, get_documents ו-answer_query.
איך מאמתים?
עם מפתח API בכותרת X-Goog-Api-Key, או עם OAuth ו-Application Default Credentials.
האם זה מכסה ריפוזיטוריים של GitHub או בלוגים?
לא. גוגל אומרת שרק עמודים ציבוריים בקורפוס הייחוס שלה כלולים.
כמה טרי התוכן?
עמוד ה-API של גוגל מצהיר על יעד של אינדוקס מחדש תוך 48 שעות מפרסום. הצהרות קודמות אמרו 24 שעות במהלך ה-preview.
האם זה זמין באופן כללי?
מצאתי רק את הכרזת ה-public preview מפברואר 2026 ואף הצהרת סטטוס מאוחרת יותר בעמודים שקראתי.
יש אפשרות שורת פקודה?
כן. ל-gcloud developer-knowledge יש answer-query, documents search-chunks ו-documents describe.
מקורות
- Google Developers Blog, Supercharge your development with the Google Developer Knowledge API ecosystem (7 באוקטובר 2026): gcloud, agent skill, ספריות לקוח.
- Developer Knowledge API: פונקציות, אימות, scopes, מגבלות, יעד טריות.
- Connect to the Developer Knowledge MCP server: כלים, אפשרויות אימות, התקנת מפתח. קראתי את החלק הראשון של העמוד.
- Google Developers Blog, Introducing the Developer Knowledge API and MCP Server (4 בפברואר 2026): public preview והצהרת טריות של 24 שעות. קראתי רק חלקים ממנו.
קריאה נוספת
- Playwright MCP 0.0.84: עריכת פרמטרי URL, הקשרים מבודדים, ו-README שאומר שהוא לא גבול אבטחה
Playwright MCP v0.0.84 הוסיף הקשרי דפדפן מבודדים, עריכת פרמטרי URL, תוצאות find מוגבלות והיסטוריית בקשות על פני ניווטים. קראתי את ערות הגרסה וה-README ב-tag, כולל מה שהפרויקט אומר שהבקרות האלה לא מגנות עליו.
- MCP TypeScript SDK 2.4.0: הגשת Agent Skills דרך MCP (SEP-2640) ומה המפרט אומר לפקפק בו
MCP TypeScript SDK 2.4.0 מוסיף הרחבת Skills שמאפשרת לשרת לפרסם תיקיות SKILL.md ללקוחות. קראתי את ערות הגרסה, מדריכי ה-SDK ומפרט ההרחבה המקובע כדי לראות איך הרשימה, ה-digests וכללי האבטחה עובדים.
- AgentEnv של Scale AI: מה framework קוד-פתוח לסביבות RL שולח, וכמה בוגר הוא נראה
Scale Labs שחררה בקוד פתוח את AgentEnv, SDK של Python ו-CLI לבניית סביבות מכולות והמשימות שמדרגות סוכנים בתוכן. מה הפוסט טוען, מה המאגר ו-PyPI מראים, ומה הייתי בודק לפני שבונים עליו.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS