# VS Code와 GitHub Copilot | 사용자 가이드 | Shotomatic

> VS Code와 GitHub Copilot에 Shotomatic을 로컬 MCP 서버로 추가하고, 동작을 확인하고, 자주 생기는 설정 문제를 해결합니다.

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

사용자 가이드 둘러보기

이 페이지의 내용

1.  [시작하기 전에](#시작하기-전에)
2.  [VS Code와 GitHub Copilot에 Shotomatic 추가하기](#vs-code와-github-copilot에-shotomatic-추가하기)
3.  [한 번 허용하기](#한-번-허용하기)
4.  [동작 확인하기](#동작-확인하기)
5.  [도구가 보이지 않을 때](#도구가-보이지-않을-때)

VS Code와 GitHub Copilot에서는 Shotomatic의 로컬 MCP 서버로 Shotomatic을 사용할 수 있습니다. 아래 단계는 VS Code와 GitHub Copilot 공식 문서([MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration), [Manage MCP servers](https://code.visualstudio.com/docs/agents/run/manage-mcp-servers))를 따랐습니다. Shotomatic은 Claude Code와 Codex로 테스트했으며 VS Code와 GitHub Copilot에서는 테스트하지 않았습니다. 메뉴나 파일이 더 이상 맞지 않으면 VS Code와 GitHub Copilot 문서를 확인하세요.

## 시작하기 전에

-   Shotomatic에서 **설정 > AI 에이전트**를 열고 **AI 에이전트의 Shotomatic 사용 허용**을 켜세요.
-   Node 18.3 이상을 설치하세요. 클라이언트가 `shotomatic`이라는 작은 브리지 패키지를 `npx`로 실행합니다. API 키는 없습니다.
-   Mac에서는 **화면 기록**과, 키 입력이 필요하면 **손쉬운 사용**을 허용하세요. [macOS 권한](https://www.shotomatic.com/ko/guide/get-started/macos-permissions)을 참고하세요.

## VS Code와 GitHub Copilot에 Shotomatic 추가하기

VS Code는 `mcpServers`가 아니라 `servers`를 쓰며 `type`이 필요합니다. 작업 공간의 `.vscode/mcp.json`에 다음을 추가하세요.

```json
{
  "servers": {
    "shotomatic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}
```

사용자 프로필에 추가하려면 대신 다음을 실행하세요.

```sh
code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'
```

VS Code는 서버를 처음 시작할 때 신뢰할지 물을 수 있습니다.

Windows에서 클라이언트가 `npx`를 실행하지 못하면 명령을 `cmd`로, 인수를 `/c`, `npx`, `-y`, `shotomatic`, `mcp`로 지정하세요.

## 한 번 허용하기

VS Code와 GitHub Copilot에서 처음 연결하면 Shotomatic이 클라이언트가 알려 준 이름으로 허용 카드를 보여 줍니다. **허용**을 선택하세요. 허용하기 전에는 에이전트가 Shotomatic의 상태만 읽을 수 있습니다. [허용과 확인](https://www.shotomatic.com/ko/guide/ai-agents/approvals-and-confirmations)을 참고하세요.

## 동작 확인하기

Command Palette에서 **MCP: List Servers**를 실행하면 서버를 확인하고 시작하거나 다시 시작할 수 있습니다. 그런 다음 이렇게 요청하세요.

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

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

Shotomatic은 미리 보기를 도구 결과 안의 이미지로 돌려줍니다. VS Code와 GitHub Copilot 문서에는 이 이미지가 모델에 전달되는지 나와 있지 않아서, 에이전트가 텍스트만 받을 수도 있습니다.

## 도구가 보이지 않을 때

-   **서버가 무시됩니다.** 항목이 `servers` 아래에 있고 `"type": "stdio"`가 있는지 확인하세요.
-   **"MCP access is turned off."** **설정 > AI 에이전트**에서 **AI 에이전트의 Shotomatic 사용 허용**을 켠 다음 클라이언트를 다시 시작하세요.
-   **허용 카드가 나타나지 않습니다.** Shotomatic을 열어 카드를 찾아보세요. Mac에서는 카드가 나타나면 Dock 아이콘이 튕깁니다.
-   **클라이언트가 `npx`나 Node를 찾지 못합니다.** [전체 클라이언트 문제 해결 목록](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.  [VS Code와 GitHub Copilot에 Shotomatic 추가하기](#vs-code와-github-copilot에-shotomatic-추가하기)
3.  [한 번 허용하기](#한-번-허용하기)
4.  [동작 확인하기](#동작-확인하기)
5.  [도구가 보이지 않을 때](#도구가-보이지-않을-때)

## 이 버전 안내

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