사용자 가이드 둘러보기

에이전트 접근 방식

Claude, Codex 같은 AI 에이전트가 로컬 MCP 서버로 Shotomatic 앱을 쓰는 방식, 사용자가 정하는 범위, 시작할 곳을 안내합니다.

업데이트 2026년 11월 16일

Markdown 보기
이 페이지의 내용

Claude Code, Claude 앱, Codex 같은 AI 에이전트는 Mac이나 Windows PC의 Shotomatic을 사용할 수 있습니다. 에이전트는 사용자와 같은 기능, 즉 자동 캡처, Action Capture, 웹사이트 캡처, 캡처 기록, 문서, 내보내기를 씁니다. 원하는 결과를 말하면 에이전트가 단계를 정합니다.

요청이 Shotomatic에 전달되는 과정

에이전트는 Model Context Protocol, 곧 MCP로 연결합니다. Shotomatic의 MCP 서버는 로컬에서 동작합니다.

  1. 에이전트가 컴퓨터에서 작은 브리지를 실행합니다. 설정의 연결은 Shotomatic에 포함된 브리지를 등록하고, 다른 클라이언트는 npx -y shotomatic mcp로 shotomatic 패키지를 실행합니다.
  2. 브리지는 Mac에서는 소켓, Windows에서는 명명된 파이프라는 비공개 로컬 연결로 에이전트의 요청을 Shotomatic 앱에 전달합니다. Shotomatic이 실행 중이 아니면 브리지가 백그라운드에서 엽니다.
  3. Shotomatic이 캡처나 내보내기 같은 요청을 실행하고 결과를 에이전트에 돌려줍니다.

호스팅되는 Shotomatic 서버도, 로그인할 계정도, API 키도 없습니다. Shotomatic은 네트워크 포트를 열지 않으며, 내 사용자 계정만 연결할 수 있습니다. 에이전트가 본 이미지는 그 에이전트의 대화에 포함되며 에이전트 제공업체의 약관에 따라 처리됩니다.

사용자가 정하는 것

  • 접근 스위치: 설정 > AI 에이전트의 AI 에이전트의 Shotomatic 사용 허용은 기본적으로 꺼져 있습니다. 끄면 모든 에이전트의 연결이 끊깁니다.
  • 에이전트별 한 번의 허용: 설정에서 연결하지 않은 에이전트는 허용 카드에서 한 번 허용해야 합니다.
  • 확인: 에이전트가 무언가를 삭제하거나, 세션이 지워지도록 캡처 기록 한도를 낮추거나, 워크플로 일정을 정하기 전에 Shotomatic이 묻습니다.
  • 언제든 멈추기: 에이전트가 시작한 캡처에도 일반 캡처 도구 막대가 나타나고, 상태 줄의 연결 끊기로 모든 에이전트 연결을 끊을 수 있습니다.

에이전트는 사용자의 플랜과 macOS 권한을 그대로 씁니다. 한도와 안전을 참고하세요.

연결 방법 고르기

사용하는 에이전트연결 방법
Claude Code, Claude 앱, Codex설정의 연결, Node 필요 없음
Cursor, VS Code, Gemini CLI, Zed 등클라이언트별 명령이나 설정 항목

다음에 볼 페이지

에이전트 접근 방식 | 사용자 가이드 | Shotomatic