TanStack AI 0.63.0에서 MCP 서버와 하위 에이전트 입력 처리는 무엇이 달라졌나요?
TanStack AI 0.63.0이 MCP 서버 생성 API와 에이전트 입력 스키마 검증을 추가했습니다. MCP 도구를 별도 서버 구현 없이 연결하고, 부모 에이전트가 만든 하위 에이전트 입력을 실행 전에 차단할 수 있어 에이전트 워크플로의 구현 범위와 실패 처리가 달라집니다.
적용 조건·범위: 제품명·버전·API 이름·발표 시각은 2026년 9월 28일 KST에 공식 릴리스와 대조했습니다. 실제 프로젝트의 업그레이드·MCP 연결·런타임 동작은 이 글 작성 과정에서 실행하지 않았으므로 미확인입니다.
수집 범위: 2026년 9월 27일 09:00부터 9월 28일 09:00까지 KST 기준으로 공개된 공식 발표를 확인했습니다. 최근 7일 일반 글과 짧은 소식의 제목·제품·원문 URL을 대조했으며, 같은 발표를 다룬 짧은 소식은 내부 링크로 연결했습니다.
주요 AI 소식
TanStack AI 0.63.0, MCP 서버 생성과 에이전트 입력 검증 추가
변경 요약: TanStack AI 0.63.0은 @tanstack/ai-mcp에서 MCP 서버를 만들고 stdio로 제공하는 API, MCP 서버가 사용자 입력을 요청할 때 작업을 일시 정지하는 인터럽트, 하위 에이전트 입력을 실행 전에 검증하는 스키마를 추가했습니다. 취소되거나 거절된 도구 결과의 상태도 일반 오류와 구분해 보존합니다.
발표·적용 시점: 공식 GitHub 릴리스는 2026년 9월 27일 22:14 KST에 공개됐습니다. 버전 0.63.0 릴리스이며, 공식 원문은 별도의 GA 선언으로 표현하지 않았으므로 정식 일반 제공으로 확대 해석하지 않습니다.
달라진 내용: 새 createMCPServer와 serveMCPStdio를 이용하면 TanStack AI 도구를 MCP 서버로 구성할 수 있습니다. MCP 클라이언트는 2026-07-28 사양을 먼저 시도하고 2025 핸드셰이크로 폴백합니다. 서버의 입력 요청은 mcp_input 인터럽트로 전달되며, 애플리케이션은 resolveInterrupt 또는 cancel()로 후속 처리를 선택할 수 있습니다.
영향 대상: TanStack AI로 에이전트, 서브에이전트, MCP 도구를 구성하는 개발자가 직접 영향을 받습니다. defineAgent의 선택적 inputSchema를 사용하면 부모 모델이 생성한 입력을 자식 에이전트가 시작되기 전에 검증하고, 유효하지 않은 입력은 도구 오류로 반환할 수 있습니다. 입력 스키마는 tool mode에서 사용하는 기능이므로 기존 라우팅 방식과 함께 확인해야 합니다.
필요한 조치: 업그레이드 전 MCP 사양 협상과 폴백 동작을 통합 테스트하고, 기존 취소·거절 결과 처리 코드가 새 outcome 값을 보존하는지 확인합니다. 서브에이전트에는 필수 필드와 허용 범위를 inputSchema로 정의하고, 검증 실패가 재시도·사용자 수정·중단 중 어느 흐름으로 이어질지 명시하는 편이 안전합니다.
관련 BlogFlow 소식: TanStack AI 0.63.0 변경 요약
공식 출처: TanStack AI — @tanstack/ai@0.63.0 릴리스
개발자가 확인할 점
- 연결: MCP 사양 협상·폴백을 실제 연결 로그로 확인하세요.
- 입력: 잘못된 입력이 하위 에이전트를 시작하지 않는지 테스트하세요.
- 실패 처리:
cancelled·denied를 구분한 회귀 테스트를 통과한 뒤 업그레이드하세요.
공식 출처와 확인 기준
제품명·버전·API 이름·발표 시각은 2026년 9월 28일 KST에 공식 릴리스와 대조했습니다. 실제 프로젝트의 업그레이드·MCP 연결·런타임 동작은 이 글 작성 과정에서 실행하지 않았으므로 미확인입니다.
같이 읽으면 좋은 글
이 글이 도움이 되었나요?
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.