Skip to content

docs(mcp): Phase 3 — align error schema#366

Open
erishforG wants to merge 1 commit into
release/1.0from
feat/auto-mcp-spec-phase3-errors
Open

docs(mcp): Phase 3 — align error schema#366
erishforG wants to merge 1 commit into
release/1.0from
feat/auto-mcp-spec-phase3-errors

Conversation

@erishforG

Copy link
Copy Markdown
Owner

무엇

MCP tool spec의 Error Schema를 현재 Phase 3 stdio/tool dispatch 계약과 맞췄습니다.

Refs #292

tools/call은 이미 MCP content envelope 안에 structured error body를 반환하고 있고, auth/sandbox 문서는 별도 error code를 정의합니다. spec 문서의 공통 Error Schema도 이 계약을 한곳에서 볼 수 있어야 합니다.

변경

  • docs/mcp/spec.md 날짜 갱신
  • Phase 3 stub dispatch가 쓰는 tool_error 예시 추가
  • 표준 error code 표에 tool_error, auth, scope, sandbox, dry-run policy 코드를 추가

다음 Phase 힌트

  • 구현 PR이 auth preflight를 머지하면 AUTH_REQUIRED fixture를 stdio smoke contract에 추가
  • 실제 tool implementation 단계에서 Rust enum/serializer와 spec 표를 맞추는 parity test 고려

리스크

Low. 문서 전용 변경이며 CLI, MCP transport, worktree 로직을 변경하지 않습니다.

롤백

이 PR revert만으로 문서 변경 전 상태로 돌아갈 수 있습니다.

Test plan

  • cargo build --quiet
  • cargo fmt --check
  • cargo clippy --all-targets -- -D warnings

@erishforG

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@erishforG erishforG added the auto-improvement Daily auto-generated improvement PR/issue label Jun 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-improvement Daily auto-generated improvement PR/issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant