MCP-Einrichtung
EmpfohlenMCP gibt einem Agenten drei schreibgeschützte Berechnungstools über stdio. Der Server bleibt auf Ihrem Rechner und benötigt weder SCHNGN-Konto noch API-Schlüssel.
Verbindung prüfen
Starten oder aktualisieren Sie Ihren MCP-Client und lassen Sie ihn die SCHNGN-Tools auflisten. Alle drei folgenden Operationen sollten erscheinen.
codex mcp get schngn --json Agenten-Skill
Der Skill lehrt einen Agenten, wann SCHNGN aufzurufen ist, wie explizite Aufenthaltszeiträume aufgebaut werden und wann Fragen zum Rechtsstatus abzulehnen sind.
Was der Skill ergänzt
- Bevorzugt die MCP-Tools, statt die Datumsberechnung neu zu bauen.
- Beschränkt Eingaben auf Einreise- und Ausreisedaten zusammenhängender Schengen-Aufenthalte.
- Bleibt bei gewöhnlicher Kurzaufenthaltsplanung und verweist Sonderfälle an offizielle Behörden.
Schnittstelle
CLI
Nutzen Sie die JSON-CLI in Skripten und Agenten-Shells. Sie liest striktes JSON aus stdin oder einer Datei und gibt ein JSON-Ergebnis zurück.
Befehle: schngn usage, schngn check-stay und schngn latest-exit.
schngn usage --input request.json Schnittstelle
REST + OpenAPI
Starten Sie für REST-Tools einen HTTP-Dienst nur auf Loopback. Er liefert ein aktuelles OpenAPI-Dokument und lehnt nicht lokale Bind-Adressen ab.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api Schnittstelle
TypeScript
Importieren Sie die reine Engine für grundlegende Datumsberechnungen oder das Capability-Paket für den strikten Agentenvertrag.
Pakete: @schngn/engine und @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'
});Tool-Referenz
Jede Schnittstelle bietet denselben versionierten Berechnungsvertrag. Daten verwenden YYYY-MM-DD und Aufenthaltszeiträume enthalten Einreise- und Ausreisetag.
calculate_schengen_usage
- Eingabe
{ stays, referenceDate, includeCountedDays? }- Zweck
- Verbrauchte und verbleibende Tage an einem expliziten Stichtag berechnen.
check_schengen_stay
- Eingabe
{ existingStays, candidateStay }- Zweck
- Einen geplanten zusammenhängenden Aufenthalt an jedem Tag prüfen.
latest_safe_schengen_exit
- Eingabe
{ existingStays, entryDate }- Zweck
- Die späteste sichere Ausreise für einen Aufenthalt mit bekanntem Einreisedatum finden.
Datenschutzgrenze
Die Berechnung bleibt lokal, der vollständige Agentenweg kann jedoch Cloud-Dienste enthalten.
LOCAL
SCHNGN-Laufzeit
Die Laufzeit speichert nichts, sendet keine Telemetrie, protokolliert keine übermittelten Daten und stellt keine ausgehenden Netzwerkanfragen.
HOST
Agenten-Host und Modellanbieter
Ihr MCP-Client oder Agenten-Host kann Prompts, Tool-Argumente und Ergebnisse an seinen Modellanbieter senden. Prüfen Sie dessen Datenschutz- und Aufbewahrungsregeln, bevor Sie echte Reisedaten verwenden.
Voraussetzungen
Node.js 24 oder neuer. Für die Berechnung sind kein SCHNGN-Konto, API-Schlüssel, gehosteter Endpunkt und keine Netzwerkverbindung nötig.
Umfang und Grenzen
Diese Funktion modelliert explizite zusammenhängende Aufenthalte nach der gewöhnlichen Schengen-90/180-Tage-Regel. Sie klassifiziert keine Länder, entscheidet nicht über Visa- oder Aufenthaltsrechte, wendet keine bilateralen Abkommen an und erteilt keine Rechtsberatung.
Nur eine Planungshilfe. Die zuständigen Behörden entscheiden über den erlaubten Aufenthalt.