MCP kurulumu
ÖnerilenMCP, ajana stdio üzerinden üç salt okunur hesaplama aracı verir. Sunucu makinenizde kalır ve SCHNGN hesabı veya API anahtarı gerektirmez.
Bağlantıyı doğrulayın
MCP istemcinizi yeniden başlatın veya yenileyin, ardından SCHNGN araçlarını listelemesini isteyin. Aşağıdaki üç işlemi de görmelisiniz.
codex mcp get schngn --json Ajan becerisi
Beceri, ajana SCHNGN uygulamasını ne zaman çağıracağını, açık kalış aralıklarını nasıl oluşturacağını ve hukuki statü sorularını ne zaman reddedeceğini öğretir.
Becerinin kattıkları
- Tarih hesabını yeniden yazmak yerine MCP araçlarını tercih eder.
- Girdileri kesintisiz Schengen kalışlarının giriş ve çıkış tarihleriyle sınırlar.
- Olağan kısa kalış planlaması içinde kalır ve istisnai durumları resmi makamlara yönlendirir.
Arayüz
CLI
JSON CLI aracını betiklerde ve ajan kabuklarında kullanın. stdin veya dosyadan katı JSON okur ve tek bir JSON sonucu döndürür.
Komutlar: schngn usage, schngn check-stay ve schngn latest-exit.
schngn usage --input request.json Arayüz
REST + OpenAPI
REST kullanan araçlar için yalnızca loopback üzerinde bir HTTP hizmeti başlatın. Güncel bir OpenAPI belgesi sunar ve yerel olmayan dinleme adreslerini reddeder.
OpenAPI: http://127.0.0.1:37491/openapi.json
schngn-api Arayüz
TypeScript
Düşük seviyeli tarih hesabı için saf motoru veya katı ajan sözleşmesi için capability paketini içe aktarın.
Paketler: @schngn/engine ve @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'
});Araç başvurusu
Her arayüz aynı sürümlü hesaplama sözleşmesini sunar. Tarihler YYYY-MM-DD biçimini kullanır ve aralıklar giriş ile çıkış günlerini içerir.
calculate_schengen_usage
- Girdi
{ stays, referenceDate, includeCountedDays? }- Amaç
- Açık bir referans tarihinde kullanılan ve kalan günleri hesaplar.
check_schengen_stay
- Girdi
{ existingStays, candidateStay }- Amaç
- Önerilen kesintisiz kalışın her gününü kontrol eder.
latest_safe_schengen_exit
- Girdi
{ existingStays, entryDate }- Amaç
- Giriş tarihi bilinen bir kalış için en geç güvenli çıkışı bulur.
Gizlilik sınırı
Hesaplama sınırı yereldir, ancak ajanın tüm yolu bulut hizmetlerini içerebilir.
LOCAL
SCHNGN çalışma ortamı
Çalışma ortamı verileri saklamaz, telemetri göndermez, sunulan tarihleri günlüğe kaydetmez ve dış ağ isteği yapmaz.
HOST
Ajan barındırıcısı ve model sağlayıcısı
MCP istemciniz veya ajan barındırıcınız istemleri, araç argümanlarını ve sonuçları model sağlayıcısına gönderebilir. Gerçek seyahat tarihlerini kullanmadan önce sağlayıcının gizlilik ve saklama politikalarını inceleyin.
Gereksinimler
Node.js 24 veya üzeri. Hesaplama için SCHNGN hesabı, API anahtarı, barındırılan uç nokta veya ağ bağlantısı gerekmez.
Kapsam ve sınırlamalar
Bu özellik, olağan Schengen 90/180 gün kuralı altında açık kesintisiz kalışları modeller. Ülkeleri sınıflandırmaz, vize veya ikamet haklarına karar vermez, ikili anlaşmaları uygulamaz ve hukuki tavsiye vermez.
Yalnızca planlama yardımıdır. İzin verilen kalışa yetkili makamlar karar verir.