MCP 설정
권장MCP는 stdio를 통해 에이전트에 읽기 전용 계산 도구 3개를 제공합니다. 서버는 사용자의 기기에 남으며 SCHNGN 계정이나 API 키가 필요 없습니다.
연결 확인
MCP 클라이언트를 다시 시작하거나 새로 고친 뒤 SCHNGN 도구 목록을 요청하세요. 아래의 세 작업이 모두 보여야 합니다.
codex mcp get schngn --json 에이전트 스킬
스킬은 SCHNGN을 호출할 시점, 명시적인 체류 범위를 만드는 방법, 법적 지위 질문을 거절할 시점을 에이전트에 알려 줍니다.
스킬이 더하는 동작
- 날짜 계산을 다시 구현하는 대신 MCP 도구를 우선합니다.
- 입력은 연속된 솅겐 체류의 입국일과 출국일로 제한합니다.
- 일반 단기 체류 계획 범위만 다루며 예외 사례는 공식 기관으로 안내합니다.
인터페이스
CLI
스크립트와 에이전트 셸에서는 JSON CLI를 사용하세요. stdin 또는 파일에서 엄격한 JSON을 읽고 하나의 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일 규칙에 따라 명시된 연속 체류를 모델링합니다. 국가를 분류하거나 비자 및 거주 권리를 판단하거나 양자 협정을 적용하거나 법률 조언을 제공하지 않습니다.
계획 보조용일 뿐입니다. 허용 체류 기간은 관할 당국이 결정합니다.