Налаштування 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
Імпортуйте чисте ядро для низькорівневих обчислень дат або пакет 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 днів. Вона не класифікує країни, не визначає візові права чи права на проживання, не застосовує двосторонні угоди й не надає юридичних порад.
Лише допомога в плануванні. Дозволений строк перебування визначають компетентні органи.