Mac AI 에이전트 제어, 들어오는 문은 셋, 안은 하나.
Coco는 단축키로 여는 그 런처입니다. 동시에 AI 에이전트가 Mac을 조작하도록 열어 둔 층이기도 합니다. CLI, MCP 서버, Agent Skill 세 가지 모두 같은 71개 메서드에 연결됩니다.
Mac에서 AI 에이전트 제어가 가리키는 것
대부분의 Mac 앱에는 에이전트가 두드릴 문이 없습니다. 터미널에서 돌아가는 AI 코딩 어시스턴트는 파일을 읽고 쓰고 셸 명령을 실행할 수 있습니다. 하지만 사람처럼 이름으로 앱을 열지는 못합니다. 클립보드 기록을 읽거나 스크린샷을 찍어 파일 경로를 돌려받거나 설정을 바꿔 재시작 없이 바로 적용시키는 것도 못합니다. Coco의 에이전트 층이 메우는 것이 이 틈입니다. 새 앱이 아닙니다. Coco 자신의 런처, 클립보드 관리, 스크린샷 도구, 실시간 자막, 계산기, 플러그인 런타임, Raycast 호환 스토어를 로컬 소켓 뒤에 열어 둔 것입니다. CLI와 MCP 서버가 같은 소켓에 말을 겁니다.
구조는 area.method 형태의 메서드 모음 하나입니다. Coco가 할 수 있는 모든 것을 모아 둔 목록입니다. Coco 런처 패널이 단축키를 누를 때 부르는 것과 같은 목록입니다. apps.search, clipboard.list, screenshot.capture, settings.set을 비롯한 60여 개의 메서드가 모두 한 번씩만 정의되고 각자 스키마를 가집니다. 명령줄 coco, AI 에이전트가 stdio로 붙는 coco mcp 서버, 둘 다 쓰는 법을 알려 주는 Agent Skill, 이 세 통로가 모두 같은 메서드 모음을 읽습니다. 구현이 둘로 갈라지지 않으니 어느 한 곳에서만 메서드가 빠지는 일이 없습니다.
로컬 소켓은 Coco 자신이 서명한 프로세스만 받아들입니다. Mac 위의 아무 스크립트나 CLI인 척할 수 없습니다. 이 경계 안에서 Coco의 AI 에이전트 제어는 기본값이 전체 허용입니다. Coco를 설치하고 에이전트를 연결하면 위의 메서드가 바로 쓸 수 있습니다. 호출마다 확인 대화상자가 뜨지 않습니다. AI API 키, 음성 인식 키, 라이선스 캐시, Keychain 관련 항목만 거부 목록에 따로 올라 있고, 이 검사가 가장 먼저 돕니다. 에이전트 접근을 통째로 끄거나 개별 메서드만 막는 것도 설정에서 언제든 할 수 있습니다.
Coco를 통해 AI 에이전트가 부를 수 있는 71개 메서드
앱 검색, 열기, 앞으로 가져오기, 숨기기, 종료
에이전트는 런처 자신이 쓰는 것과 같은, 병음과 로마자와 한글 초성을 아는 색인으로 앱을 이름으로 찾습니다. 그다음 맞는 것을 열거나 앞으로 가져오거나 숨기거나 종료할 수 있습니다. Xcode를 열고 앞으로 가져와 달라고 하면, 패널에서 직접 칠 때와 같은 메서드가 호출됩니다.
클립보드 목록, 검색, 붙여넣기
클립보드 관련 메서드는 최근 항목을 나열하고, 검색하고, id로 하나를 가져올 수 있습니다. 새 텍스트나 이미지를 클립보드에 쓰고, 맨 앞 앱에 붙여넣고, 항목을 즐겨찾기에 넣거나 지울 수도 있습니다. 비밀번호 관리자에서 온 항목은 검색어가 무엇이든 어떤 호출에서도 돌아오지 않습니다.
스크린샷을 찍고 파일 경로를 돌려받기
screenshot.capture는 전체 화면, 창 하나, 또는 영역을 찍습니다. 에이전트에게는 읽거나 메시지에 붙이거나 다음 도구에 넘길 수 있는 PNG 경로가 돌아갑니다. 이것은 에이전트를 위해 새로 만든 입구입니다. 패널에서 직접 시작하는 대화형 캡처와는 별개입니다.
실시간 자막을 켜고 받아쓴 내용을 다시 읽기
에이전트는 실시간 자막 세션을 시작하거나 멈출 수 있고, 상태를 확인할 수 있습니다. 저장된 받아쓰기를 나열하거나 읽을 수도 있습니다. 통화에 자막을 달고 나중에 받아쓴 내용을 달라고 하면, captions.start, captions.status, transcripts.read를 차례로 부르는 것입니다.
계산기, 단위 환산, 환율, 이모지 검색
calc.eval, units.convert, currency.convert, emoji.search는 Coco 내장 도구를 움직이는 것과 같은 순수 함수입니다. 에이전트는 대화를 벗어나 계산기를 열지 않고도 단위 환산을 끝내거나 딱 맞는 이모지를 찾을 수 있습니다.
설치된 플러그인이나 Raycast 확장 실행
plugins.list와 plugins.commands가 무엇이 설치돼 있는지 알려 줍니다. plugins.run이 명령을 실행합니다. raycast.list, raycast.run, raycast.session은 Raycast 호환 확장을 같은 방식으로 다룹니다. Coco를 움직이는 에이전트는 Coco 자체 기능뿐 아니라 당신이 추가한 모든 플러그인에 손이 닿습니다.
Coco 스토어를 둘러보고 설치하고 업데이트
store.list와 store.search는 카탈로그를 읽습니다. store.install, store.uninstall, store.update는 Mac에 무엇이 있는지 관리합니다. 에이전트는 어떤 플러그인이 스토어에 있는지 먼저 확인하고, 더 긴 작업의 일부로 그대로 설치할 수 있습니다. 손으로 해 달라고 멈춰 물을 필요가 없습니다.
모든 설정을 읽고 바꾸고, 그 자리에서 적용
settings.list, settings.get, settings.schema, settings.set, settings.patch는 Coco 설정의 모든 키를 다룹니다. 에이전트가 바꾼 설정은 바로 적용됩니다. 설정 창에서 직접 바꿨을 때와 같은 동작이고, 그 사이에 재시작이 끼어들지 않습니다.
Coco, Raycast, Alfred의 AI 에이전트 제어를 나란히 놓고 보기
Raycast와 Alfred 모두 에이전트가 손을 뻗고 싶어할 만한 런처입니다. 하지만 둘 다 제어면을 만들지는 않았습니다. Raycast는 MCP를 들였는데, 어느 방향인지 짚어 둘 필요가 있습니다. Raycast는 MCP 클라이언트로 동작합니다. 자기 안에서 다른 MCP 서버를 부를 수 있다는 뜻이고, 방향이 반대입니다. Claude Code나 Cursor나 ChatGPT가 거꾸로 Raycast를 불러 앱을 열게 하거나 클립보드 항목을 읽게 하는 경로는 없습니다.
Alfred는 워크플로를 실행시키는 URL 스킴을 열어 두고 있습니다. 이 경로에는 인증이 없습니다. URL을 열 수 있는 Mac 위의 무엇이든 Alfred 동작을 일으킬 수 있습니다. 문은 하나 있는 셈이지만 에이전트를 위해 만든 제어면이 아닙니다. Coco의 소켓을 지키는 것 같은 프로세스 서명 검증도 없습니다. 셋 중 CLI와 MCP 서버와 Agent Skill을 모두 갖추고 외부 에이전트가 직접 연결할 수 있는 것은 Coco뿐입니다.
| Coco | Raycast | Alfred | |
|---|---|---|---|
| 외부 에이전트가 부를 수 있는 CLI | |||
| 에이전트가 연결하는 MCP 서버 | 클라이언트만 | ||
| Claude Code / Codex용 Agent Skill | |||
| 에이전트가 바꾼 설정이 즉시 적용 | |||
| 키와 라이선스 파일은 에이전트에게 보이지 않음 | 해당 없음 | 해당 없음 | |
| 제어 채널에 프로세스 서명 검증이 있음 | 해당 없음 | 인증 없음 |
Mac에서 AI 에이전트 제어 설정하기
Coco와 CLI 설치하기
Coco를 응용 프로그램 폴더에 넣고 한 번 엽니다. 그다음 터미널에서 coco cli install을 실행합니다. Contents Helpers coco에 있는 바이너리가 PATH에 연결됩니다. 어떤 셸에서도 coco를 바로 쓸 수 있습니다.
AI 에이전트 연결하기
Claude Code, Claude Desktop, Cursor, Codex라면 coco mcp install --client claude-code를 실행합니다. claude-code 부분은 쓰고 있는 클라이언트로 바꿉니다. 설치 옵션이 따로 없는 ChatGPT 같은 에이전트에는 coco skill install에서 설정용 프롬프트를 복사합니다. npx skills add butterflydream-ai/Coco --skill coco -g -y를 실행해도 됩니다.
Mac을 조작해 달라고 부탁하기
연결되면 클립보드를 검색시키거나, 앱을 열게 하거나, 스크린샷을 찍게 해 보세요. 플러그인을 실행시키거나 설정을 바꾸게 할 수도 있습니다. 부르는 것은 71개 메서드 중 하나입니다. 호출과 결과는 에이전트 자신의 도구 사용 로그에서도 확인할 수 있습니다.
Mac AI 에이전트 제어에 대해 자주 묻는 것
- AI 에이전트가 Coco를 통해 제 Mac을 조작해도 안전한가요
- 제어 채널은 Coco 자신이 서명한 프로세스만 받아들입니다. 요청에 답하기 전에 운영체제 수준의 코드 서명 검증이 먼저 돕니다. 스크립트가 CLI나 MCP 서버인 척할 수 없습니다. AI API 키, 음성 인식 키, 라이선스 캐시, Keychain 관련 항목을 포함한 거부 목록은 가장 먼저 검사됩니다. 동의 로직이나 라우팅 로직보다 앞서 평가되므로, 정당한 호출이라도 이 파일들에는 닿지 않습니다. Coco는 설치 후 기본값이 전체 허용이라 호출마다 확인창이 뜨지는 않습니다. 하지만 설정에서 언제든 에이전트 접근을 통째로 끄거나 clipboard.delete 같은 개별 메서드만 막을 수 있습니다. 비밀번호 관리자에서 온 클립보드 항목도 검색어와 무관하게 모든 호출 결과에서 빠집니다.
- 어떤 AI 도구가 Coco의 에이전트 층과 함께 동작하나요
- MCP를 지원하는 것이라면 coco mcp를 통해 연결됩니다. Claude Code, Claude Desktop, Cursor, Codex, Windsurf, GitHub Copilot을 넣은 VS Code, MCP를 지원하는 Gemini와 Grok 클라이언트가 포함됩니다. coco mcp install --client 뒤에 클라이언트 이름을 붙여 실행하면, Claude Code, Claude Desktop, Cursor, Codex용 연결 설정이 자동으로 써집니다. 로컬에서 MCP 서버를 돌리지 않는 ChatGPT나 Perplexity 같은 에이전트도 CLI를 바로 쓸 수 있습니다. Agent Skill을 설치하거나 설정용 프롬프트를 복사해 건네 보세요. 그 에이전트는 자신의 셸 권한으로 coco 명령을 실행합니다. Mac에서 셸 접근이 있는 AI 에이전트라면 MCP를 거치든 명령줄을 거치든 같은 71개 메서드에 손이 닿습니다.
- AI 에이전트 제어를 쓰는 데 추가 요금이 붙나요
- 붙지 않습니다. Coco는 한 번 사면 끝입니다. 지금은 선착순 가격 49달러, 이후에는 99달러이며 구독은 없습니다. CLI, MCP 서버, Agent Skill, 71개 메서드 모두 같은 구매에 포함되어 있습니다. 따로 나뉜 에이전트 요금제나 추가 라이선스, 호출 건당 과금은 없습니다. 이미 Coco를 갖고 있다면 에이전트 층이 들어간 버전으로 업데이트하는 것으로 충분합니다. CLI는 같은 앱 번들 안의 Contents Helpers coco에 들어 있고 따로 내려받는 것이 아닙니다.
- AI 에이전트 제어를 막거나 끌 수 있나요
- 됩니다. 방법은 두 가지입니다. 설정의 에이전트 접근에 있는 메인 스위치를 끄면 제어 채널 전체가 멈춥니다. 로컬 소켓이 닫혀서 어떤 CLI나 MCP 연결도 Coco에 닿지 않습니다. 통째로 끄고 싶지 않다면 같은 화면에서 모든 메서드가 이름별로 나열되어 있습니다. 개별로 막을 수 있어서, apps.search와 clipboard.list는 허용해 두고 clipboard.delete와 settings.set만 막는 식도 가능합니다. 두 변경 모두 이미 연결된 에이전트에게 바로 적용됩니다. 거부 목록의 키 파일은 어느 스위치가 켜져 있든 닿지 않습니다.
이 프롬프트를 복사하거나, 이미 쓰고 있는 AI로 바로 보내세요 — 당신이 직접 입력할 것과 같은 명령으로 Coco를 움직입니다.
Coco 스킬을 설치하고(npx skills add butterflydream-ai/Coco --skill coco -g -y), coco로 Mac AI 에이전트 제어, 들어오는 문은 셋, 안은 하나. 관련해서 저를 도와주세요.