MCP(Model Context Protocol)

**MCP(Model Context Protocol)**는 Claude, Codex, Cursor 같은 AI 앱이 MCP 서버라는 작은 프로그램으로 외부 도구와 데이터에 연결하도록 해 주는 개방형 표준입니다.

MCP란

공통 프로토콜이 없으면 도구 하나를 AI 앱마다 따로 만들어야 합니다. MCP를 쓰면 도구 개발자가 MCP 서버를 하나 만들고, MCP를 지원하는 클라이언트라면 어디서든 그 서버를 쓸 수 있습니다.

구성은 두 쪽입니다.

  • 클라이언트: 사용자가 대화하는 AI 앱입니다. Claude Code, Claude 앱, Codex, Cursor, GitHub Copilot을 쓰는 VS Code 등이 있습니다. 서버에 연결하고 서버의 도구를 모델에 보여 줍니다.
  • 서버: 도구(모델이 호출하는 동작), 리소스(읽을 수 있는 데이터), 프롬프트(미리 만든 지시문)를 제공하는 프로그램입니다. 메시지는 JSON-RPC 형식입니다.

모델이 서버에서 코드를 직접 실행하지는 않습니다. 모델은 클라이언트에 이름이 붙은 도구를 인수와 함께 호출해 달라고 요청하고, 서버는 텍스트, 이미지, 구조화된 데이터를 돌려줍니다.

MCP를 쓰는 곳

  • 코딩 에이전트: 코드를 쓰면서 이슈 트래커를 읽거나, 데이터베이스를 조회하거나, 브라우저를 엽니다.
  • 데스크톱 어시스턴트: 로컬 파일, 캘린더, 메모에 접근합니다.
  • 스크린샷과 화면 확인: 서버가 창, 화면, 웹 페이지를 캡처해 이미지를 돌려주면, 에이전트는 짐작하지 않고 결과를 직접 볼 수 있습니다.
  • 반복 작업: 에이전트가 긴 캡처나 내보내기를 시작하고 진행 상황을 확인한 뒤, 끝나면 결과를 알려 줍니다.

서버가 연결되는 방식

사양은 두 가지 표준 전송 방식을 정의합니다.

stdio는 로컬 방식입니다. 클라이언트가 서버를 하위 프로세스로 실행하고 표준 입력과 표준 출력으로 통신합니다. 보통 클라이언트 설정에 npx -y some-server 같은 명령을 넣으면 되고, 서버가 따로 보내지 않는 한 데이터가 컴퓨터 밖으로 나가지 않습니다. 데스크톱 앱은 이미 실행 중인 앱과 통신하는 작은 stdio 브리지를 쓰는 경우가 많습니다.

Streamable HTTP는 원격 방식입니다. 서버가 별도 프로세스로 실행되고, 대개 업체가 호스팅하며, 클라이언트가 URL로 연결합니다. 원격 서버는 보통 OAuth 로그인이나 API 키 입력을 요구합니다.

서버를 추가하면 클라이언트가 그 서버의 도구 목록을 보여 줍니다. 많은 클라이언트가 기본적으로 도구를 호출할 때마다 승인을 묻습니다. 에이전트가 무언가를 삭제하기 전에 자기 창에서 한 번 더 묻는 서버도 있습니다.

자주 하는 실수

  • 엉뚱한 곳에 서버 추가: 클라이언트마다 읽는 파일과 키 이름(mcpServers, servers, context_servers)이 다릅니다. 잘못된 키 아래에 넣은 항목은 오류 없이 무시됩니다.
  • Node가 없거나 PATH가 짧음: npx로 시작하는 서버에는 Node가 필요합니다. Dock이나 시작 메뉴에서 연 앱은 터미널과 같은 PATH를 보지 못할 수 있으니, 서버가 시작되지 않으면 npx의 전체 경로를 쓰세요.
  • 모든 클라이언트가 이미지를 받는다고 가정: 프로토콜은 도구 결과에 이미지를 담을 수 있게 하지만, 모든 클라이언트가 그 이미지를 모델에 전달하지는 않습니다. 에이전트가 스크린샷을 볼 수 없다고 하면 클라이언트 문서를 확인하세요.
  • 모든 승인을 끄기: 모든 도구를 자동 승인하면 긴 작업에는 편하지만, 삭제·전송·예약처럼 되돌리기 어려운 작업에는 확인을 켜 두세요.
  • 페이지 속 글을 지시로 받아들이기: 캡처한 페이지나 문서 안의 글은 데이터입니다. 신중한 에이전트와 서버는 둘 다 그렇게 다룹니다.

같은 스크린샷을 반복해서 찍고 계신가요?

Shotomatic은 창이나 영역을 정해 둔 간격마다 자동으로 찍고 이미지나 PDF로 내보냅니다.

자주 묻는 질문

MCP 서버란 무엇인가요?

Model Context Protocol로 AI 앱에 도구, 데이터, 프롬프트를 제공하는 프로그램입니다. AI 앱이 클라이언트가 되어 서버의 도구 목록을 읽고, 요청을 처리하면서 언제 어떤 도구를 호출할지 정합니다.

MCP 서버는 로컬인가요, 원격인가요?

둘 다 가능합니다. 로컬 서버는 보통 stdio로 동작하며, 클라이언트가 내 컴퓨터에서 서버를 하위 프로세스로 실행합니다. 원격 서버는 다른 곳에서 실행되고 Streamable HTTP로 연결하며, 로그인 단계가 있는 경우가 많습니다.

MCP를 쓰려면 코딩을 해야 하나요?

아닙니다. 대부분의 클라이언트는 명령 한 줄이나 설정 파일의 짧은 JSON 항목으로 서버를 추가합니다. 버튼 하나로 에이전트에 자신을 추가하는 데스크톱 앱도 있습니다.

MCP 서버를 연결해도 안전한가요?

서버는 자기 도구가 허용하는 일만 할 수 있지만, 도구를 언제 호출할지는 에이전트가 정합니다. 믿을 수 있는 서버만 설치하고, 클라이언트의 도구 승인 기능을 켜 두고, 파일 삭제처럼 되돌리기 어려운 작업 전에 확인을 받는 서버를 고르세요.

출처

관련 자료

MCP(Model Context Protocol)란? | 용어집 | Shotomatic