GLOSSARY

MCP 리소스 (MCP Resource)

중급바이브 코딩

이 페이지는 바이브 코딩 문맥에서 자주 쓰이는 MCP 리소스 (MCP Resource)의 뜻과 쓰임을 중급 난이도 기준으로 정리한 AI 용어사전 항목입니다. 정의와 맥락, 관련 용어 5개 순서로 묶었으니, 아래 설명을 먼저 읽고 연결된 개념과 글까지 이어서 보면 이해가 빨라집니다.

MCP 리소스(MCP Resource)는 MCP 서버가 클라이언트에 제공하며 URI로 식별되는 문맥 데이터입니다. 파일 내용이나 데이터베이스 구조처럼 모델이 답을 만드는 데 참고할 자료를 담습니다. 호스트 애플리케이션이 자료를 어떻게 선택하고 문맥에 넣을지 정하며, 서버에서 읽을 수 있다는 사실만으로 모든 자료가 모델에 자동 전달되지는 않습니다.

URI로 찾고 읽는 문맥 데이터

MCP 2026-07-28 리소스 명세는 리소스를 파일, 데이터베이스 스키마, 애플리케이션 정보 등의 문맥을 제공하는 수단으로 설명합니다. 클라이언트는 resources/list로 목록을 찾고 resources/read에 URI를 보내 내용을 읽습니다. 목록의 이름이나 설명은 선택을 돕는 정보이고, 읽기 요청으로 받은 내용과는 구분됩니다. 목록에 파일명이 보인다는 사실만으로 파일 본문까지 읽었다고 볼 수 없습니다.

URI는 리소스를 구별하는 식별자입니다. 일반 웹 주소와 같은 형태일 수도 있고 서버가 정한 다른 스킴을 사용할 수도 있습니다. 화면에 표시하는 name이나 title을 바꾸어도 어느 자료를 읽을지는 URI를 기준으로 판단합니다. 텍스트 자료는 text, 바이너리 자료는 Base64로 인코딩한 blob에 담아 전달할 수 있으며, mimeType은 내용의 형식을 설명합니다.

리소스 템플릿은 값에 따라 달라지는 자료의 주소 패턴을 제공합니다. 문서 ID별 조회처럼 매개변수를 넣어 특정 리소스를 가리키는 방식입니다. 템플릿 목록은 resources/templates/list로 찾습니다. 고정된 자료 목록과 주소 패턴을 따로 다루므로, 템플릿이 존재한다고 가능한 모든 자료가 목록에 하나씩 실려 있다고 가정하지 않습니다.

리소스와 도구 및 프롬프트의 역할

MCP 서버 개념 문서는 도구, 리소스, 프롬프트를 서버의 서로 다른 기능으로 구분합니다. 도구는 모델이 호출할 작업을 제공하고, 리소스는 애플리케이션이 문맥으로 사용할 데이터를 제공하며, 프롬프트는 사용자가 선택할 수 있는 재사용 가능한 상호작용 틀을 제공합니다. 기능 이름이 비슷해도 호출 결과와 선택 주체가 같은 것은 아닙니다.

프로젝트의 데이터베이스 구조를 읽어 질문에 답하는 상황에서는 구조 정보가 리소스에 해당합니다. 새 레코드를 생성하는 작업은 도구로 표현할 수 있습니다. 자료를 읽는 도구도 만들 수 있으므로 ‘읽기는 언제나 리소스’라는 규칙으로 나누지는 않습니다. 해당 서버가 어떤 인터페이스로 노출했는지와 호스트가 그 결과를 어떻게 사용하는지 확인하면 두 기능의 경계가 드러납니다.

리소스는 검색 증강 생성에서 참고 자료를 얻는 경로가 될 수 있지만, 검색 증강 생성 전체를 뜻하지는 않습니다. 검색어를 만들고 후보를 고르고 응답에 근거를 반영하는 과정은 별도 설계입니다. 문서를 읽어 왔어도 모델의 컨텍스트 윈도우에 들어간 내용이 일부라면, 서버가 가진 전체 자료와 실제 답변의 근거 범위는 다릅니다.

변경 알림과 접근 조건

같은 버전의 리소스 명세는 서버가 resources 기능을 선언하고 변경 알림 지원 여부를 표시하도록 정합니다. 목록 변경을 알리는 listChanged와 개별 자료 변경의 구독을 지원하는 subscribe는 선택 사항입니다. 지원 여부를 확인하지 않고 모든 서버가 변경을 실시간으로 알려 준다고 기대할 수는 없습니다.

목록 변경과 내용 변경도 다른 사건입니다. 새 파일이 목록에 추가된 것과 이미 선택한 파일의 본문이 수정된 것은 호스트가 다시 확인할 대상이 다릅니다. 이 버전에서는 subscriptions/listen으로 특정 리소스의 변경을 구독하고 notifications/resources/updated 알림을 받습니다. 알림 자체를 새 본문으로 사용하지 않고, 필요한 내용을 다시 읽는 과정과 연결합니다.

클라이언트에게 보이는 리소스 목록은 요청에 제시한 권한에 따라 달라질 수 있습니다. URI를 안다는 사실만으로 그 자료에 접근할 권한까지 생기지는 않습니다. 호스트는 자료의 크기와 출처, 선택한 범위를 확인해 모델에 전달할 내용을 정합니다. 자료 안에 실행을 요구하는 문구가 있더라도 참고 데이터와 사용자의 지시를 구분하면 외부 문서가 에이전트의 작업 권한을 바꾸는 문제를 줄일 수 있습니다.

RELATED TERMS