João Henrique
b541f502ba
- Adicionado estrutura completa do projeto - Configurado MCP server para Premiere Pro - Adicionado documentação e skills - Configurado Gitignore para o projeto
1016 B
Executable File
1016 B
Executable File
Recommendation 28: MCP error taxonomy and allocation
Evidence
MCP 2026-07-28 reserves JSON-RPC server error codes -32020 through -32099 for the specification and defines typed errors for header mismatch, missing capability, and unsupported version.
Proposed improvement
Create a central error registry that keeps protocol-reserved errors separate from Premiere, bridge, validation, authentication, and internal failures. Map errors to retryability, mutation certainty, safe client text, and telemetry class.
Acceptance criteria
- No implementation-defined error uses the protocol-reserved range.
- Every bridge failure states whether a host mutation may have committed.
- Stack traces and private paths never reach clients.
- Snapshot tests lock codes, shapes, and backward-compatible text fallbacks.
A structured error reports uncertainty; it must not convert unknown host state into failure or success.