⑧까지 진행하면서 로컬 환경에서의 서버 구축부터 AWS 배포, 그리고 OAuth 2.1 인증까지 완료했습니다. 이번 글에서는 '구축한 서버를 어떻게 보호하고, 어떻게 운영할 것인가'에 대해 다룹니다.
이 문서는 MCP 사양의 최신 버전인 2026-07-28을 기반으로 작성되었습니다. 이 버전을 기준으로 프로토콜은 스테이트리스(stateless)하며 세션 개념은 없습니다.
- MCP 서버 고유의 리스크와 다층 방어(Defense in Depth)에 대한 생각
- 최소 권한 설계와 위험한 도구의 안전한 제작 방법
- AWS에서의 샌드박스 구성과 로그/모니터링 시스템 구축 방법
- 도구나 프로토콜을 변경할 때 주의해야 할 점들
MCP 기능 중 부작용(side effect)을 가질 수 있는 것은 **도구(Tool)**입니다. 사양에는 '도구는 임의 코드 실행이므로 적절한 주의를 기울여 다루어야 한다'고 명시되어 있습니다. 리소스나 프롬프트는 읽기만 하지만, 도구는 DB를 수정하고 외부로 전송하며 파일을 삭제할 수 있습니다.
까다로운 점은 호출 주체가 인간이 아니라 모델이라는 것입니다. 모델은 대화의 문맥을 판단하여 도구를 선택하고 인자(argument)까지 스스로 결정합니다. 사양은 서버에 '모든 도구 입력값을 검증해야 한다'고 요구합니다. 따라서 인자는 신뢰할 수 없는 입력값으로 간주하는 것이 출발점입니다.
게다가, 도구의 결과물 또한 입력값이 됩니다. DB 행이나 웹페이지 등, 도구가 반환한 내용에 지시가 숨겨져 있을 수 있으며, 모델이 이를 읽고 다음 도구 호출을 잘못할 수 있습니다. 이것이 이른바 **간접 프롬프트 인젝션(Indirect Prompt Injection)**입니다. 사양은 서버에게 '모든 도구 입력값 검증'과 '도구 출력값 정제(Sanitization)'를 요구하며, 클라이언트 측에는 도구 결과를 LLM에 전달하기 전에 검증을 요청하고 있습니다. 읽기 전용 도구로 수집한 비밀 정보를 전송 도구를 통해 외부로 내보내는 조합이 가장 위험합니다.
인젝션 자체를 완전히 막는 방법은 없습니다. 따라서 대책은 '피해를 제한하는 방향'으로 기울어져야 합니다.
OAuth 2.1 복습(자세한 내용은 ⑧): 서버는 **리소스 서버(Resource Server)**로서, 토큰을 발급하는 것이 아니라 검증하는 역할을 합니다. 지켜야 할 규칙이 두 가지 있습니다. 첫째, 자기 자신에게 온 것만 받아들이고, 다른 서비스에 대한 토큰은 받지 않으며, 하위 API로 전달하지 않아야 합니다 (토큰 패스스루 금지(Token Pass-through Prohibition)). 클라이언트는 인가 요청과 토큰 요청 모두에서 resource 파라미터를 보내어 토큰을 '이 서버를 위한 것'으로 묶어야 합니다. 구체적인 토큰 검증 구현(Cognito의 JWKS 검증 등)은 ⑩에서 설계 지침으로 정리할 예정입니다.
권한은 '나중에 줄지'가 아니라, 처음부터 작게 가져가야 합니다.
- 스코프는 최소한으로: 사양의 모범 사례(best practice)는 처음에 읽기 등의 저위험 작업만 가능한 스코프를 부여하고, 권한이 필요할 때
WWW-Authenticate 헤더의 scope 챌린지를 통해 단계적으로 상향시키는 방법을 권장합니다. *와 같은 포괄적인 스코프는 피해야 합니다.
- 도구별로 반환하는 것을 다르게: 사양에서는
tools/list를 통해 반환되는 도구 집합은 제시된 인가(스코프)에 따라 달라질 수 있다고 되어 있습니다. 읽기 전용 스코프 호출을 하는 곳에는 읽기 도구만 보이도록 설계할 수 있습니다.
- 읽기 전용은 DB 측에서 보장: ⑤의
run_query처럼, 연결 자체를 읽기 전용으로 설정하고 허용하는 문장을 SELECT (WITH로 시작하는 것을 포함)에만 국한해야 합니다. 도구에 붙는 readOnlyHint는 어디까지나 클라이언트를 위한 힌트일 뿐입니다. 이것을 붙이지 않으면 '파괴적일 수 있다'고 간주되고, 붙인다고 해서 서버 측의 제어권이 생기는 것은 아닙니다. 제어는 DB 권한과 연결 방식을 통해 이루어져야 합니다.
쓰기/삭제/외부 전송을 동반하는 도구는 다음 세 가지를 묶어서 설계해야 합니다.
| 관점 | 지침 |
|---|
| 대상 한정 | 조작할 수 있는 대상을 허용 목록(테이블 이름, 전송처 등)으로 제한합니다. |
| ... | |
승인(Approval)에는 **엘리시테이션(Elicitation)**을 사용할 수 있습니다. 서버가 도구 실행 도중에 클라이언트를 통해 사용자에게 추가 정보를 요청하는 메커니즘이며, 승인 확인에도 사용됩니다. 폼 형식은 입력 내용이 클라이언트에게 노출되므로, 비밀번호나 API 키 같은 기밀 정보 수집에는 사용하지 않고, 클라이언트를 거치지 않는 URL 형식(브라우저에서 열리는 별도의 페이지)으로 진행합니다 (사양은 기밀 정보에 대해서는 URL 형식을 필수로 합니다). 사용자 거부/취소 시의 처리 방법도 구현해야 합니다.
위험한 조건은 툴 외부에 두지 않고 내부에 포함시키는 것이 핵심입니다. 삭제 가능한 테이블은 집합으로 명확히 지정하고, 기간에는 상한을 설정합니다. 모델이 days=99999와 같은 값이나 다른 테이블 이름을 전달하더라도 서버 측에서는 차단합니다. 또한, destructive_hint=True를 추가하여 클라이언트에게 '파괴적인 툴'임을 알리는 것도 잊지 마세요. 참고로 이 코드는 실행 부분을 생략한 골격입니다. 실제로 사용할 때는 여기에 DELETE 문 실행과 삭제 건수 확인 로직을 추가해야 합니다. 검증에 실패했을 경우, 섹션 ⑥에서 소개된 ToolError를 발생시켜 모델에게 수정 방법을 알려줍니다.
툴이 악용되더라도 피해가 확산되지 않도록 실행 환경을 분리합니다. 사양상으로도 로컬 서버는 클라이언트와 동일한 권한으로 작동하므로, 샌드박스화(Sandboxing)나 권한 최소화(Principle of Least Privilege)를 요구하고 있습니다.
AWS에서 ECS on Fargate에 배포할 경우의 분리 방법은 다음과 같습니다:
| 계층 | 방법 |
|---|
| 프로세스 | 태스크 단위로 분리합니다. 다른 태스크와 권한을 공유하지 않습니다. |
| AWS 권한 | Task 실행 역할(Task Execution Role, 이미지 가져오기/비밀 정보 가져오기)과 Task 역할(Task Role, 앱이 AWS API를 호출하는 권한)을 분리합니다. 각각 필요 최소한의 권한만 부여합니다. |
| 비밀 정보 | DB 패스워드 등은 Secrets Manager에 보관하고, 태스크 정의에서는 ARN으로 참조합니다. 평문 환경 변수에는 두지 않습니다. |
| 네트워크 | 보안 그룹(Security Group)과 VPC를 사용하여 외부 통신 대상을 필요한 곳으로만 제한합니다. |
Lambda에서 작동하는 경우도 생각은 동일하며, 함수에 부여하는 실행 역할(Execution Role)을 해당 함수가 필요한 작업만을 수행하도록 제한합니다. 공통 원칙은 “서버 프로세스에 부여되는 권한 = 피해의 상한선”입니다.
사양은 클라이언트에게 '감사를 위해 툴 사용을 로깅할 것'을 요구하고 있습니다. 서버 측에서도 호출 기록은 운영의 기반이 됩니다.
남겨야 할 정보: 툴 이름, 인자(Arguments), 결과 요약, 오류 내용, 호출한 사용자 (토큰의 sub 클레임), 시간. 나중에 '누가, 언제, 어떤 툴로, 무엇을 했는지'를 추적할 수 있는 것이 목적입니다.
남겨서는 안 되는 정보: 토큰이나 API 키, 패스워드 등의 비밀 정보입니다. 사양에서도 서버에 기록된 토큰이 유출되면 부정 이용으로 이어질 수 있다고 경고합니다. 인자를 그대로 로그로 남기지 않고, 비밀 정보에 해당하는 항목은 마스크(Mask) 처리하여 보관해야 합니다.
AWS에서의 구성은 다음과 같습니다:
| 역할 | 서비스 | 사용 방법 |
|---|
| 앱 로그 | CloudWatch Logs | 툴 호출 기록을 집계하고, 검색 및 알람의 자료로 활용합니다. |
| ... | | |
프로토콜 버전(Protocol Version): Streamable HTTP에서는 요청에 MCP-Protocol-Version 헤더가 추가되며, 본문 버전과 일치하지 않으면 400 에러가 발생합니다. 서버가 대응하지 않는 버전에도 400으로 응답합니다. 지원하는 버전을 명시하여 구형 클라이언트가 갑자기 연결이 끊기는 것을 방지해야 합니다.
툴 정의 변경(Tool Definition Change): 툴의 설명문이나 스키마를 변경하면 모델의 호출 방식이 바뀝니다. 사양은 tools/list 엔드포인트를 정해진 순서로 반환할 것을 권장하며, 이는 툴 목록의 안정성이 전제되어야 함을 의미합니다. 툴 이름 변경이나 삭제, 인자 필수화는 파괴적 변경(Destructive Change)으로 간주하여 사전에 공지하고 마이그레이션 기간을 두어야 합니다.
서버 버전(Server Version): 배포할 때마다 버전을 올리고 어떤 버전에서 무엇이 바뀌었는지 기록해야 합니다. 문제가 발생했을 때, 로그의 시간과 버전을 대조하여 롤백(Rollback)할 수 있도록 준비합니다.
-
도구(Tool)는 모델이 호출할 수 있는 임의 코드 실행입니다. 인자(argument)와 결과 모두 신뢰할 수 없는 입력으로 취급하여 피해를 제한하는 설계로 만듭니다.
-
권한은 최소한부터 시작하며, 토큰은 자신에게 할당된 것만 받고 하위 시스템으로 전송하지 않습니다.
-
위험한 도구는 허용 목록(allow list)과 인자 검증으로 제한하고, 파괴적인 작업에는 인간의 승인을 거칩니다.
-
실행 환경을 분리합니다. AWS에서는 태스크 역할(Task Role)과 실행 역할(Execution Role)을 분리하고, 비밀 정보는 Secrets Manager에 보관합니다.
-
로그는 '누가・언제・무엇을 했는지' 추적할 수 있는 형태로 남기고, 비밀 정보는 마스킹합니다. CloudWatch Logs와 CloudTrail로 이상 징후를 감지합니다.
-
도구 정의의 변경은 파괴적 변경(breaking change)으로 취급하여 버전을 올리고 기록합니다.
-
Security Best Practices - Model Context Protocol (사양 2026-07-28)
-
Authorization - Model Context Protocol (사양 2026-07-28)
-
Tools - Model Context Protocol (사양 2026-07-28)
-
Streamable HTTP - Model Context Protocol (사양 2026-07-28)
-
Elicitation - Model Context Protocol (사양 2026-07-28)
-
MCP Python SDK
-
Specifying sensitive data using Secrets Manager secrets in Amazon ECS - AWS Documentation
-
AWS CloudTrail or Amazon CloudWatch? - AWS Decision Guides
최소 권한의 원칙: 필요한 권한만 부여하고, 그 이상은 주지 않는 설계 개념.
토큰 패스스루(Token Pass-through): 클라이언트로부터 받은 토큰을 검증하지 않고 하위 API로 전송하는 것. 사양에서 금지됨.
리소스 서버: OAuth를 통해 보호된 리소스를 보유하고, 토큰을 검증하는 쪽. MCP 서버가 이에 해당함.
스코프(Scope): 토큰에 부여되는 권한의 범위. '읽기 전용', '삭제까지' 등을 나타냄.
간접 프롬프트 인젝션(Indirect Prompt Injection): 도구가 반환한 문구 등에 숨겨진 지시를 모델이 잘못 실행하는 공격.
엘리시테이션(Elicitation): 서버가 도구 실행 도중에, 클라이언트를 통해 사용자에게 확인이나 추가 입력을 요청하는 메커니즘.
샌드박스(Sandbox): 영향 범위를 제한하기 위해 마련된 분리된 실행 환경.
태스크 역할/태스크 실행 역할: ECS의 태스크에서 사용되는 두 가지 IAM 역할. 전자는 앱이 AWS API를 호출할 권한, 후자는 시작 시 이미지 가져오기나 비밀 정보 획득을 담당함.
CloudWatch Logs: AWS의 로그 수집 서비스. 애플리케이션 로그를 모아 검색이나 알람에 사용할 수 있음.
CloudTrail: AWS API 호출을 기록하는 서비스. 누가・언제・무엇을 했는지 감사(audit)에 사용함.
스테이트리스(Stateless): 요청마다 완결되며, 서버 측에서 세션 상태를 가지지 않는 설계.
파괴적 변경(Breaking Change): 기존의 사용 방식을 깨뜨리는 변경. 도구 이름 변경이나 인자 필수화 등이 해당됨.