사용자 가이드 둘러보기

VS Code와 GitHub Copilot

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

업데이트 2026년 11월 16일

Markdown 보기
이 페이지의 내용

VS Code와 GitHub Copilot에서는 Shotomatic의 로컬 MCP 서버로 Shotomatic을 사용할 수 있습니다. 아래 단계는 VS Code와 GitHub Copilot 공식 문서(MCP configuration reference, 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 권한을 참고하세요.

VS Code와 GitHub Copilot에 Shotomatic 추가하기

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

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

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

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의 상태만 읽을 수 있습니다. 허용과 확인을 참고하세요.

동작 확인하기

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를 찾지 못합니다. 전체 클라이언트 문제 해결 목록을 참고하세요.

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

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