사용자 가이드 둘러보기

Claude Code

클릭 한 번이나 명령 한 줄로 Claude Code를 MCP로 Shotomatic에 연결하고, 동작을 확인하고, 자주 생기는 설정 문제를 해결합니다.

업데이트 2026년 11월 16일

Markdown 보기
이 페이지의 내용

Claude Code는 Shotomatic의 로컬 MCP 서버로 Mac이나 Windows PC의 Shotomatic을 사용할 수 있습니다. Shotomatic은 Claude Code로 테스트했습니다.

클릭 한 번으로 연결하기

  1. Shotomatic을 열고 설정 > AI 에이전트로 이동하세요(Command + ,, Windows에서는 Ctrl + ,).
  2. 에이전트 연결 아래 Claude 옆의 연결을 선택하세요.

Shotomatic이 사용자 범위로 claude mcp add를 대신 실행하므로 모든 프로젝트에서 Shotomatic을 쓸 수 있습니다. AI 에이전트의 Shotomatic 사용 허용도 켜고 Claude Code를 허용하므로 허용 카드가 나타나지 않습니다. 새 Claude Code 세션을 시작하면 서버를 불러옵니다.

Claude는 Claude Code나 Claude 앱이 설치되어 있으면 목록에 나타납니다. 연결을 한 번 누르면 컴퓨터에 있는 쪽을 모두 설정합니다.

직접 추가하기

명령줄을 선호한다면 설정 > AI 에이전트에서 AI 에이전트의 Shotomatic 사용 허용을 켜고, Node 18.3 이상을 설치한 뒤 다음을 실행하세요.

claude mcp add --scope user shotomatic -- npx -y shotomatic mcp

--scope user를 빼면 Claude Code는 현재 프로젝트에만 서버를 추가합니다. 이렇게 추가한 Claude Code가 처음 연결하면 Shotomatic이 허용 카드를 보여 줍니다. 허용을 선택하세요. 허용과 확인을 참고하세요.

동작 확인하기

터미널에서 claude mcp list를 실행하거나 세션에서 /mcp를 입력해 shotomatic이 있는지 확인하세요. 그런 다음 이렇게 요청하세요.

"Shotomatic 상태를 확인하고, 네가 Shotomatic으로 뭘 할 수 있는지 알려 줘."

제대로 설정됐다면 Shotomatic 버전, Mac의 화면 기록과 손쉬운 사용 권한 허용 여부, 플랜과 오늘 남은 무료 스크린샷, 웹사이트 브라우저 설치 여부, 이미 실행 중인 캡처를 알려 줍니다.

도구가 보이지 않을 때

  • /mcp에 shotomatic이 없습니다. 새 세션을 시작하세요. --scope user 없이 추가했다면 같은 프로젝트 폴더에서 Claude Code를 여세요.
  • 연결할 때 claude 명령 관련 오류가 나옵니다. 터미널에서 Claude Code를 한 번 열어 명령을 설치한 뒤 연결을 다시 선택하세요.
  • "MCP access is turned off." 설정 > AI 에이전트에서 AI 에이전트의 Shotomatic 사용 허용을 켠 다음 새 세션을 시작하세요.
  • 에이전트가 허용을 기다립니다. Shotomatic을 열고 카드에서 허용을 선택하세요.
  • npx를 찾지 못합니다. 직접 추가한 경우에만 해당합니다. 전체 클라이언트 문제 해결 목록을 참고하세요.

다음으로 에이전트가 할 수 있는 일의 요청을 써 보거나, 도구 레퍼런스에서 모든 도구를 확인하세요.

Claude Code | 사용자 가이드 | Shotomatic