הגדרת MCP
מומלץMCP מעניק לסוכן שלושה כלי חישוב לקריאה בלבד דרך stdio. השרת נשאר במחשב שלכם ואינו דורש חשבון SCHNGN או מפתח API.
אימות החיבור
הפעילו מחדש או רעננו את לקוח MCP, ואז בקשו ממנו להציג את כלי SCHNGN. כל שלוש הפעולות שלמטה אמורות להופיע.
codex mcp get schngn --json מיומנות הסוכן
המיומנות מלמדת את הסוכן מתי לקרוא ל-SCHNGN, כיצד לבנות טווחי שהייה מפורשים ומתי לסרב לשאלות על מעמד משפטי.
מה המיומנות מוסיפה
- מעדיפה את כלי MCP במקום לממש מחדש את חישוב התאריכים.
- מגבילה את הקלט לתאריכי כניסה ויציאה של שהיות רצופות בשנגן.
- נשארת בתחום תכנון שהייה קצרה רגילה ומפנה מקרים חריגים לרשויות הרשמיות.
ממשק
CLI
השתמשו ב-JSON CLI בסקריפטים ובמעטפות של סוכנים. הוא קורא JSON קפדני מ-stdin או מקובץ ומחזיר תוצאת JSON אחת.
פקודות: schngn usage, schngn check-stay ו-schngn latest-exit.
schngn usage --input request.json ממשק
REST + OpenAPI
הפעילו שירות HTTP המוגבל ל-loopback עבור כלי REST. הוא מספק מסמך OpenAPI עדכני ומסרב לכתובות קישור שאינן מקומיות.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api ממשק
TypeScript
ייבאו את engine הטהור לחישובי תאריכים ברמה נמוכה או את חבילת capability לחוזה הסוכן הקפדני.
חבילות: @schngn/engine ו-@schngn/capability
npm install @schngn/capability import { calculateUsage } from '@schngn/capability';
const result = calculateUsage({
stays: [{ entryDate: '2026-01-01', exitDate: '2026-01-12' }],
referenceDate: '2026-02-01'
});מדריך הכלים
כל ממשק חושף אותו חוזה חישוב בעל גרסה. תאריכים משתמשים במבנה YYYY-MM-DD וטווחי השהייה כוללים את ימי הכניסה והיציאה.
calculate_schengen_usage
- קלט
{ stays, referenceDate, includeCountedDays? }- מטרה
- חישוב הימים שנוצלו ושנותרו בתאריך ייחוס מפורש.
check_schengen_stay
- קלט
{ existingStays, candidateStay }- מטרה
- בדיקת כל יום בשהייה רצופה מוצעת.
latest_safe_schengen_exit
- קלט
{ existingStays, entryDate }- מטרה
- מציאת תאריך היציאה הבטוח המאוחר ביותר לשהייה עם תאריך כניסה ידוע.
גבול הפרטיות
גבול החישוב מקומי, אך המסלול המלא של הסוכן עשוי לכלול שירותי ענן.
LOCAL
סביבת ההרצה של SCHNGN
סביבת ההרצה אינה שומרת נתונים, שולחת טלמטריה, מתעדת תאריכים שנמסרו או שולחת בקשות רשת החוצה.
HOST
מארח הסוכן וספק המודל
לקוח MCP או מארח הסוכן עשוי לשלוח הנחיות, ארגומנטים של כלים ותוצאות לספק המודל. בדקו את מדיניות הפרטיות והשמירה שלו לפני שימוש בתאריכי נסיעה אמיתיים.
דרישות
Node.js 24 ומעלה. החישוב אינו דורש חשבון SCHNGN, מפתח API, נקודת קצה מתארחת או חיבור רשת.
תחום ומגבלות
יכולת זו מדמה שהיות רצופות מפורשות לפי כלל שנגן 90/180 הימים הרגיל. היא אינה מסווגת מדינות, קובעת זכויות אשרה או תושבות, מחילה הסכמים דו-צדדיים או מספקת ייעוץ משפטי.
כלי עזר לתכנון בלבד. הרשויות המוסמכות קובעות את השהייה המותרת.