Настройка 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 дней. Она не классифицирует страны, не определяет визовые права или права на проживание, не применяет двусторонние соглашения и не даёт юридических консультаций.
Только помощь в планировании. Разрешённый срок пребывания определяют компетентные органы.