---
title: MCP e traces
description: Observabilidade read-only, eventos append-only e recursos expostos.
context: Como consultar artefatos e traces sem substituir a fonte canônica local.
---

# MCP e traces

O MCP do SDD é read-only. Ele expõe artefatos, contexto, traces, clients doctor e adapters runtime para consulta. Ele não aprova checkpoints e não substitui `traceability-map.yaml`.

## Servidor MCP

```bash
sdd mcp serve --root .
sdd mcp config
```

Use `.mcp.json` e `.cursor/mcp.json` em projetos consumidores quando precisar conectar clients MCP. Esses arquivos podem carregar paths absolutos e não devem ser versionados no repositório da camada.

## Traces

```bash
sdd trace list
sdd trace show <id>
sdd trace summary --orchestration "minha feature" --json
sdd trace doctor
```

## Eventos

| Campo | Regra |
|---|---|
| `agent` | Client/adapter efetivamente invocado |
| `selected_model` | Modelo resolvido pelo SDD |
| `observed_model` | Modelo reportado pelo provider quando houver metadata confiável |
| `confidence` | `observed`, `estimated` ou `unreported` |
| `usage` | Tokens/custo real ou estimado quando possível |

Não inferir `observed_model` a partir de config. Quando o provider não reporta metadata, preserve `selected_model` e marque confiança como não reportada.
