MCP 도구 결과 불일치: JSON은 미확인인데 설명은 출고 가능이라면

MCP 구조화 결과와 설명이 다르면 자동 후속 처리를 보류합니다. 2026-10-24 기준, 스키마 통과만으로 값의 일치를 보장하지 않습니다.

재고 조회 도구의 JSON에는 미확인 상태가 있는데 설명에는 출고 가능이라고 적혀 있다면 같은 응답을 받은 사용자와 자동화가 다른 판단을 할 수 있습니다. 조회 결과를 여러 형식으로 전달하는 경계에서 무엇을 비교할지 가상 표본으로 정리합니다. 실제 고객 장애나 특정 클라이언트의 결함을 보고하는 글은 아닙니다.

같은 도구 결과를 누가 어떤 형식으로 읽나요?#

실제 클라이언트가 구조화 값, 텍스트, 화면 요약 중 무엇을 소비하는지 먼저 확인합니다. 모두 같은 경로를 쓴다고 가정하지 말고 서버 응답부터 모델에 전달되는 값과 사용자 표시까지 추적하세요.

데이터 책임자는 대상·기준시점·상태의 의미를 정하고, 서버 담당자는 결과 생성 경로를 확인합니다. 클라이언트 담당자는 어떤 필드가 모델과 화면에 전달되는지 검수하세요. 서버 도입의 전체 범위가 필요하다면 MCP 서버 구축 가이드에서 도구·권한·로그 계약을 먼저 정리할 수 있습니다.

이 표는 2026년 10월 24일 작성한 자사 인수 제안입니다. 특정 제품이 모든 경로를 사용한다는 설명은 아닙니다. 서버 규격과 SDK·호스트·도구 스키마 버전을 함께 기록하고 실제 소비 경로에 맞게 표본을 선택합니다.

MCP 공식 출력 계약은 무엇을 보장하나요?#

MCP의 구조화 결과는 서버가 만든 결과 데이터입니다. 모델이 JSON을 생성하도록 제한하는 기능과 구분해야 합니다. 구조화 결과의 형식과 설명 텍스트의 사실 일치는 각각 확인할 항목입니다.

MCP Tools의 구조화 결과·출력 스키마 사양은 호환성을 위해 구조화 결과의 직렬화 JSON을 TextContent에도 제공하도록 권고합니다. 출력 스키마가 있으면 서버는 그 스키마에 맞는 구조화 결과를 제공해야 하며 클라이언트의 검증은 권고사항입니다. 이 글은 규격 버전 2026-07-28을 기준으로 합니다. 문서의 개별 게시일은 미표기이며 2026년 10월 24일 확인했습니다.

따라서 모든 호스트가 같은 검증을 자동 실행한다고 가정할 수 없습니다. 이 글에서 제안하는 결과 일치 검사와 불일치 시 보류는 업무 인수를 위해 별도로 합의할 조건입니다. MCP가 모든 텍스트 블록을 JSON으로 제한하거나 모든 도구에 구조화 출력을 강제한다는 뜻도 아닙니다.

같은 버전의 CallToolResult 공식 참조는 content, structuredContent, isError를 구분합니다. 도구 호출의 오류 표시와 조회 대상의 업무 상태는 별개입니다. isError가 false여도 재고 상태가 미확인이라면 그 값을 출고 가능으로 바꾸면 안 됩니다. 참조 문서는 같은 날 확인했습니다.

JSON은 미확인인데 설명은 출고 가능이면 통과하나요?#

동일 대상·동일 조회 시점에서 판정이 다르면 결과 불일치로 보류합니다. 어느 형식을 우선할지 정하는 것만으로 원천의 정답을 찾을 수는 없습니다. 아래는 재고 수량이나 실제 운영 실적을 가정하지 않은 가상 조회 표본입니다.

표는 상태 필드만 발췌한 것으로 완전한 MCP 응답 예시는 아닙니다. 담당자는 원천 조회·캐시·어댑터·설명 생성의 어느 경로에서 상태가 달라졌는지 확인합니다. 정정한 뒤에는 합의한 판정이 각 소비 경로에서 유지되는지 다시 봅니다. 내부 표현이 모두 같아도 원천 값이 틀렸다면 별도 데이터 검수가 필요합니다.

여러 표현을 어떻게 같은 결과에서 만드나요?#

승인된 범위의 공통 조회 결과를 확정한 뒤 구조화 값과 호환 JSON, 사람용 설명을 생성하는 방식을 검토합니다. 같은 응답을 만들면서 표현마다 원천을 다시 조회하면 그 사이의 변경으로 기준시점이 갈릴 수 있습니다. 원천 스냅샷이나 버전 식별자를 함께 확인하세요.

호환용 JSON은 지정 블록을 파싱한 뒤 값의 동등성을 비교합니다. 키 순서와 공백이 다른 직렬화 문자열을 그대로 대조해 오류로 처리하지 않습니다. 사람용 요약은 모든 문장을 똑같이 만들기보다 대상·판정 상태·단위·기준시점 등 합의한 사실을 보존하는지 검수합니다.

