# Claude Code | 사용자 가이드 | Shotomatic

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

- 유형: 공개 웹페이지
- 정식 페이지: [https://www.shotomatic.com/ko/guide/ai-agents/clients/claude-code](https://www.shotomatic.com/ko/guide/ai-agents/clients/claude-code)
- Markdown 페이지: [https://www.shotomatic.com/ko/guide/ai-agents/clients/claude-code.md](https://www.shotomatic.com/ko/guide/ai-agents/clients/claude-code.md)

사용자 가이드 둘러보기

이 페이지의 내용

1.  [클릭 한 번으로 연결하기](#클릭-한-번으로-연결하기)
2.  [직접 추가하기](#직접-추가하기)
3.  [동작 확인하기](#동작-확인하기)
4.  [도구가 보이지 않을 때](#도구가-보이지-않을-때)

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 이상을 설치한 뒤 다음을 실행하세요.

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

`--scope user`를 빼면 Claude Code는 현재 프로젝트에만 서버를 추가합니다. 이렇게 추가한 Claude Code가 처음 연결하면 Shotomatic이 허용 카드를 보여 줍니다. **허용**을 선택하세요. [허용과 확인](https://www.shotomatic.com/ko/guide/ai-agents/approvals-and-confirmations)을 참고하세요.

## 동작 확인하기

터미널에서 `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`를 찾지 못합니다.** 직접 추가한 경우에만 해당합니다. [전체 클라이언트 문제 해결 목록](https://www.shotomatic.com/ko/guide/ai-agents/other-agents#%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0)을 참고하세요.

다음으로 [에이전트가 할 수 있는 일](https://www.shotomatic.com/ko/guide/ai-agents/what-agents-can-do)의 요청을 써 보거나, [도구 레퍼런스](https://www.shotomatic.com/ko/guide/ai-agents/tools)에서 모든 도구를 확인하세요.

## 이 페이지의 내용

1.  [클릭 한 번으로 연결하기](#클릭-한-번으로-연결하기)
2.  [직접 추가하기](#직접-추가하기)
3.  [동작 확인하기](#동작-확인하기)
4.  [도구가 보이지 않을 때](#도구가-보이지-않을-때)

## 이 버전 안내

이 Markdown 페이지는 서버에서 렌더링한 Shotomatic 공개 페이지를 바탕으로 생성됩니다. 조작 요소와 사이트 탐색 메뉴는 제외됩니다. 인용하거나 공유할 때는 정식 페이지를 이용해 주세요.
