채팅으로 여는 뒷문은 없다: AI 도구 호출에도 앱 이용 권한 검사 적용하기

핵심 요약

• 유료 데스크톱 앱에 MCP 서버를 붙이면 들어오는 길이 하나 더 생깁니다. 플랜 검사가 앱 화면에만 있다면 AI 경로는 그 검사를 건너뜁니다.
• KwaFlux에서는 AI 도구 호출도 클릭과 똑같은 로그인·플랜 검사를 같은 곳에서 거칩니다. 그곳은 MCP 스크립트가 아니라 앱의 컨트롤 플레인입니다.
• 작업을 실행하는 워커도 다시 확인합니다. 유료 작업을 시작하기 전에 Ed25519로 서명된 리스를 검증합니다.
• 작업을 재개하거나 재시도하면 그 시점에 검사를 다시 거칩니다. 따라서 만료된 플랜이나 꺼 둔 설정을 재시도로 되살릴 수 없습니다.

KwaFlux에 MCP 서버를 붙일 때 가장 먼저 정한 원칙이 있습니다. AI 어시스턴트는 사용자가 앱에서 할 수 있는 일을 그대로, 그 이상도 그 이하도 아니게 할 수 있어야 한다는 것입니다. 그래서 기능을 지키는 계정 검사는 클릭에 적용되는 것과 똑같이 도구 호출에도 적용됩니다.

이 원칙은 플랜이나 설정이 바뀌었을 수도 있는 나중 시점에 어시스턴트가 작업을 재시도할 때도 지켜져야 합니다.

이 글에서는 유료 기능으로 가는 두 번째 경로가 흔히 어디서 생기는지, KwaFlux가 두 경로에 검사를 하나로 유지하는 방법, 워커의 서명된 리스가 더해 주는 것, 그리고 재시도할 때마다 다시 검사하는 이유를 알아봅니다.

목차

1. 이용 권한 검사란?
2. 뒷문이 흔히 생기는 곳
3. 검사는 하나, 앱 안에서
4. 워커에서 한 번 더 검사
5. 재개와 재시도도 검사를 다시 거칩니다
6. MCP로 무료로 쓸 수 있는 것
7. 이 설계가 하는 일과 하지 않는 일
8. 자주 묻는 질문

이용 권한 검사란?

이용 권한 검사(entitlement check)는 기능을 실행하기 전에, 로그인한 계정이 그 기능에 필요한 플랜이나 라이선스를 가졌는지 소프트웨어가 확인하는 단계입니다.

KwaFlux에서 파일을 만들어 내는 기능, 즉 내보내기(AI 향상 포함), 변환, 파일 복구, 링크에서 다운로드는 로그인과 플랜이 필요합니다. 둘러보기, 가져오기, 미리보기, 파일 진단처럼 그 밖의 기능은 계정 없이 쓸 수 있습니다.

뒷문이 흔히 생기는 곳

데스크톱 앱은 플랜을 사용자 인터페이스에서 검사하는 경우가 많습니다. 버튼을 비활성화하거나, 버튼을 누르면 업그레이드 화면을 띄우는 식입니다. 두 번째 호출자가 나타나기 전까지는 이것으로 충분합니다.

MCP 서버가 바로 두 번째 호출자입니다. MCP 서버가 엔진에 작업을 곧바로 보내거나, 원래 버튼이 지키던 내부 함수를 직접 호출하면 UI 검사는 실행되지 않습니다. MCP 사양이 접근 제어를 서버 쪽에 두는 이유도 여기에 있습니다. 서버는 모든 도구 입력을 검증하고 "적절한 접근 제어를 구현"해야 한다("MUST")고 규정합니다. 버튼에 들어 있는 검사는 검사로 치지 않습니다.

검사는 하나, 앱 안에서

KwaFlux는 모든 요청이 거쳐 가야 하는 곳에 검사를 둡니다. 실행 중인 앱 안의 컨트롤 플레인입니다. MCP 스크립트는 플랜에 관해 아무것도 결정하지 않습니다. 형식이 정해진 요청을 전달할 뿐이고, 답은 앱이 합니다.

로그인하지 않았거나 플랜이 그 기능을 포함하지 않으면 어시스턴트는 그렇다고 알려 주는 구조화된 오류를 받고, 사용자에게 로그인하라고 안내할 수 있습니다. 우회할 수는 없습니다. 달리 호출할 곳이 없기 때문입니다. 각 계층이 어떻게 맞물리는지는 AI 에이전트가 화면을 클릭하면 안 되는 이유를 참고하세요.

워커에서 한 번 더 검사

앱의 검사는 작업을 대기열에 넣어도 되는지를 결정합니다. 실제로 엔진을 돌리는 별도 프로세스인 워커는 유료 작업을 시작하기 전에 직접 한 번 더 검사합니다. 작업마다 발급되어 Ed25519로 서명된 리스(lease)를 검증하는 것입니다.

