MCP에서 Resource로 만들지 Tool로 만들지 — 기준은 부작용이다
MCP 서버를 만들 때 같은 데이터를 Resource로 노출할지 Tool로 노출할지 헷갈리는 순간이 온다. application-controlled와 model-controlled라는 통제 주체 차이에서 출발해 부작용 여부·시점 결정 주체·파라미터화 필요성 세 기준으로 판별하고, 같은 로그 데이터를 두 방식으로 등록하는 코드로 차이를 정리한다.
32개의 글 · 1 / 4 페이지
MCP 서버를 만들 때 같은 데이터를 Resource로 노출할지 Tool로 노출할지 헷갈리는 순간이 온다. application-controlled와 model-controlled라는 통제 주체 차이에서 출발해 부작용 여부·시점 결정 주체·파라미터화 필요성 세 기준으로 판별하고, 같은 로그 데이터를 두 방식으로 등록하는 코드로 차이를 정리한다.
Anthropic이 2026년 8월 27일 공개한 Model Hardware Standard(MHS)는 AI 에이전트가 현미경·로봇팔 같은 물리 장비를 발견·조작·복구하게 하는 공유 규격이다. MCP·CLI·코드 파일 세 제어 경로가 어떻게 나뉘는지, Genentech·QuEra 등 초기 파트너 사례, 그리고 리서치 프리뷰 단계의 한계까지 1차 발표문과 교차검증해 정리한다.
MCP 도구 결과가 텍스트 content 하나에 갇혀 있던 시절과, outputSchema·structuredContent가 그 결과를 스키마로 검증된 JSON으로 바꾼 방식을 TypeScript SDK 코드로 정리한다.
Anthropic이 2026년 8월 20일 Claude Platform에 정식 출시한 Skills API와 Files API를 뜯어본다. Claude Code Skill의 프롬프트 주입 방식과 달리 코드 실행 샌드박스 컨테이너 안에서 도는 실행 모델, 커스텀 스킬 업로드 규칙, 그리고 한 매체의 보도가 1차 문서와 어긋난 지점까지 정리한다.
MCP 서버가 stdout·stderr와는 별개로, 프로토콜 메시지 자체에 로그를 실어 클라이언트에게 보내는 logging capability를 다룬다. capability 선언, RFC 5424 8단계 레벨, sendLoggingMessage 코드, 클라이언트가 logging/setLevel로 볼륨을 조절하는 원리, 그리고 progress 알림과의 차이까지 실제 SDK 소스로 정리한다.
Linux Foundation이 2026년 5월 발표한 DNS-AID는 새 DNS 레코드 타입 없이 SVCB·TXT·TLSA·DNSSEC을 조합해 AI 에이전트와 MCP 서버를 DNS로 발행·검색·검증하는 오픈소스 프로젝트다. A2A Agent Card와의 관계, 동작 원리, 지금 시도해볼 만한지를 정리한다.
MCP 도구가 실행 중에 사람에게 구조화된 입력을 되묻는 Elicitation을 다룬다. elicitation/create 요청의 message·requestedSchema 구조, 평평한 스키마 제약의 이유, accept·decline·cancel 세 응답 갈래, 그리고 Sampling과의 차이를 정리한다.
MCP 도구가 텍스트 대신 대화창 안에서 인터랙티브 UI를 돌려줄 수 있게 하는 공식 확장 MCP Apps를 뜯어본다. ui:// 리소스와 App 클래스로 동작하는 방식, iframe 샌드박스 보안 모델, 2025년 11월 제안부터 2026년 7월 확장 프레임워크 정식화까지의 타임라인을 정리한다.
MCP가 7월 28일 발표한 2026-07-28 스펙은 세션 핸드셰이크를 통째로 제거해 프로토콜을 스테이트리스로 바꿨다. 무엇이 왜 사라졌는지, 서버→클라이언트 요청은 어떻게 대체됐는지, Roots·Sampling·Logging의 폐기 일정과 SDK 마이그레이션까지 정리한다.
MCP 서버를 만들 때 같은 데이터를 Resource로 노출할지 Tool로 노출할지 헷갈리는 순간이 온다. application-controlled와 model-controlled라는 통제 주체 차이에서 출발해 부작용 여부·시점 결정 주체·파라미터화 필요성 세 기준으로 판별하고, 같은 로그 데이터를 두 방식으로 등록하는 코드로 차이를 정리한다.
Anthropic이 2026년 8월 27일 공개한 Model Hardware Standard(MHS)는 AI 에이전트가 현미경·로봇팔 같은 물리 장비를 발견·조작·복구하게 하는 공유 규격이다. MCP·CLI·코드 파일 세 제어 경로가 어떻게 나뉘는지, Genentech·QuEra 등 초기 파트너 사례, 그리고 리서치 프리뷰 단계의 한계까지 1차 발표문과 교차검증해 정리한다.
MCP 도구 결과가 텍스트 content 하나에 갇혀 있던 시절과, outputSchema·structuredContent가 그 결과를 스키마로 검증된 JSON으로 바꾼 방식을 TypeScript SDK 코드로 정리한다.
Anthropic이 2026년 8월 20일 Claude Platform에 정식 출시한 Skills API와 Files API를 뜯어본다. Claude Code Skill의 프롬프트 주입 방식과 달리 코드 실행 샌드박스 컨테이너 안에서 도는 실행 모델, 커스텀 스킬 업로드 규칙, 그리고 한 매체의 보도가 1차 문서와 어긋난 지점까지 정리한다.
MCP 서버가 stdout·stderr와는 별개로, 프로토콜 메시지 자체에 로그를 실어 클라이언트에게 보내는 logging capability를 다룬다. capability 선언, RFC 5424 8단계 레벨, sendLoggingMessage 코드, 클라이언트가 logging/setLevel로 볼륨을 조절하는 원리, 그리고 progress 알림과의 차이까지 실제 SDK 소스로 정리한다.
Linux Foundation이 2026년 5월 발표한 DNS-AID는 새 DNS 레코드 타입 없이 SVCB·TXT·TLSA·DNSSEC을 조합해 AI 에이전트와 MCP 서버를 DNS로 발행·검색·검증하는 오픈소스 프로젝트다. A2A Agent Card와의 관계, 동작 원리, 지금 시도해볼 만한지를 정리한다.
MCP 도구가 실행 중에 사람에게 구조화된 입력을 되묻는 Elicitation을 다룬다. elicitation/create 요청의 message·requestedSchema 구조, 평평한 스키마 제약의 이유, accept·decline·cancel 세 응답 갈래, 그리고 Sampling과의 차이를 정리한다.
MCP 도구가 텍스트 대신 대화창 안에서 인터랙티브 UI를 돌려줄 수 있게 하는 공식 확장 MCP Apps를 뜯어본다. ui:// 리소스와 App 클래스로 동작하는 방식, iframe 샌드박스 보안 모델, 2025년 11월 제안부터 2026년 7월 확장 프레임워크 정식화까지의 타임라인을 정리한다.
MCP가 7월 28일 발표한 2026-07-28 스펙은 세션 핸드셰이크를 통째로 제거해 프로토콜을 스테이트리스로 바꿨다. 무엇이 왜 사라졌는지, 서버→클라이언트 요청은 어떻게 대체됐는지, Roots·Sampling·Logging의 폐기 일정과 SDK 마이그레이션까지 정리한다.
비공개로 의견 보내기
작성자에게만 전달돼요. 이름·이메일을 비우면 완전 익명입니다.