Solução de problemas
Identifique se o problema é o acesso à conexão, às permissões da ferramenta ou ao serviço upstream.
Traduzido automaticamente do inglês. Ler o original em inglês
2 min de leitura · Guia do cliente
Comece identificando o estágio de falha: adicionar a conexão, descobrir ferramentas, executar uma ferramenta ou verificar uma gravação. Capture a hora e uma breve descrição antes de alterar as configurações.
A conexão não pode ser alcançada#
Verifique o endpoint atribuído exato e se o cliente AI oferece suporte ao seu método de transporte e autenticação. Um endereço residencial de plataforma não é um terminal MCP. Use a conexão segura normal; não ignore um aviso de certificado.
Se a mesma conexão atribuída funcionou anteriormente, informe quando foi bem-sucedida pela última vez e o que mudou no cliente. Evite excluir detalhes da conexão ativa antes que uma substituição seja verificada.
Referência de erro#
| Sintoma | O que verificar |
|---|---|
401 na conexão ou descoberta | Credencial ausente, errada, expirada ou revogada; cabeçalho ou endpoint incorreto. |
403 para uma operação | Escopo de credencial, permissão de ferramenta ou função de serviço upstream; identificar qual camada o retornou. |
429 | Solicitação de subsídio excedido; respeite o atraso de novas tentativas e reduza a frequência de solicitação. |
404 | O endpoint ou registro referenciado pode estar errado ou indisponível; verifique o caminho exato e o contexto. |
5xx ou indisponível | Problema de plataforma ou serviço upstream; tempo de captura e estágio de solicitação. |
| Argumentos inválidos | Campo obrigatório, tipo de entrada, campo extra não compatível ou identificador incompatível. |
| Conectado, mas sem ferramenta esperada | Escopo atribuído, adição inativa ou não verificada ou descoberta de cliente obsoleto. |
| As ferramentas aparecem, mas as chamadas falham | Autorização upstream, direito de conta ou entrada específica da operação. |
Estes são pontos de partida para diagnóstico. A origem real de um erro HTTP é importante; o erro de permissão de um serviço não é corrigido enfraquecendo a autenticação MCP.
Uma sequência de diagnóstico segura#
Confirme o endpoint, atualize a lista de ferramentas, compare-a com a transferência e execute o teste somente leitura acordado. Se falhar, registre o nome da ferramenta e o erro redigido. Pare antes de repetir uma ação de gravação cujo resultado seja incerto.
O que enviar suporte#
Use o lista de verificação de suporte. Inclua uma captura de tela com informações confidenciais ocultas ou o texto do erro relevante, e não uma exportação completa da conversa ou uma configuração contendo uma chave.