다른 프로세스에서 서명을 확인하므로 판단이 한곳에만 기대지 않습니다. 다른 경로로 워커에 도달한 작업은 유효한 서명 리스가 없으면 유료 기능을 실행하지 않습니다.

Ed25519는 RFC 8032에 규정된 에드워즈 곡선 서명 방식입니다. 키와 서명이 작고(Ed25519 기준 공개 키 32바이트, 서명 64바이트) 검증이 빨라서, 작업마다 수행하는 검사에 잘 맞습니다.

참고: 리스에 무엇이 담기는지, 유효 기간이 얼마인지는 일부러 밝히지 않습니다. 이 설계의 요점은 워커가 작업을 건넨 쪽을 믿지 않고도 리스를 검증할 수 있다는 데 있습니다.

재개와 재시도도 검사를 다시 거칩니다

까다로운 부분은 재시도입니다. 대기열에 넣을 때 허용된 작업이 한 시간 뒤 재개할 때는 허용되지 않을 수 있습니다. KwaFlux는 재개와 재시도를 새로운 결정으로 다룹니다.

• 플랜을 다시 검사합니다. 작업을 대기열에 넣은 뒤 플랜이 끝났다면, 유료 작업을 재개하거나 재시도할 때 새 요청과 똑같이 검사를 통과하지 못합니다.
• 다운로드 설정을 다시 검사합니다. 어시스턴트가 다운로드를 대기열에 넣은 뒤 사용자가 에이전트 다운로드를 껐다면, 재시도는 거부됩니다. AI가 다운로드를 대신 승인할 수 없는 이유를 참고하세요.
• 소유권을 다시 검사합니다. 어시스턴트는 자신이 제출한 작업만 재개하거나 재시도할 수 있습니다.

그렇지 않으면 한 번 승인된 작업을 이미 유효하지 않은 결정에 기대어 몇 번이고 재시도할 수 있게 됩니다. 실행하는 순간에 검사하면 그 틈이 메워집니다.

MCP로 무료로 쓸 수 있는 것

KwaFlux의 무료 기능은 MCP에서도 무료입니다. 로그인하지 않아도 어시스턴트는 다음을 할 수 있습니다.

• KwaFlux가 실행 중인지, 로그인되어 있는지 확인
• 작업 목록을 보고 상태 읽기
• 손상된 파일을 진단해 복구할 수 있는지 확인
• 자신이 만든 작업을 일시 중지하거나 취소

1·3·5초 무료 미리보기는 앱 안에서 하며, 어시스턴트가 렌더링하지는 않습니다.

이 설계가 하는 일과 하지 않는 일

이 설계는 두 경로의 규칙을 똑같이 유지합니다. AI 어시스턴트가 무언가를 새로 열어 주지도 않고, 사용자가 누릴 수 있는 권한을 빼앗지도 않습니다. 모든 요청이 같은 검사를 거치고, 어시스턴트가 시작한 작업은 모두 앱의 작업 목록에 나타나며 그 작업을 제출한 어시스턴트가 표시됩니다.

다만 채널 자체를 지키는 보호 장치를 대신하지는 않습니다. 다른 계정이나 다른 컴퓨터가 아예 KwaFlux와 통신하지 못하게 막는 것은 그쪽의 역할입니다. 자세한 내용은 로컬 채널 보안에서 다룹니다.

마치며

유료 앱에 AI 인터페이스를 붙이는 일은 검사가 실제로 어디에 있는지 확인할 기회입니다. KwaFlux는 클릭과 도구 호출 모두에 대해 앱의 컨트롤 플레인에 검사를 하나만 두고, 유료 작업 전에 워커가 서명된 리스를 검증하게 하며, 작업을 재개하거나 재시도할 때마다 다시 검사합니다. 어시스턴트는 사용자와 똑같은 KwaFlux를 쓰게 됩니다.

앱에서도 어시스턴트에서도 똑같은 KwaFlux

KwaFlux의 로컬 MCP 서버를 쓰면 Codex, Claude, Cursor 등 MCP 앱이 사용자가 앱에서 시작할 수 있는 작업을 같은 규칙 아래에서 시작할 수 있습니다. AI 처리는 사용자 GPU에서 실행되며 미디어 파일이 처리를 위해 업로드되지 않습니다. Windows 10(64비트, 버전 1809 이상), Windows 11, Apple Silicon 탑재 macOS 12 이상에서 실행됩니다. 파일 가져오기와 앱 둘러보기에는 계정이 필요 없습니다. 내보내기, 변환, 파일 복구, 링크에서 파일 다운로드에만 로그인과 유료 플랜이 필요합니다.

KwaFlux 받기 · 플랜 보기