דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-11-03·9 דק׳

MCP TypeScript SDK 2.4.0: הגשת Agent Skills דרך MCP (SEP-2640) ומה המפרט אומר לפקפק בו

MCP TypeScript SDK 2.4.0 מוסיף הרחבת Skills שמאפשרת לשרת לפרסם תיקיות SKILL.md ללקוחות. קראתי את ערות הגרסה, מדריכי ה-SDK ומפרט ההרחבה המקובע כדי לראות איך הרשימה, ה-digests וכללי האבטחה עובדים.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

MCP TypeScript SDK v2.4.0, שפורסם ב-GitHub ב-23 באוקטובר 2026, מוסיף הרחבת Skills. שרת יכול להגיש תיקייה של agent skills עם loadSkills('./skills') ו-attach(server), ולקוח יכול לרשום את ה-skills האלה ולקרוא את הקבצים שלהם עם SkillsClient. זה מיישם את SEP-2640, מזהה הרחבה io.modelcontextprotocol/skills. החלק ששווה לקרוא פעמיים הוא לא ה-API. זה חלק האבטחה של המפרט, שאומר שתוכן skill הוא קלט מודל לא מהימן ומשטח סיכון גבוה יותר מקריאת כלי מרוחקת.

קראתי את ערות הגרסה של v2.4.0, את ה-pull request שהוסיף את ההרחבה, את מדריכי ה-skills של השרת והלקוח ב-SDK, ואת טקסט מפרט ההרחבה ב-commit שה-SDK מקבע. לא התקנתי את ה-SDK ולא הרצתי את הדוגמה. מה שבא להלן הוא מה שהמסמכים האלה אומרים.

מה יצא

ערות הגרסה מפרטות "Skills over MCP (SEP-2640)" תחת New. שרת מפרסם תיקייה של skills, לקוח מפרט, קורא ומאמת אותם, וזה עובד על גרסאות פרוטוקול 2025-11-25 ו-2026-07-28. הערות אומרות ש-attach הוא ניסיוני ועשוי להשתנות בגרסת minor. לאותה גרסה יש הערות שדרוג לא קשורות ל-skills: x-mcp-header על פרמטר number נדחה, כפי שמפרט 2026-07-28 דורש, ו-outputSchema שנבנה מ-z.object(...).meta({ id }) כבר לא עטוף ב-{ result } על חיבור 2025-11-25.

ה-pull request אומר ש-API ה-skills חי תחת תתי-נתיבים חדשים של ext/skills, ושורשי החבילה לא טוענים קוד skills. הוא מדווח שהעבודה עוברת את תרחישי ההתאמה של SEP-2640 על שתי גרסאות הפרוטוקול.

איך שרת מפרסם skills

לפי מדריך השרת, כל תיקייה שמחזיקה SKILL.md היא skill אחד. ה-frontmatter מכיל name, שחייב להתאים לשם התיקייה, ו-description. המדריך מראה את skill://git-workflow/SKILL.md ו-skill://acme/billing/refunds/SKILL.md כ-URIs שהוא מפרסם, אחד לכל skill.

התנהגות נוספת שהמדריך מתעד:

  • הקטלוג שומר metadata בלבד: נתיבים, digests, גדלים ו-frontmatter. כל קריאה הולכת לתיקייה, וה-SDK מגיש את הבייטים רק אם הם עדיין תואמים ל-digest שפורסם.
  • קובץ שנערך על הדיסק מקבל שגיאה עד שקוראים ל-reload(), שסורק מחדש ומחזיר added, removed, changed ו-listChanged.
  • בלי מערכת קבצים, memorySkillFiles מגיש skills מוגדרים בקוד. אובייקט SkillFiles מותאם אישית עם list ו-read מגיש אותם מהאחסון שלכם.
  • על שרת שנבנה לכל בקשה דרך createMcpHandler, מפרסמים שינוי רשימה על ה-handler עם handler.notify.resourcesChanged().

איך לקוח קורא אותם

SkillsClient.list() מחזיר ערכים עם frontmatter ורשימת קבצים עם digests, ולא קורא אף קובץ skill. כברירת מחדל הוא זורק אם ערך כלשהו נכשל ב-ולידציה או URI חוזר. עם skipInvalid: true הוא מחזיר את התקינים ומדווח על ערכים נדחים ב-invalid.

read(entry) בודק גודל ו-digest SHA-256, ואז משווה frontmatter שדה מול שדה. manifest.body מחזיק את ההוראות לתת למודל. בדיקה כושלת זורקת SkillVerificationError עם סיבה של unlisted, size, digest או frontmatter. המדריך אומר שעל כל סיבה לא צריך להשתמש בקובץ, ועבור SKILL.md לא צריך לטעון את ה-skill. אם השרת מצהיר directoryRead, הלקוח יכול לרשום ילדי תיקייה דרך resources/directory/read.

המפרט: שלוש שיטות ושני גבולות

מפרט ההרחבה מוסיף skills/list, skills/get ו-resources/directory/read אופציונלי. הוא מסמיך את פורמט ה-skill עצמו למפרט Agent Skills ומגדיר רק את התעבורה. שני גבולות חלים לכל skill: 512 ערכים ב-resources, ו-16 MiB סך גודל קובץ. שרת יכול לסמן resources כ-"dynamic" לתוכן מיוצר, אבל אז הערך לא מציע שלמות תוכן, והמפרט אומר ש-hosts רשאים לסרב לטעון skills כאלה.

