Configuration MCP
RecommandéMCP fournit à un agent trois outils de calcul en lecture seule via stdio. Le serveur reste sur votre machine et ne nécessite ni compte SCHNGN ni clé API.
Vérifier la connexion
Redémarrez ou actualisez votre client MCP, puis demandez-lui de lister les outils SCHNGN. Les trois opérations ci-dessous doivent apparaître.
codex mcp get schngn --json Compétence agent
La compétence apprend à l’agent quand appeler SCHNGN, comment former des plages de séjour explicites et quand refuser les questions de statut juridique.
Ce que la compétence ajoute
- Préfère les outils MCP plutôt que de recréer le calcul des dates.
- Limite les entrées aux dates d’entrée et de sortie des séjours Schengen continus.
- Reste dans la planification des courts séjours ordinaires et renvoie les cas exceptionnels aux autorités officielles.
Interface
CLI
Utilisez la CLI JSON dans des scripts et des shells d’agent. Elle lit du JSON strict depuis stdin ou un fichier et renvoie un seul résultat JSON.
Commandes : schngn usage, schngn check-stay et schngn latest-exit.
schngn usage --input request.json Interface
REST + OpenAPI
Lancez un service HTTP limité à la boucle locale pour les outils REST. Il fournit un document OpenAPI en direct et refuse les adresses d’écoute non locales.
OpenAPI : http://127.0.0.1:37491/openapi.json
schngn-api Interface
TypeScript
Importez le moteur pur pour le calcul de dates de bas niveau ou le paquet de capacité pour le contrat strict destiné aux agents.
Paquets : @schngn/engine et @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'
});Référence des outils
Chaque interface expose le même contrat de calcul versionné. Les dates utilisent YYYY-MM-DD et les plages incluent les jours d’entrée et de sortie.
calculate_schengen_usage
- Entrée
{ stays, referenceDate, includeCountedDays? }- Objectif
- Calculer les jours utilisés et restants à une date de référence explicite.
check_schengen_stay
- Entrée
{ existingStays, candidateStay }- Objectif
- Vérifier chaque jour d’un séjour continu proposé.
latest_safe_schengen_exit
- Entrée
{ existingStays, entryDate }- Objectif
- Trouver la dernière sortie sûre pour un séjour dont la date d’entrée est connue.
Limite de confidentialité
La limite de calcul est locale, mais le parcours complet de l’agent peut inclure des services cloud.
LOCAL
Moteur SCHNGN
Le moteur ne conserve rien, n’envoie aucune télémétrie, ne journalise pas les dates soumises et n’effectue aucune requête réseau sortante.
HOST
Hôte d’agent et fournisseur de modèle
Votre client MCP ou hôte d’agent peut envoyer les invites, arguments d’outil et résultats à son fournisseur de modèle. Consultez ses règles de confidentialité et de conservation avant d’utiliser de vraies dates de voyage.
Prérequis
Node.js 24 ou version ultérieure. Aucun compte SCHNGN, clé API, point de terminaison hébergé ou connexion réseau n’est requis pour le calcul.
Périmètre et limites
Cette capacité modélise des séjours continus explicites selon la règle ordinaire des 90/180 jours Schengen. Elle ne classe pas les pays, ne décide pas des droits de visa ou de séjour, n’applique pas les accords bilatéraux et ne fournit pas d’avis juridique.
Outil de planification uniquement. Les autorités compétentes décident du séjour autorisé.