CAMU를 제안합니다 — 작은 프로그램에도 입구를 네 개 두는 구조
목차9

글: 강경미 · 김성박
2005년에 한 웹 디자이너가 글 한 편을 썼습니다. 이미 있던 기술 몇 가지를 엮어서 웹 화면을 새로 고치지 않고도 바뀌게 만드는 방법을 소개했는데요, 그 방법에 Ajax라는 이름을 붙였습니다. 기술 자체는 새롭지 않았지만, 이름이 생기자 사람들이 같은 그림을 보며 이야기하기 시작했습니다.
저희도 비슷한 제안을 하나 하려고 합니다. AI 에이전트와 함께 쓰는 프로그램을 만들 때, 아무리 작은 프로그램이라도 입구를 네 개 두자는 것입니다. 이 구조를 **CAMU(카뮤)**라고 부르기로 했습니다.
CAMU는 네 입구의 머리글자입니다
- C — CLI: 터미널에서 명령어로 부르는 입구입니다. 셸 스크립트, 예약 작업, 터미널을 쓸 수 있는 AI가 씁니다.
- A — API: 내 컴퓨터 안에서만 열리는 HTTP 입구입니다. 실행 중인 프로그램에 다른 프로그램이나 자동 테스트가 붙을 때 씁니다.
- M — MCP: Claude 같은 AI 에이전트가 도구로 바로 쓰는 입구입니다.
- U — UI: 사람이 보고 누르는 화면입니다.
글자 순서는 부르는 쪽을 기준으로 정했습니다. 셸, 프로그램, AI, 그리고 마지막이 사람입니다. 끝 글자 U는 저희 프로그램 이름 앞에 붙는 ur(Your)의 U와도 이어집니다.
기능은 명령 하나로 한 번만 만듭니다
입구가 네 개라고 해서 기능을 네 번 만드는 것은 아닙니다. CAMU에서 가장 중요한 약속은 이것입니다.
기능은 "명령" 하나로 한 번만 만들고, 네 입구는 모두 그 명령을 부른다.
예를 들어 그림을 돌리는 기능을 만든다면 image.rotate라는 명령을 하나 정의합니다. 명령에는 이름, 설명, 받는 값, 사용 예시를 적어 둡니다. 그러면 이 명령 목록 하나를 바탕으로 API와 CLI와 MCP가 함께 만들어지고, 화면의 버튼과 메뉴도 같은 명령을 부릅니다.

그래서 화면에서만 할 수 있는 기능이 생기지 않습니다. 사람이 화면에서 하는 일이라면 AI도, 스크립트도, 다른 프로그램도 똑같이 할 수 있습니다.
이 구조로 만들면 무엇이 좋아질까요
처음에는 작은 프로그램에 입구가 네 개나 필요할까 싶었습니다. 그런데 이 구조로 만들어 보니 쓰는 사람마다 얻는 것이 분명했습니다.

