first_contas/docs/TIM_LEGACY_ENV_MAPPING.md

TIM/FIRST Legacy Environment Mapping

Este arquivo documenta o que foi recuperado do agent_contas_first original para configurar o MCP server adaptado.

Resultado da auditoria

O pacote original não trouxe .env, Secret, ConfigMap ou arquivo com credenciais reais. A fonte disponível foi agente_contas_tim/config.py, que define aliases e alguns defaults. Por isso:

• URLs com default no código foram preenchidas.
• URLs que no legado tinham default vazio permaneceram vazias.
• Tokens/Authorization permaneceram vazios por segurança e porque não estavam no pacote.
• O MCP server agora aceita tanto os nomes novos quanto os aliases antigos.

Tabela de mapeamento

Variável nova	Alias/variável no legado	Valor inferido	Status
TIM_QUERY_VAS_URL	TIM_URL_CONSULTA_VAS, TIM_CONSULTA_URL	http://10.151.3.100:8000	preenchido
TIM_QUERY_VAS_AUTH	TIM_QUERY_AUTH, TIM_CONSULTA_AUTH	vazio	requer secret
TIM_BLOCK_VAS_URL	TIM_URL_BLOQUEIO_VAS, TIM_BLOQUEIO_URL	http://10.151.3.100:8000/customers/v1/partialServiceBlocking	preenchido
TIM_BLOCK_VAS_AUTH	TIM_BLOCK_AUTH, TIM_BLOQUEIO_AUTH	vazio	requer secret
TIM_CANCEL_VAS_URL	TIM_CANCELLATION_URL, TIM_CANCELAMENTO_URL	vazio	não encontrado no pacote
TIM_CANCEL_VAS_AUTH	TIM_CANCELLATION_AUTH, TIM_CANCELAMENTO_AUTH	vazio	requer secret
TIM_AUTHORIZATION_OAM	TIM_CANCELLATION_AUTH_OAM, TIM_CANCELAMENTO_AUTH_OAM, TIM_CANCELAMENTO_AUTHORIZATION_OAM	vazio	requer secret
TIM_CN_FIELD	TIM_CANCELLATION_CN_FIELD, TIM_CANCELAMENTO_CN_FIELD	vazio	não encontrado no pacote
TIM_TYPE_FIELD	TIM_CANCELLATION_TYPE_FIELD, TIM_CANCELAMENTO_TYPE_FIELD	vazio	não encontrado no pacote
TIM_PROFILE_BILL_URL	TIM_URL_PERFIL_FATURA	http://10.151.3.100:8000	preenchido
TIM_COMPLETE_INVOICES_URL	TIM_COMPLETE_INVOICES_URL	vazio	não encontrado no pacote
TIM_CONTRATO_URL	TIM_CONTRATO_URL	vazio	não encontrado no pacote
TIM_BILL_PDF_URL	TIM_URL_INVOICE_RECOVER	vazio	não encontrado no pacote
TIM_BILL_PDF_AUTH	TIM_INVOICE_RECOVER_AUTH	vazio	requer secret
TIM_PROTOCOL_URL	TIM_PROTOCOL_URL	vazio	não encontrado no pacote
TIM_CUSTOMER_CONTESTATION_URL	TIM_CUSTOMER_CONTESTATION_URL	vazio	não encontrado no pacote
TIM_SERVICE_REQUEST_STATUS_URL	TIM_SERVICE_REQUEST_STATUS_URL	vazio	não encontrado no pacote
TIM_SMS_AUTH	SMS_BARCODE_AUTH, TIM_SMS_AUTH	vazio	requer secret
TIM_TRACKING_ACTIVITIES_URL	TIM_TRACKING_ACTIVITIES_URL	vazio	não encontrado no pacote
TIM_TRACKING_ACTIVITIES_USER_LOGIN	igual	vazio	obrigatório no legado, não encontrado
TIM_TRACKING_ACTIVITIES_CHANNEL	igual	vazio	obrigatório no legado, não encontrado
TIM_TRACKING_ACTIVITIES_CLIENT_ID	igual	vazio	obrigatório no legado, não encontrado

Implicação para teste

Para teste local sem rede TIM, use:

TIM_MCP_USE_MOCK=true

Para teste integrado real, altere para:

TIM_MCP_USE_MOCK=false

e preencha as URLs/secrets vazias acima.