JSON Schema의 공식 필수 속성 설명에 따르면 properties에 나열한 속성이 기본으로 필수인 것은 아닙니다. required 같은 제약을 실제로 선언했는지 확인해야 합니다. 게시일은 미표기이며 2026년 10월 24일 확인했습니다. 스키마에 선언하지 않은 텍스트와의 사실 일치까지 자동 검증됐다고 해석하지 않습니다.

구조화 결과가 필수인 도구 계약이라면 누락·형식 오류를 자연어 설명으로 덮어 자동화를 이어가지 않도록 합니다. 텍스트만 반환하기로 한 다른 도구는 해당 계약에 맞게 검수합니다. 허용 범위와 출처는 온톨로지 MCP의 읽기·실행 경계와 AI 답변 출처 추적 설계에서 별도로 확인할 수 있습니다.

클라이언트를 바꾸기 전에 무엇을 검수하나요?#

같은 응답 표본을 실제 소비 경로별로 통과시켜 최종 모델 입력과 화면을 비교합니다. 정상 결과와 충돌·누락·허용된 요약 차이를 함께 넣어야 합니다. 아래 조건은 2026년 10월 24일 작성한 자사 검수 제안이며 특정 SDK의 기본 기능 보장은 아닙니다.

비교 전에 권한과 비식별 처리를 각 표현에 적용해야 합니다. 설명을 짧게 하거나 민감 정보를 가리는 의도적 차이는 허용 조건으로 기록하되 구조화 경로에 원문을 남기지 않습니다. 검수 기록도 원문 전체 대신 비식별 표본 ID와 스키마·변환 버전, 충돌 필드와 보류 사유를 중심으로 남깁니다.

알파카랩스와 MCP 조회 검수를 어떻게 정하나요?#

알파카랩스의 공개 온톨로지 서비스는 승인된 AI·MCP 조회 범위, 출처와 대표 질문의 정답·오답·거절·근거 부족을 검수 조건으로 협의한다고 안내합니다. 게시일은 미표기이며 2026년 10월 24일 확인한 자사 제공 범위입니다. 이중 표현의 자동 검수 제품이나 특정 규격·클라이언트의 기본 지원을 보장하는 설명은 아닙니다.

비식별 도구 응답, 실제 사용하는 클라이언트와 어댑터, 대상·기준시점·판정의 기대값을 준비하세요. 결과 필드 계약과 불일치 보류 조건, 소비 경로별 인수 표본 초안을 협의합니다. 별도 산출물과 비용·기간은 원천 접근·보안·연동 범위를 확인한 뒤 정합니다.

MCP 구조화 결과와 텍스트 일치에서 자주 묻는 질문#

structuredContent와 텍스트가 다르면 JSON을 정답으로 쓰면 되나요?

구조화됐다는 사실만으로 원천과 맞는 값이라고 보장할 수 없습니다. 대상·조회 시점·변환 경로를 대조하고 충돌이 해소될 때까지 자동 후속 처리를 보류하는 조건을 정하세요. 모델이 더 그럴듯한 표현을 고르게 하는 방식은 검수를 대신하지 못합니다.

outputSchema를 통과하면 설명과의 일치도 검증된 건가요?

출력 스키마 검증은 선언한 구조화 값의 제약을 확인합니다. 다른 텍스트 블록과 같은 사실을 말하는지는 별도 계약과 비교가 필요합니다. 필수 필드·허용 상태·단위 같은 제약을 실제로 선언했는지도 확인하세요.

모든 MCP 도구에 구조화 결과가 필수인가요?

구조화 결과는 선택적이며 텍스트만 반환하는 도구도 있습니다. 해당 서버 규격과 도구 계약을 먼저 확인하세요. 구조화 결과를 필수로 합의한 조회 도구에서 누락되거나 검증이 실패한 경우는 정상적인 텍스트 전용 도구와 구분합니다.

content의 모든 텍스트를 JSON으로 만들어야 하나요?

모든 텍스트가 JSON이어야 하는 것은 아닙니다. 호환용 직렬화 JSON을 제공하는 블록과 사람이 읽는 요약을 구분하고 각 블록의 용도를 정하세요. 전자는 파싱한 값의 동등성을, 후자는 합의한 대상·상태·시점 등 핵심 사실을 검수합니다.

텍스트에서 개인정보를 가리면 구조화 결과는 그대로 보내도 되나요?

소비자가 구조화 결과를 받을 수 있으므로 그 경로도 같은 권한·비식별 조건을 지켜야 합니다. 승인된 데이터 범위를 먼저 적용한 공통 결과에서 각 표현을 만드세요. 결과의 내부 일치와 원천 정확성·접근 통제는 각각 검수해야 합니다.