MCP 設定
推奨MCP は stdio 経由で 3 つの読み取り専用計算ツールをエージェントに提供します。サーバーは端末内に留まり、SCHNGN アカウントや API キーは不要です。
接続を確認
MCP クライアントを再起動または更新し、SCHNGN ツールの一覧を求めます。下記の 3 操作すべてが表示されます。
codex mcp get schngn --json エージェントスキル
このスキルは、SCHNGN を呼び出す場面、明示的な滞在範囲の作り方、法的地位に関する質問を断る場面をエージェントに教えます。
スキルが追加する動作
- 日付計算を作り直さず MCP ツールを優先します。
- 入力を連続したシェンゲン滞在の入域日と出域日に限定します。
- 通常の短期滞在計画に限定し、例外的な事案は公的機関へ案内します。
インターフェース
CLI
スクリプトやエージェントのシェルでは JSON CLI を使います。stdin またはファイルから厳格な JSON を読み、1 つの JSON 結果を返します。
コマンド: schngn usage、schngn check-stay、schngn latest-exit。
schngn usage --input request.json インターフェース
REST + OpenAPI
REST 対応ツール向けにループバック限定の HTTP サービスを起動します。最新の OpenAPI 文書を提供し、ローカル以外のバインドアドレスを拒否します。
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api インターフェース
TypeScript
低レベルの日付計算には純粋な engine を、厳格なエージェント契約には 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 日ルールに基づく明示的な連続滞在を扱います。国の分類、ビザや居住権の判断、二国間協定の適用、法律助言は行いません。
計画支援専用です。許可される滞在は管轄当局が判断します。