MCP TypeScript SDK 2.4.0: הגשת Agent Skills דרך MCP (SEP-2640) ומה המפרט אומר לפקפק בו
MCP TypeScript SDK 2.4.0 מוסיף הרחבת Skills שמאפשרת לשרת לפרסם תיקיות SKILL.md ללקוחות. קראתי את ערות הגרסה, מדריכי ה-SDK ומפרט ההרחבה המקובע כדי לראות איך הרשימה, ה-digests וכללי האבטחה עובדים.
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.
- typescript-sdk v2.4.0 release notes
- Skills extension pull request #3047
- SDK server skills guide
- SDK client skills guide
- ext-skills specification at the pinned commit
לא נקרא: קוד מקור ה-SDK, מפרט Agent Skills, שרשור הדיון של SEP-2640, וכל מוצר host או לקוח שמיישם את ההרחבה.
קריאה נוספת
- מה זה MCP? פרוטוקול הקונטקסט למודלים, מוסבר על ידי מישהו ששולח שרתים
MCP הוא ה-USB-C של כלי LLM: פרוטוקול אחד שנותן לכל מודל לדבר עם כל כלי או מקור נתונים. הנה מה זה, למה זה קיים, ואיך אני חושב על בניית שרת.
- Playwright MCP 0.0.84: עריכת פרמטרי URL, הקשרים מבודדים, ו-README שאומר שהוא לא גבול אבטחה
Playwright MCP v0.0.84 הוסיף הקשרי דפדפן מבודדים, עריכת פרמטרי URL, תוצאות find מוגבלות והיסטוריית בקשות על פני ניווטים. קראתי את ערות הגרסה וה-README ב-tag, כולל מה שהפרויקט אומר שהבקרות האלה לא מגנות עליו.
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS