# Status real do `.env` legado TIM/FIRST

Esta versão removeu a duplicidade do `.env.example` e do `mcp_servers/legacy_tim_mcp/.env.example`.

## Decisão aplicada

- `TIM_MCP_USE_MOCK=false` por padrão.
- Mock só é usado quando você definir explicitamente `TIM_MCP_USE_MOCK=true`.
- Os defaults reais encontrados no `agent_contas_first` original foram copiados.
- Secrets e URLs que não existiam no original continuam vazios de propósito.

## Defaults efetivamente encontrados no original

| Variável nova | Valor preenchido | Origem no legado |
|---|---|---|
| `TIM_PROFILE_BILL_URL` | `http://10.151.3.100:8000` | `TIM_URL_PERFIL_FATURA` / `tim_profile_bill_url` |
| `TIM_QUERY_VAS_URL` | `http://10.151.3.100:8000` | `TIM_URL_CONSULTA_VAS` / `TIM_CONSULTA_URL` / `tim_query_url` |
| `TIM_BLOCK_VAS_URL` | `http://10.151.3.100:8000/customers/v1/partialServiceBlocking` | `TIM_URL_BLOQUEIO_VAS` / `TIM_BLOQUEIO_URL` / `tim_block_url` |
| `TIM_CLIENT_ID` | `AIAGENTCR` | `tim_default_client_id` |
| `TIM_USER_ID` | `AIAGENTCR` | usado como default nos commands/SR |
| `TIM_DEFAULT_CSP_ID` | `740` | `tim_default_csp_id` |
| `TIM_DEFAULT_CHANNEL` | `APP` | `tim_default_channel` |
| `TIM_BLOCK_VAS_OPERATION_TYPE` | `block` | `tim_block_operation_type` |
| `TIM_BLOCK_VAS_PAYLOAD_MODE` | `auto` | `tim_block_payload_mode` |
| `TIM_BLOCK_VAS_ACCEPT_ENCODING` | `gzip,deflate` | `tim_block_accept_encoding` |

## Valores que permanecem vazios

Permanecem vazios porque o pacote original não trouxe valores reais para eles:

- `TIM_COMPLETE_INVOICES_URL`
- `TIM_CONTRATO_URL`
- `TIM_BILL_PDF_URL`
- `TIM_PROTOCOL_URL`
- `TIM_CUSTOMER_CONTESTATION_URL`
- `TIM_SERVICE_REQUEST_STATUS_URL`
- `TIM_CANCEL_VAS_URL`
- `TIM_SMS_URL`
- `TIM_TRACKING_ACTIVITIES_URL`
- todos os `*_AUTH`, `TIM_AUTHORIZATION_OAM`, `TIM_CN_FIELD`, `TIM_TYPE_FIELD`

## Onde alterar

Para executar localmente:

```bash
cp .env.example .env
cp mcp_servers/legacy_tim_mcp/.env.example mcp_servers/legacy_tim_mcp/.env
```

Depois preencha apenas os endpoints/secrets que existirem no seu ambiente.