---
title: "Registro e depuração"
url: "https://www.sensomcp.com/pt/documentacao/administracao-avancada/depuracao"
lang: "pt-BR"
description: "Registro em log e depuração do Senso MCP: um modo detalhado para diagnosticar a comunicação entre o assistente e seu site."
category: "Administração avançada"
author: "Fred Oliver"
published: "2026-09-07T15:00:19+00:00"
modified: "2026-09-28T07:36:21+00:00"
---

# Registro e depuração

- Resumo: Esta página explica o registro do Senso MCP: ativação do Modo de depuração nas opções do componente, registro das chamadas de ferramentas em administrator/logs com ocultação dos campos sensíveis e truncamento dos valores longos, leitura dos erros e casos frequentes, como o 401 de um site protegido, o 403 de um WAF ou o Download ID truncado.
- Diagnosticar problemas com a ajuda dos logs.
- Avançado
- activer-les-logs, Ativar os logs
- lire-les-erreurs, Ler os erros
- cas-frequents, Casos frequentes

## Ativar os logs

O componente oferece um **Modo de depuração** (Opções → Segurança), **desativado por padrão**. Depois de ativado, **cada chamada de ferramenta é registrada com seus parâmetros** em `administrator/logs/com_sensomcp.log.php`.

Duas proteções resguardam esse registro: os **campos sensíveis** (senhas, tokens, chaves de licença, Download ID…) são **ocultados**, e os **valores longos** (conteúdo de artigos, arquivos) são **truncados**.

O registro ainda pode conter conteúdo e dados pessoais: ative o Modo de depuração apenas para fins de diagnóstico e desative-o em seguida.

\[captura de tela da opção Modo de depuração\]

## Ler os erros

Abra `administrator/logs/com_sensomcp.log.php`. Cada linha indica a data, o nível, o endereço IP, a categoria e a mensagem — a ferramenta chamada e seus parâmetros. Localize a chamada em questão para identificar a causa do erro.

## Casos frequentes

- **401** na autorização: site protegido demais — consulte *Solução de problemas de conexão*;
- **403** no servidor MCP: bloqueio do WAF/ModSec — consulte *Configuração do servidor*;
- **atualizações indisponíveis**: Download ID truncado ou licença expirada;
- **nenhuma ferramenta exposta**: plugin desativado ou dependência ausente (por exemplo, YOOtheme Pro para o add-on YOOtheme).