Solução de problemas

401 ou autenticação necessária

Confirme que o header tem o formato Authorization: Bearer shx_live_... e que a chave não foi revogada.

O cliente tenta iniciar OAuth

O acesso atual usa API key. No OpenCode, defina oauth: false. Clientes que priorizam a descoberta OAuth podem exigir configuração adicional e não devem ser considerados validados sem um teste real.

health_check não aparece

Confirme que o cliente está usando Streamable HTTP, recarregue a configuração MCP e verifique se o endpoint termina em /mcp.

O agente inventou um componente

Instrua o agente a revisar kitGaps, usar somente componentes listados e executar check_fidelity no TSX final.

A chave foi exposta

Revogue-a imediatamente em API keys e crie outra para o cliente afetado.