Configuração do servidor

Na maioria das hospedagens, o Senso MCP funciona sem nenhuma configuração especial no servidor. No entanto, dependendo da sua configuração, dois pontos merecem atenção.

Regra .well-known (nginx)

Os documentos de descoberta do OAuth (/.well-known/oauth-*) são fornecidos por um plugin do sistema, ou seja, pelo PHP: basta que essas URLs sejam direcionadas para o index.php. Em um servidor “padrão” (regra genérica try_files $uri /index.php), nenhuma diretiva específica é necessária.

Apache

No Apache, a reescrita de URLs do Joomla geralmente é suficiente: não é necessária nenhuma configuração adicional para os documentos .well-known.

Exclusões do ModSec/WAF

Alguns firewalls de aplicações (WAF, ModSecurity) bloqueiam o agente do usuário do cliente e retornam um 403 em /api/…/mcp. Nesse caso, exclua o caminho do servidor MCP das regras envolvidas (exclusão por caminho, não por IP).