Konfigurimi MCP
RekomandohetMCP i jep agjentit tri mjete llogaritëse vetëm për lexim përmes stdio. Serveri qëndron në pajisjen tuaj dhe nuk kërkon llogari SCHNGN ose çelës API.
Verifikoni lidhjen
Rinisni ose rifreskoni klientin MCP, pastaj kërkojini të rendisë mjetet SCHNGN. Duhet të shihni të tria veprimet më poshtë.
codex mcp get schngn --json Aftësia e agjentit
Aftësia i mëson agjentit kur të thërrasë SCHNGN, si të formojë intervale të qarta qëndrimi dhe kur të refuzojë pyetje për statusin ligjor.
Çfarë shton aftësia
- Parapëlqen mjetet MCP në vend që të rindërtojë llogaritjen e datave.
- I kufizon hyrjet te datat e hyrjes dhe daljes për qëndrime të vazhdueshme Schengen.
- Qëndron brenda planifikimit të zakonshëm të qëndrimit të shkurtër dhe i drejton rastet e veçanta te autoritetet zyrtare.
Ndërfaqja
CLI
Përdorni JSON CLI në skripte dhe shell të agjentëve. Lexon JSON të rreptë nga stdin ose një skedar dhe kthen një rezultat JSON.
Komandat: schngn usage, schngn check-stay dhe schngn latest-exit.
schngn usage --input request.json Ndërfaqja
REST + OpenAPI
Nisni një shërbim HTTP vetëm në loopback për mjetet REST. Ai ofron një dokument OpenAPI aktiv dhe refuzon adresat e lidhjes jo lokale.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api Ndërfaqja
TypeScript
Importoni motorin e pastër për llogaritje bazë të datave ose paketën capability për kontratën e rreptë të agjentit.
Paketat: @schngn/engine dhe @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'
});Referenca e mjeteve
Çdo ndërfaqe ofron të njëjtën kontratë llogaritjeje të versionuar. Datat përdorin YYYY-MM-DD dhe intervalet përfshijnë ditët e hyrjes dhe daljes.
calculate_schengen_usage
- Hyrja
{ stays, referenceDate, includeCountedDays? }- Qëllimi
- Llogarit ditët e përdorura dhe të mbetura në një datë reference të qartë.
check_schengen_stay
- Hyrja
{ existingStays, candidateStay }- Qëllimi
- Kontrollon çdo ditë të një qëndrimi të vazhdueshëm të propozuar.
latest_safe_schengen_exit
- Hyrja
{ existingStays, entryDate }- Qëllimi
- Gjen daljen më të fundit të sigurt për një qëndrim me datë hyrjeje të njohur.
Kufiri i privatësisë
Kufiri i llogaritjes është lokal, por rruga e plotë e agjentit mund të përfshijë shërbime cloud.
LOCAL
Mjedisi SCHNGN
Mjedisi nuk ruan të dhëna, nuk dërgon telemetri, nuk regjistron datat e dorëzuara dhe nuk bën kërkesa rrjeti dalëse.
HOST
Pritësi i agjentit dhe ofruesi i modelit
Klienti MCP ose pritësi i agjentit mund t’i dërgojë udhëzimet, argumentet e mjeteve dhe rezultatet ofruesit të modelit. Kontrolloni politikat e privatësisë dhe ruajtjes para se të përdorni data reale udhëtimi.
Kërkesat
Node.js 24 ose më i ri. Për llogaritjen nuk kërkohet llogari SCHNGN, çelës API, endpoint i hostuar ose lidhje rrjeti.
Fusha dhe kufizimet
Kjo aftësi modelon qëndrime të qarta të vazhdueshme sipas rregullit të zakonshëm Schengen 90/180 ditë. Nuk klasifikon shtete, nuk vendos për të drejta vize ose qëndrimi, nuk zbaton marrëveshje dypalëshe dhe nuk jep këshillë ligjore.
Vetëm ndihmë për planifikim. Autoritetet kompetente vendosin qëndrimin e lejuar.