MCP 공식 문서: 내 컴퓨터에서 MCP 서버를 안전하게 돌리는 법 (로컬 서버 보안)
리퀘오 운영팀
Model Context Protocol(MCP) 공식 문서의 「로컬 서버 보안」 글을 한국어로 옮겼습니다. MCP 서버를 Claude·Cursor·VS Code 같은 앱에 붙여 쓰는 분이라면 한 번은 읽어 둘 만한 글입니다.
이 글이 다루는 위협은 프로토콜(OAuth, 토큰 처리 등)이 아니라 '내 컴퓨터'입니다. MCP 서버를 로컬에서 돌린다는 것은 인터넷에서 받은 코드를 내 계정의 자식 프로세스로 실행한다는 뜻입니다. 그 프로세스는 내 환경 변수를 물려받고, 내 계정이 읽을 수 있는 모든 것(SSH 키, 클라우드 자격 증명, 브라우저 프로필, 홈 폴더)을 읽을 수 있으며, 어디로든 네트워크 연결을 열 수 있습니다. 이것은 프로토콜이 아니라 '어떻게 실행하느냐'가 정합니다.
이것 하나만 하세요: 쓰는 앱의 MCP 설정을 열어 안 쓰는 서버를 지우고, 남은 서버가 어디서 왔는지 알고 버전이 고정돼 있는지 확인하세요. 나머지는 모두 '무엇을 돌리고 있는지 아는 것'에서 시작합니다.
1. stdio는 샌드박스가 아닙니다
로컬 서버는 대부분 stdio 방식입니다. 앱이 서버를 하위 프로세스로 띄우고 표준 입출력으로 대화합니다. 이때 앱과 서버는 같은 권한으로 나란히 돌며 서로를 막아 주지 않습니다. 서버는 실행되는 순간 이미 내 컴퓨터에서 코드를 실행하고 있기 때문입니다. 그래서 진짜 보안 결정은 실행 '전'에 일어납니다. 무엇을 설치하느냐(출처)와 어떻게 실행하느냐(격리)입니다.
또 설정한 서버들은 모두 같은 모델 맥락을 공유합니다. 악성 서버 하나가 다른 서버의 도구를 에이전트가 어떻게 쓰는지까지 흔들 수 있습니다. 서버를 하나 더 붙일 때마다 위험 면적이 넓어집니다.
2. 이런 위협을 막으려는 글입니다
- 악성 서버: 비슷한 이름의 패키지, 가짜 저장소, 버려진 프로젝트를 넘겨받은 새 배포자. 광고대로 동작하면서 몰래 환경 변수나 파일을 빼냅니다.
- 과하게 수집하는 서버: 정상 서버지만 필요 이상을 읽습니다. 신뢰할 수 없는 내용에 숨은 프롬프트 주입이 정직한 서버를 같은 방향으로 몰 수도 있습니다.
- 오염된 의존성: 작성자는 정직하지만 의존 패키지 하나가 공급망 공격을 당한 경우.
- 오염된 도구 목록: 도구 이름과 설명은 모델이 읽는 지시문입니다. 그 안에 숨긴 지시로 에이전트를 조종할 수 있고, 승인한 뒤에 설명을 슬쩍 바꿀 수도 있습니다. 한 번의 동의 창과 버전 고정으로는 막지 못합니다.
- 취약한 서버·브리지: 정상 부품도 입구가 될 수 있습니다. 포트를 열어 둔 로컬 개발 도구가 웹 페이지에서 바로 공격당한 사례도 있습니다.
핵심 원칙: 어떤 검사도 서버가 실제로 무엇을 할지 증명하지 못합니다. 그러니 제3자 로컬 서버는 '내가 준 권한만큼만 가진 신뢰할 수 없는 코드'로 보고, 권한은 최대한 적게 주세요.
3. 정말 로컬에서 돌려야 하는지 먼저 물으세요
작업 폴더를 읽거나, 로컬 도구를 다루거나, 하드웨어에 접근해야 한다면 로컬이 맞습니다. 하지만 원격 API를 감싸기만 하는 서버라면 내 노트북에서 돌릴 이유가 없습니다. 원격(Streamable HTTP) 버전이 있으면 그쪽을 쓰세요. 내 컴퓨터에서 코드가 돌지 않고, 설정 파일에 토큰을 둘 필요가 없고, 패치도 한곳에서 됩니다.
4. 설치 전에 출처를 확인하세요
- 배포자 확인: 패키지가 실제 저장소·관리자와 이어지는지, 최근 활동이 있는지.
- 정확한 패키지 이름: 비슷한 이름(타이포스쿼팅)이 가장 싼 공격입니다.
- 버전 고정: latest 대신 특정 버전을 설치하세요. 대신 보안 공지가 나오면 직접 올려야 합니다.
- 고정의 범위: npx·uvx로 버전을 고정해도 하위 의존성은 설치 때마다 새로 받습니다. 컨테이너 이미지를 다이제스트(image@sha256:...)로 고정하면 의존성 전체가 고정됩니다.
- 서명·빌드 증명·SBOM(소프트웨어 구성 목록)이 있는 배포물을 고르세요.
5. 도구 설명도 신뢰하지 마세요
서버를 쓰기 전에 도구 목록과 설명을 한 번 읽으세요(MCP Inspector로 모델 없이 볼 수 있습니다). 도구 역할과 무관한 지시가 들어 있으면 지우세요. 도구 정의가 바뀌면 다시 묻는 앱을 고르고, 서버 수는 적게 유지하세요.
6. 격리해서 실행하세요 (가장 효과가 큰 조치)
제3자 서버는 컨테이너(Docker, Podman) 안에서, 꼭 필요한 폴더만 연결해 돌리세요. stdio는 컨테이너에서도 그대로 동작합니다. 개발 전용 가상 머신이나 운영체제의 샌드박스 기능도 대안입니다. '이 서버가 내 SSH 키를 읽을 수 있다'가 '빈 폴더만 읽을 수 있다'로 바뀝니다.
7. 자격 증명을 나누세요
- 비밀 값은 셸 프로필에 전역으로 두지 말고, 앱 설정의 서버별 환경 설정으로 각 서버에 따로 주세요.
- 서버마다 가장 좁은 권한의 토큰을 따로 발급하세요(예: 계정 전체 토큰 대신 저장소 하나로 제한한 세분화 토큰).
- 오래 쓰는 비밀 값은 평문 설정 파일 대신 운영체제 비밀 저장소(macOS 키체인, Windows 자격 증명 관리자 등)에 두세요.
- ~/.ssh, ~/.aws 같은 폴더도 디스크 위의 자격 증명입니다. 실제로 막아 주는 것은 격리입니다.
8. 파일 접근을 좁히세요
홈 폴더가 아니라 특정 프로젝트 폴더만, 가능하면 읽기 전용으로 주세요. 좁은 일을 하면서 넓은 폴더를 요구하는 서버는 의심하세요. 설정의 허용 목록은 '협조적인 경계'일 뿐이라 악성 서버는 무시할 수 있습니다. 강제력은 격리에서 나옵니다.
9. 바깥 통신을 통제하세요
빼낸 데이터는 나갈 길이 있어야 합니다. 로컬 파일·도구만 다루는 서버는 네트워크가 필요 없습니다(컨테이너라면 --network=none 한 줄). 통신이 필요한 서버는 갈 곳이 정해져 있으니 방화벽이나 도메인 허용 목록 프록시로 제한하세요. 그리고 포트를 여는 로컬 MCP 부품은 127.0.0.1에 묶는 것만으로 인증이 되지 않습니다. 브라우저를 통해 웹사이트도 닿을 수 있으니 실제 인증과 출처 검증, 빠른 업데이트가 필요합니다.
내 컴퓨터 점검표
- 설정에 있는 서버를 모두 알고, 안 쓰는 것은 지웠다.
- 내 컴퓨터에서 필요한 게 없는 서버는 원격으로 쓴다.
- 서버마다 배포자를 알고, 버전을 고정했다.
- 제3자 서버는 컨테이너·샌드박스·VM에서 격리해 돌린다.
- 서버마다 자기 전용의 좁은 자격 증명만 준다(셸에서 물려받거나 재사용하지 않음).
- 파일 접근은 특정 폴더로, 가능하면 읽기 전용으로 제한했다.
- 네트워크가 필요 없는 서버는 끊었고, 나머지는 갈 곳을 안다.
- 도구 설명을 한 번 읽었고, 내 앱은 도구 정의가 바뀌면 다시 묻는다.
원문에는 회사 전체에서 로컬 MCP 서버를 관리하는 방법(승인 목록, 설정 파일 상시 점검, 감사 기록, 사고 대응)도 있으니 관리자라면 원문을 함께 보세요. 여러분은 MCP 서버를 어떻게 격리해 쓰고 있나요? 댓글로 나눠 주세요.
---
출처: Model Context Protocol 문서 「로컬 서버 보안」 (Model Context Protocol 기여자)
https://modelcontextprotocol.io/docs/tutorials/security/local-server-security
라이선스: CC BY 4.0 https://creativecommons.org/licenses/by/4.0/deed.ko
변경 사항: 리퀘오 운영팀이 한국어로 번역하고 일부 축약·재구성했습니다(조직 관리 절은 요약, 그림·각 절의 '더 나아가기' 일부 생략). 원문 작성자가 이 번역을 보증하지 않습니다.
도움돼요 0 로그인하면 누를 수 있습니다. 로그인하면 저장하고 새 답글 알림을 받을 수 있습니다.
AI 차트 도구 (AI 요약·회원 리뷰·인기점수)
- @modelcontextprotocol/server npm · MCP 다른 글
- github/github-mcp-server GitHub · MCP 다른 글
- PrefectHQ/fastmcp GitHub · MCP 다른 글