프로그램을 쓰는 사람
- 화면이 익숙하면 화면으로, 반복 작업은 명령어로 할 수 있습니다. 파일 300개에 같은 작업을 해야 할 때 화면에서 300번 누르지 않고 명령어 한 줄로 끝냅니다.
- 어떤 입구로 해도 결과가 똑같습니다. 화면에서 바꾼 설정과 명령어로 바꾼 설정이 같은 명령을 거치기 때문입니다.
- 화면을 쓰기 어려운 분께는 다른 길이 하나 더 생깁니다.
AI 에이전트
- 프로그램을 설치하는 순간 AI가 쓸 수 있는 도구가 됩니다. "이 사진들 모아서 PDF로 만들어 줘"라고 하면 AI가 프로그램의 명령을 직접 부릅니다.
- AI가 사람의 화면을 대신 클릭하는 방식이 아니라서 빠르고 정확합니다. 화면 위치가 바뀌어도 명령은 그대로입니다.
- 같은 작업을 수백 번 해야 할 때는 AI가 CLI로 짧은 스크립트를 짜서 한 번에 돌립니다. 대화를 수백 번 주고받지 않으니 시간도 토큰도 크게 아낄 수 있습니다.
프로그램을 만드는 사람
- 기능을 한 번만 만들면 됩니다. 문서와 입구는 명령 목록에서 자동으로 만들어집니다.
- 사람 손 없이 테스트할 수 있습니다. 자동 테스트가 API로 프로그램을 띄우고, 조작하고, 화면을 찍어서 확인합니다. 테스트를 통과하면 AI나 다른 프로그램이 써도 된다는 것까지 함께 확인됩니다.
- 기능이 화면 코드에 섞이지 않아서 구조가 깔끔해집니다. 나중에 화면을 통째로 바꿔도 기능은 그대로 남습니다.
프로그램끼리
- 여러 프로그램이 같은 방식으로 이어집니다. 런처인 UrBuddy가 다른 프로그램의 명령을 찾아 실행하고, 캡처한 화면을 편집 프로그램으로 바로 넘깁니다.
- 새 프로그램이 나와도 같은 구조라서 따로 맞출 것이 거의 없습니다.
입구마다 잘하는 일이 다릅니다
"MCP가 있으면 API는 필요 없지 않을까?" 저희도 처음에 이렇게 생각했습니다. 그런데 네 입구는 맡은 일이 서로 다릅니다.
MCP는 AI 프로그램이 직접 실행한 프로세스와만 이야기합니다. 이미 켜져 있는 프로그램에 붙거나, 프로그램끼리 일을 넘기거나, 자동 테스트를 돌리려면 HTTP API가 있어야 합니다. 그래서 MCP는 API를 대신하지 않고, API 위에서 AI의 말을 통역하는 역할을 맡습니다.
CLI와 MCP도 마찬가지입니다. Claude Desktop처럼 터미널이 없는 AI에게는 MCP가 편하고, 터미널이 있는 AI가 같은 일을 여러 번 할 때는 CLI가 낫습니다. 어느 하나로 다른 것을 대신하지 않습니다.
CAMU는 구체적인 규칙입니다
CAMU는 이름만 붙인 아이디어가 아닙니다. 저희가 프로그램을 만들 때마다 똑같이 지키는 규칙이 있고, 그 규칙을 지키는지 자동 테스트로 확인합니다. 핵심만 소개하겠습니다.
내 컴퓨터 안에서만 열립니다
AI가 프로그램을 조작할 수 있다는 말을 들으면 "밖에서 누가 내 프로그램을 건드리면 어떡하지?" 하는 걱정이 먼저 들잖아요. 그래서 API는 이렇게 엽니다.
- API는
127.0.0.1, 즉 내 컴퓨터 안에서만 들을 수 있게 엽니다. 같은 와이파이에 있는 다른 컴퓨터도 들어올 수 없습니다. - 포트는 실행할 때마다 비어 있는 번호를 새로 받습니다.
- 웹 페이지에서 보낸 요청은 거절합니다. 요청에
Origin머리가 붙어 있으면 웹 페이지에서 온 것으로 보고 막습니다. 주소 이름을 바꿔치기하는 공격을 막으려고Host값도 확인합니다.
실행할 때마다 새 열쇠를 만듭니다
내 컴퓨터 안이라고 아무나 부를 수 있으면 안 되겠죠. 그래서 열쇠(토큰)를 씁니다.
- 프로그램이 켜질 때마다 무작위 열쇠를 새로 만듭니다(32바이트). 한 번 쓴 열쇠는 다시 쓰지 않습니다.
- 열쇠는 내 계정만 읽을 수 있는 파일
api.json에 적어 둡니다. 맥이라면~/Library/Application Support/<프로그램>/api.json이고, 파일 권한은 나만 읽고 쓸 수 있게(0600) 합니다. - 이 파일은 API가 요청을 받을 준비를 마친 뒤에 씁니다. 반쯤 쓴 파일을 누가 읽는 일이 없도록 임시 파일에 다 쓴 다음 이름을 바꿉니다. 프로그램이 끝나면 지웁니다.
- 모든 요청에는
Authorization: Bearer <열쇠>가 붙어야 합니다. 열쇠가 틀리면 이유를 알려 주지 않고 거절합니다.
{ "app": "urzip", "version": "0.1.2", "apiVersion": 1, "pid": 41237, "url": "http://127.0.0.1:52814", "token": "실행할 때마다 새로 만든 값", "startedAt": "2026-11-17T23:40:12+09:00" }
여기서 중요한 점이 하나 있습니다. AI는 이 열쇠를 직접 보지 않습니다. CLI와 MCP가 이 파일을 읽어 요청에 열쇠를 붙여 주기 때문에, 열쇠 값이 AI와의 대화나 출력, 로그에 남지 않습니다.
물론 이 방법으로 모든 것을 막을 수는 없습니다. 내 계정으로 이미 실행 중인 악성 프로그램은 이 파일을 읽을 수 있습니다. 막을 수 있는 것과 없는 것을 프로그램 설명서에 솔직하게 적어 둡니다.
위험한 명령은 한 번 더 확인합니다
- 파일 지우기나 덮어쓰기, 밖으로 보내기, 다른 프로그램에 입력 보내기처럼 되돌리기 어려운 명령에는 위험 표시가 붙습니다.
- 위험 표시가 붙은 명령은 "확인했다"는 값(
confirm: true)이 없으면 실행하지 않습니다. CLI에서는--yes를 붙여야 하고, MCP에서는 위험한 명령만 따로 부르는 도구를 써서 AI 프로그램이 사람에게 먼저 물어보게 합니다. - AI가 프로그램을 조작하는 중이면 화면에 작게 표시가 뜹니다. 누가 언제 무엇을 불렀는지는 로그 파일에 한 줄씩 남습니다.
어느 프로그램이든 같은 말로 대답합니다
AI 입장에서 가장 반가운 부분은 아마 이것일 거예요. 프로그램이 달라도 묻고 답하는 방식이 똑같습니다.
- 명령 목록은
GET /v1/commands, 실행은POST /v1/commands/<명령>입니다. 명령 목록에는 이름, 설명, 받는 값의 형식, 예시, 위험 여부가 들어 있습니다. - 대답은 언제나
{ "ok": true, "result": … }아니면{ "ok": false, "error": { "code", "message", "hint" } }모양입니다. 오류 코드도not-found,bad-args,busy처럼 모든 프로그램이 같은 이름을 씁니다. - 명령 이름은
대상.동작꼴입니다(image.rotate,capture.region). 이름만 봐도 무엇을 하는지 알 수 있습니다. - 모든 프로그램에 기본 명령이 있습니다. 프로그램 정보(
app.info), 끝내기(app.quit), 자기 창 찍기(app.screenshot), 설정 읽기·바꾸기(settings.get·settings.set), 그리고 네 입구를 안내하는app.interfaces입니다. - 오래 걸리는 일은 작업 번호를 먼저 받고 나중에 결과를 확인할 수 있습니다. 파일은 내용을 통째로 주고받지 않고 경로로 주고받습니다.
CLI도 약속을 지킵니다
- 모든 명령을
<프로그램> <명령> 이름=값꼴로 부릅니다. 나중에는ur <프로그램> <명령>하나로 모든 프로그램을 부를 수 있게 문법을 맞춰 두었습니다. - 프로그램이 켜져 있으면 켜진 프로그램에 붙고, 꺼져 있으면 창 없이 띄워서 처리합니다. 프로그램 없이 할 수 있는 일은 바로 처리합니다.
--json을 붙이면 API와 같은 모양으로 답합니다. 결과는 표준 출력에만, 진행 상황은 오류 출력에 따로 내보내서 스크립트에 그대로 이어 쓸 수 있습니다.- 끝날 때 돌려주는 숫자도 모든 프로그램이 같습니다. 0은 성공, 1은 실패, 2는 사용법 오류, 3은 일부 성공, 4는 프로그램에 연결할 수 없음, 5는 확인이 필요해서 거부, 6은 시간 초과입니다. 스크립트가 이 숫자만 보고 다음 일을 정할 수 있습니다.
--version은 0.05초 안에 답해야 합니다. 스크립트에서 자주 부르는 도구가 무거우면 안 되니까요.
MCP는 입구 하나로 모든 프로그램을 엽니다
- 프로그램마다 MCP를 따로 연결하지 않습니다. 입구 하나를 연결하면 설치된 프로그램을 모두 쓸 수 있습니다.
- AI에게 처음부터 명령 수백 개를 보여 주지 않습니다. "프로그램 목록 보기", "명령 찾기", "실행하기" 같은 도구 일곱 개만 먼저 주고, AI가 필요한 것을 찾아 들어가게 합니다. 처음 연결할 때 드는 토큰이 1,500개쯤으로 줄어듭니다.
- 결과가 너무 크면 잘라서 주고 나머지는 파일 경로로 알려 줍니다.
설치하면 스스로 자기를 소개합니다
- 프로그램을 설치하면 자기 소개 파일을 정해진 폴더에 놓아 둡니다. MCP 입구와 런처는 이 폴더만 읽어서 어떤 프로그램이 설치되어 있는지 압니다. 따로 등록하는 서버가 없습니다.
- 명령마다 한국어·영어 설명, 받는 값 설명, 예시를 반드시 적습니다. 사람이 읽는 안내서도 함께 넣어 두면 AI가 필요할 때 꺼내 읽습니다.
- 명령 목록 파일과 API 문서는 코드에서 자동으로 만듭니다. 사람이 손으로 고치지 않으니 코드와 문서가 어긋나지 않습니다.
규칙을 지키는지 시험으로 확인합니다
- 모든 프로그램은 테스트용 실행 옵션을 갖습니다. 창 없이 띄우기(
--headless), 포트 고정(--api-port), 내 설정과 분리된 폴더 쓰기(--profile-dir)입니다. 테스트가 내 실제 설정을 건드리지 않습니다. - 공통 시험이 있어서 프로그램마다 같은 항목을 확인합니다. 열쇠 없이 부르면 막히는지, 웹 페이지에서 온 요청을 막는지, 대답 모양이 맞는지, 네 입구의 안내가 같은지, 어디에도 열쇠 값이 드러나지 않는지 같은 것들입니다.
- 명령을 더하는 것은 자유롭지만, 이미 있는 명령의 이름이나 뜻을 바꿀 때는 판 번호(
/v2)를 올립니다. 어제 만든 스크립트가 오늘 갑자기 깨지지 않게 하려는 것입니다.
어느 입구로 들어와도 나머지를 알려 줍니다
입구가 네 개 있어도 쓰는 사람이 모르면 소용이 없잖아요. 그래서 어느 입구로 들어와도 나머지 세 입구를 안내받게 했습니다.
- MCP로 들어온 AI에게는 처음에 두세 줄만 알려 줍니다. "같은 일을 CLI로도 할 수 있고, 반복 작업은 CLI로 하면 토큰을 아낄 수 있다." 자세한 내용은 AI가 필요할 때 찾아봅니다. 처음부터 전부 알려 주면 대화할 때마다 토큰을 쓰니까요.
- API에는 도움말 주소를 하나 둡니다.
- CLI는
--help끝에 다른 입구를 쓰는 방법을 몇 줄 붙입니다. - 화면에서는 도움말 메뉴에서 같은 내용을 봅니다.
네 곳의 안내는 사람이 따로 쓰지 않고 명령 목록에서 자동으로 만듭니다. 손으로 따로 쓰면 금방 서로 어긋나거든요.
도움말 메뉴에서 Claude와 연결하고 끊습니다
설정 파일을 직접 열지 않아도 되도록, 프로그램의 도움말 메뉴에 이런 항목을 둡니다.
- Claude Code에 MCP 연결 / Claude Code MCP 연결 끊기
- Claude Desktop에 MCP 연결 / Claude Desktop MCP 연결 끊기
연결한 뒤에 꼭 알아 두실 점이 있습니다. Claude Code는 연결한 다음에 새로 시작한 세션부터 인식합니다. 이미 열려 있는 세션에서는 보이지 않으니 새 세션을 열어 주세요. Claude Desktop은 창만 닫아서는 안 되고, 완전히 종료했다가 다시 열어야 적용됩니다. 그래서 연결하고 나면 이 안내가 꼭 뜨게 했습니다.
함께 정한 세부 원칙
- 이름: CAMU(카뮤)로 정했습니다. 영어 단어가 아니고, 소프트웨어 구조를 가리키는 말로 쓰이는 곳이 없다는 것도 확인했습니다.
- 글자 순서: C·A·M·U입니다. 처음 떠올린 UI·MCP·API·CLI 순서로 쓰면 UMAC이 되는데, 이미 암호 기술에서 쓰는 용어라 피했습니다.
- 안내 명령: 네 입구를 안내하는 명령
app.interfaces를 모든 프로그램에 기본으로 둡니다. 네 입구 어디서든 부를 수 있습니다. - 접속 열쇠: API에 접속하는 열쇠(토큰)는 안내에 절대 넣지 않습니다. 쓰는 방법만 알려 줍니다. API 도움말을 볼 때도 열쇠가 필요하고, 열쇠 없이 열리는 곳은 기본 주소 하나뿐입니다.
- 프로그램이 꺼져 있을 때: 프로그램을 띄우지 않고, 설치할 때 함께 놓아 둔 명령 목록 파일만 읽어서 안내합니다.
- MCP 첫 안내: CLI 안내 두세 줄만 더하고, 첫 안내의 전체 길이 한도는 그대로 지킵니다.
- 자체 MCP가 있는 프로그램: 그대로 둡니다. 다만 도움말 메뉴에서 기본으로 연결하는 것은 모든 프로그램이 함께 쓰는 입구 하나입니다. 한 번 연결하면 설치된 프로그램을 모두 쓸 수 있고, 끊을 때는 함께 빠지는 프로그램 목록을 먼저 보여 줍니다.
- 도움말 메뉴: 연결·끊기 항목 옆에 "AI·자동화로 쓰기"를 두어, 같은 안내를 화면에서도 보게 합니다.
- 지키는지 확인: 네 입구에서 같은 안내가 나오는지, 어디에도 열쇠 값이 드러나지 않는지 자동 테스트로 확인합니다.
작은 프로그램부터 해 보세요
CAMU에서 지킬 것은 결국 한 가지입니다. 기능을 화면에 먼저 붙이지 말고, 명령으로 먼저 만든다. 이것만 지키면 나머지 입구는 같은 명령 위에 자연스럽게 열립니다.
AI와 함께 일하는 프로그램을 만들고 계시다면, 작은 프로그램부터 입구를 네 개 두어 보시길 제안합니다.
댓글
댓글을 작성하려면 이 필요합니다.