מה המפרט אומר לפקפק בו

חלק האבטחה נפתח בלקרוא לתוכן skill "instructional text delivered to a model, which makes it a prompt-injection surface". חלק מדרישות ה-MUST שלו ל-hosts:

  • התייחסו לתוכן skill המוגש-MCP כקלט מודל לא מהימן. שרת מחובר לא הופך את התוכן שלו לסמכותי.
  • תייגו תוכן skill עם השרת המקורי בנקודה שהוא נכנס להקשר המודל, ואל תציגו אותו כבלתי-ניתן להבחנה מ-skill של מערכת קבצים מקומית.
  • אל תאפשרו לתוכן skill המוגש-MCP לגרום להרצת קוד בצד ה-host בלי אישור משתמש מפורש לכל skill. זה מכסה hooks וסקריפטים של frontmatter, וטקסט גוף שאומר למודל להריץ סקריפט ארוז או פקודה שרירותית.
  • קשרו קריאות משאבים לשרת המקורי של ה-skill. skill משרת A לא יכול לגרום לקריאה מול שרת B.
  • התעלמו משדה allowed-tools של Agent Skills עבור skills ממקור MCP אלא אם המשתמש אישר במפורש את ההענקה הזו לאותו skill.
  • אל תתנו ל-skill של MCP להאפיל בשקט על skill באותו שם ממקור אחר, כולל מקומיים.

המפרט גם אומר ש-digests הם "not a trust anchor". הם לא חתומים ומגיעים מאותו שרת כמו התוכן, אז התאמה מוכיחה עקביות, לא מהימנות, ומתווך יכול לכתוב מחדש את שניהם. זה חשוב לאימות של ה-SDK: הוא תופס סטייה בין הרשימה לבייטים, ולפי המפרט הוא לא יכול להגיד לכם שהשרת ישר.

מה הייתי בודק

אלה הצעות שלא בדקתי, לא התנהגות מתועדת.

  • אם אתם בונים host, קראו את חלק האבטחה לפני שאתם מחברים SkillsClient ללולאת מודל. ה-SDK מאמת digests. שערי האישור, תוויות המקור וטיפול ההתנגשויות הם עבודת ה-host, ולא ראיתי שה-SDK עושה אותם במדריכים שקראתי.
  • הציגו למשתמשים את תווית השרת וטקסט ה-skill לפני טעינה ראשונה, והתייחסו לכל skill כאישור אחד.
  • אם אתם מפרסמים skills, שמרו אותם כהוראות. skill שמבקש מהמודל להריץ סקריפט יפגוש את שער האישור על host תואם.
  • קבעו את גרסת ה-SDK, מכיוון ש-attach מתועד כניסיוני.
  • בדקו עם skipInvalid בשני הכיוונים כדי שערך רע אחד לא יסיר בשקט skill שאתם מסתמכים עליו.

מה לא הייתי מסיק

  • לא הייתי מסיק ש-hosts או לקוחות אחרים תומכים בהרחבה. ה-pull request מזכיר התנהגות Go, C# ו-Python בהשוואות, אבל לא אימתתי שום מוצר host.
  • לא הייתי מסיק שה-SDK אוכף את כללי האבטחה של ה-host במפרט. קראתי מדריכים, לא מקור.
  • לא הייתי מסיק שתמיכת 2025-11-25 מיוצבת. ה-pull request קורא לה backport ממתין לקבוצת העבודה של ההרחבה.
  • לא הייתי מתייחס לאימות digest כבדיקת בטיחות לתוכן ה-skill.

שאלות נפוצות

מה זה הרחבת MCP Skills?

זו io.modelcontextprotocol/skills, מוגדרת על ידי SEP-2640. היא מאפשרת לשרת להגיש Agent Skills, SKILL.md ועוד קבצים תומכים, כמשאבי MCP, מתגלים דרך skills/list ו-skills/get.

איזו גרסת SDK הוסיפה את זה ל-TypeScript?

v2.4.0, שפורסמה ב-23 באוקטובר 2026 לפי הגרסה ב-GitHub.

איך מגישים skills?

קוראים ל-loadSkills('./skills') מתת-הנתיב ext/skills/node של חבילת השרת, יוצרים שרת, וקוראים ל-skills.attach(server). ערות הגרסה קוראות ל-attach ניסיוני.

איך לקוח בודק skill?

SkillsClient.read בודק את גודל הקובץ ו-digest SHA-256 מול הערך ומשווה את ה-frontmatter. כשל זורק SkillVerificationError.

האם skills בטוחים לטעינה מכל שרת?

המפרט אומר שלא. הוא דורש מ-hosts להתייחס לתוכן skill כקלט לא מהימן, לתייג את מקורו, לשער הרצת קוד ולהתעלם מ-allowed-tools אלא אם המשתמש מאשר.

מה גבולות הגודל?

לפי המפרט, 512 ערכים לכל skill ו-16 MiB סך גודל קובץ.

הרצת את זה?

לא. קראתי את ערות הגרסה, ה-pull request, מדריכי ה-SDK וטקסט המפרט המקובע. לא התקנתי או הרצתי את ה-SDK.

מקורות

כולם נקראו ב-3 בנובמבר 2026.

לא נקרא: קוד מקור ה-SDK, מפרט Agent Skills, שרשור הדיון של SEP-2640, וכל מוצר host או לקוח שמיישם את ההרחבה.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

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

עקבו ב-RSS