---
title: "Solução de problemas de conexão"
url: "https://www.sensomcp.com/pt/documentacao/conexao-mcp/solucao-problemas-conexao"
lang: "pt-BR"
description: "Solução de problemas na conexão MCP do Senso MCP: os problemas mais comuns (configuração do servidor, firewall) e suas soluções."
category: "Servidor MCP e conexão com IA"
author: "Fred Oliver"
published: "2026-09-07T14:58:19+00:00"
modified: "2026-09-28T07:33:42+00:00"
---

# Solução de problemas de conexão

- Resumo: Esta página reúne as causas mais comuns de falha na conexão com o Senso MCP e suas soluções: erro **401** em um site excessivamente protegido, bloqueio **403** por um WAF ou ModSecurity no caminho do servidor MCP, e Download ID truncado que impede as atualizações. Ela termina com uma checklist de HTTPS, reescrita de URLs, documentos `.well-known` e plugins ativados.
- Resolver os erros de conexão mais comuns.
- Avançado
- 401-site-excessivamente-protegido, 401 / site excessivamente protegido
- bloqueio-modsec-waf, Bloqueio ModSec/WAF
- download-id-truncado, Download ID truncado
- checklist, Checklist

## 401 / site excessivamente protegido

Um site muito protegido pode bloquear a conexão necessária para a autorização e retornar um erro **401** na página de autorização. Certifique-se de que o fluxo de login (componente de usuários) continue acessível para permitir a etapa do OAuth.

## Bloqueio ModSec/WAF

Alguns firewalls de aplicações (WAF, ModSecurity) bloqueiam o agente do usuário do cliente e retornam **403** em `/api/…/mcp`. A solução consiste em **excluir o caminho do servidor MCP** das regras aplicáveis.

## Download ID truncado

Sem relação com a conexão, mas bastante comum: um **Download ID** inserido de forma incompleta impede a atualização das extensões pagas. Verifique se ele foi colado **por completo** nas configurações de atualização do Joomla.

## Checklist

- site servido em **HTTPS** com um certificado válido;
- **reescrita de URLs** ativada;
- documentos `.well-known` acessíveis;
- plugins Senso MCP **ativados**;
- caminho do servidor MCP não bloqueado pelo WAF.