MCP 서버는 클라이언트(즉, LLM 앱)에게 무엇을 전달할 수 있을까요? 답은 단 3가지입니다. Tools (툴), Resources (리소스), Prompts (프롬프트). 이 세 가지는 '누가 사용 시점을 결정하는지'에 따라 성격이 명확하게 구분됩니다. 이번 3번째 글에서는 이 차이를 중심으로 정리하겠습니다.
- 서버가 제공하는 세 가지 기능의 차이점
- 각각 '누가 주도권을 갖는지'라는 정리 기준
- 세 가지 기능을 사용하는 기준
MCP 서버가 제공할 수 있는 기능은 Tools, Resources, Prompts의 3가지 종류뿐입니다. 모두 클라이언트가 서버에 문의하는 형태는 같지만, 사용 시점을 누가 결정하느냐가 다릅니다.
| 기능 | 주도권 | 한마디로 말하면 | 주요 메서드 |
|---|
| Tools | 모델 (LLM) | LLM이 '실행'하는 기능 | tools/list / tools/call |
| Resources | 애플리케이션 | LLM에게 '읽게 하는' 데이터 | resources/list / resources/read |
| Prompts | 사용자 | 사용자가 '선택하는' 정형화된 지시 | prompts/list / prompts/get |
이 차이를 이해하면 서버 설계 시 '어떤 기능으로 만들어야 할지' 판단하기가 어려워지지 않습니다.
Tools는 LLM이 외부 시스템과 상호작용하는 기능입니다. 데이터베이스 검색, API 호출, 계산 등이 여기에 해당합니다. 핵심은 호출할지 여부를 LLM 스스로 판단한다는 것입니다. 대화의 문맥을 보고 필요하다고 생각되면 호출하고, 불필요하면 호출하지 않습니다.
툴 하나는 다음 정보로 정의됩니다.
| 항목 | 의미 |
|---|
name | 툴의 고유한 이름 (예: search_faq) |
description | 어떤 툴인지에 대한 설명. LLM은 이것을 읽고 사용할지 판단합니다. |
inputSchema | 인수의 형태를 정한 JSON Schema. 타입이나 필수 항목을 여기서 결정합니다. |
outputSchema | 선택 사항. 반환되는 결과의 구조를 정의합니다. |
예를 들어, 사내 FAQ를 검색하는 툴이라면 인수는 다음과 같은 형태가 됩니다.
{
"name": "search_faq",
"description": "사내 FAQ에서 질문과 관련된 답변을 검색합니다",
...}
클라이언트는 먼저 tools/list로 목록을 가져오고, LLM이 '사용하고 싶다'고 판단하면 tools/call로 호출합니다. 결과는 텍스트 같은 '비구조화 콘텐츠' 또는 스키마에 맞는 JSON의 '구조화 콘텐츠'로 반환됩니다.
오류에는 두 종류가 있습니다. **프로토콜 오류(Protocol Error)**는 '존재하지 않는 툴을 호출했다' 등 요청 자체의 문제로, 일반적인 JSON-RPC 오류로 반환됩니다. **툴 실행 오류(Tool Execution Error)**는 'API가 실패했다' 등 실행 중의 문제로, 결과에 isError: true를 붙여 반환합니다. 후자의 경우 LLM이 내용을 읽고 수정하여 재시도할 수 있습니다.
Tools는 부작용(외부 상태를 변경하는 것)을 가지는 유일한 기능입니다. 파일 쓰기나 데이터 업데이트가 가능한 것도 Tools뿐입니다. 그만큼 서버 측에서는 입력 검증, 접근 통제, 실행 횟수 제한이 필수적이며, 클라이언트 측은 기밀성이 높은 작업의 경우 실행 전에 사용자에게 확인을 요청하는 것이 요구됩니다.
Resources는 LLM에게 문맥으로 전달하기 위한 데이터입니다. 파일, 데이터베이스 스키마, 앱 고유 정보 등이 여기에 해당합니다. Tools와 달리, 무엇을 전달할지는 애플리케이션(호스트)이 결정합니다. 예를 들어 에디터가 열려 있는 파일 목록을 보여주고, 사용자가 선택한 것을 LLM에게 읽게 하는 형태입니다. LLM이 임의로 읽으러 갈 수는 없습니다.
리소스는 URI로 고유하게 식별됩니다. resources/list로 목록을 가져오고, resources/read로 내용을 읽어옵니다. URI 스키마에는 다음과 같은 것들이 있습니다.
| 스키마 | 용도 |
|---|
file:// | 파일 시스템처럼 다루는 리소스. 실제 파일이 아니어도 됩니다. |
https:// | 웹상의 리소스. 클라이언트가 직접 가져올 수 있는 경우에 사용합니다. |
git:// | Git 저장소와의 연동 |
| 사용자 정의 스키마 | 앱 고유의 식별자 (예: app://)도 정의할 수 있습니다. |
내용은 텍스트이거나 바이너리(base64로 전송) 중 하나입니다. 리소스에는 사용법에 대한 힌트가 되는 **어노테이션(annotation)**을 추가할 수 있습니다.
| 어노테이션 | 의미 |
|---|
audience | 예상 독자. user 또는 assistant (또는 둘 다) |
priority | 0.0~1.0의 중요도. 1에 가까울수록 필수적임 |
lastModified | 최종 수정 일시(ISO 8601 형식) |
또한, 정해진 URI뿐만 아니라 **리소스 템플릿(resource template)**을 사용하여 매개변수(parameter)가 포함된 URI를 공개할 수도 있습니다. 예를 들어 file:///docs/{name}.md와 같은 경우입니다.
이에 대응하는 서버에서는 리소스의 변경 사항을 구독하여 업데이트 알림을 받을 수도 있습니다.
중요한 점은, Resources는 **읽기 전용의 '문맥(context)'**이며 데이터를 변경할 수 없다는 것입니다. '알려주고 싶은 정보'는 Resources, '수행시키고 싶은 동작'은 Tools, 와 같이 구분하면 기억하기 쉽습니다.
Prompts는 서버가 준비한 **프롬프트 템플릿(prompt template)**입니다. LLM에 대한 지시문을 정형화하여 사용자가 선택해 사용할 수 있도록 만든 것입니다. 여기서 사용자가 주도권을 가집니다. 전형적으로 클라이언트의 UI에 슬래시 명령어와 같은 형태로 표시되며, 사용자가 명시적으로 선택하고 실행합니다.
프롬프트 정의는 간단합니다. name과 description 외에도 템플릿을 커스터마이징하는 **인수(arguments)**를 가질 수 있습니다. 예를 들어 코드 리뷰용 프롬프트의 형태는 다음과 같습니다.
{
"name": "review_code",
"description": "전달된 코드를 리뷰하여 개선점을 지적함",
...
클라이언트는 prompts/list로 목록을 가져오고, 사용자가 선택하면 prompts/get에 인수를 전달하여 내용을 가져옵니다. 반환되는 것은 메시지 리스트이며, 각 메시지에는 role(user 또는 assistant)과 내용이 포함됩니다. 텍스트가 중심이지만, 이미지, 음성 또는 리소스 링크 및 임베드도 포함될 수 있습니다.
내용을 만드는 것은 서버 측에서 이루어지고, 사용자가 결정하는 것은 '언제・어떤 프롬프트를 사용할지'뿐입니다. 자주 사용하는 지시문을 템플릿화하면 매번 긴 지시를 입력해야 하는 수고를 덜고, 팀원들이 동일한 품질의 지시문을 재사용할 수 있습니다.
세 가지 기능의 사용처는 이렇게 생각하면 간단합니다.
실제로는 세 가지 기능을 조합하는 경우도 많습니다. 예를 들어, 코드 리뷰 Prompts가 리소스 링크(리뷰 대상 파일)를 포함하고, LLM이 리뷰 도중 Tools로 관련 파일을 추가로 읽어들이는 흐름입니다. Prompts가 진입점 역할을 하고, Resources가 문맥을 보충하며, Tools가 동작을 담당합니다.
참고로, 서버는 세 가지 모두를 가질 필요는 없습니다. 제공하는 기능은 초기화 시의 **능력(capabilities)**으로 신고하며, 클라이언트는 신고된 것만 사용합니다. 우선 하나부터 작게 시작하는 것이 현실적입니다. 다음 회차 이후 ④에서 기존 서버 도입, ⑤⑥⑦에서 직접 제작 및 각 기능 구현을 깊이 있게 다루겠습니다.
-
MCP 서버가 제공하는 기능은 Tools・Resources・Prompts 세 가지뿐임
-
Tools는 모델 주도로 LLM이 실행 여부를 판단함. 부작용(side effect)을 갖는 유일한 기능이며, inputSchema로 인수를 정의함 -
-
Resources는 앱 주도로, URI로 식별되는 읽기 전용 문맥 데이터임. 템플릿 및 구독에도 대응함 -
-
Prompts는 사용자 주도로, 인수(arguments)가 포함된 정형 지시문 템플릿임. 슬래시 명령어처럼 선택하여 사용함 -
-
헷갈릴 때는 '동작시키고 싶다 → Tools', '읽게 하고 싶다 → Resources', '정형 지시를 재사용하고 싶다 → Prompts'로 선택
-
세 가지는 조합해서 사용할 수도 있으며, 능력은 초기화 시에 신고함
-
MCP 서버 관련 ①: 전체 개요 및 기본 개념 — 호스트/클라이언트/서버의 3가지 역할과 MCP의 전체 개요를 설명
-
MCP 서버 관련 ②: 통신 메커니즘 — JSON-RPC 2.0 메시지 형식과, 초기화/라이프사이클, 두 가지 전송 방식을 설명
도구(Tools) - Model Context Protocol — 도구의 메커니즘, 정의, 오류 처리 및 보안 공식 설명
리소스(Resources) - Model Context Protocol — 리소스의 메커니즘, URI 스키마, 템플릿, 구독 공식 설명
프롬프트(Prompts) - Model Context Protocol — 프롬프트의 메커니즘, 인자, 메시지 데이터 공식 설명
도구(Tools): MCP 서버가 LLM에 제공하는 '실행 가능한 기능'. LLM이 사용할지 여부를 판단한다.
리소스(Resources): MCP 서버가 제공하는 '읽어보게 할 데이터'. URI로 식별되며, 읽기 전용이다.
프롬프트(Prompts): MCP 서버가 제공하는 '프롬프트 템플릿'. 사용자가 선택하여 사용하는 정형화된 지시문이다.
주도권: 그 기능을 '언제・어떻게 사용할지'를 결정하는 주체. Tools는 모델, Resources는 애플리케이션, Prompts는 사용자이다.
JSON Schema: JSON 데이터의 형태(타입・필수 항목 등)를 선언하기 위한 사양. 도구의 입력이나 출력 정의에 사용한다.
inputSchema: 도구가 받을 인자의 형태를 정한 JSON Schema.
outputSchema: 도구가 반환할 결과 구조를 정한 JSON Schema (선택 사항).
URI: 리소스를 유일하게 식별하는 문자열. file://나 https://와 같은 스키마를 가진다.
리소스 템플릿: 매개변수(parameter)가 있는 URI로 리소스를 공개하는 메커니즘. {name}처럼 인자를 채워 넣을 수 있다.
어노테이션(Annotation): 리소스 사용법의 힌트가 되는 부가 정보. 읽는 사람(audience), 중요도(priority), 최종 업데이트 일자 등이 있다.
부작용(Side Effect): 외부 상태를 변경하는 것. 파일 쓰기나 데이터 업데이트 등이 해당한다.
프로토콜 오류(Protocol Error): 요청 자체의 문제임을 나타내는 JSON-RPC 오류. 존재하지 않는 도구 호출 등이 해당한다.
도구 실행 오류(Tool Execution Error): 도구 실행 중의 문제를 나타내는 오류. 결과에 isError: true를 붙여 반환하며, LLM이 수정하여 재시도할 수 있다.
능력(capabilities): 초기화 시 신고하는 대응 기능 목록. 합의된 것만 사용된다.
슬래시 명령어(Slash Command): 채팅 UI 등에서 "/"로 시작하여 호출하는 정형 명령어. Prompts의 전형적인 제시 방식이다.