Solução de problemas
Identifique se o problema é o acesso à ligaçã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 por identificar o estágio de falha: adicionar a ligação, descobrir ferramentas, executar uma ferramenta ou verificar uma gravação. Capte a hora e uma breve descrição antes de alterar as definições.
A ligação não pode ser alcançada#
Verifique o endpoint atribuído exato e se o cliente AI suporta o seu método de transporte e autenticação. Um endereço residencial de plataforma não é um terminal MCP. Utilize a ligação segura normal; não ignore um aviso de certificado.
Se a mesma ligação atribuída funcionou anteriormente, informe quando foi bem-sucedida pela última vez e o que foi alterado no cliente. Evite eliminar os detalhes da ligação ativa antes que uma substituição seja verificada.
Referência de erro#
| Sintoma | O que verificar |
|---|---|
401 na ligação ou descoberta | Credencial ausente, errada, caducada ou revogada; cabeçalho ou endpoint incorreto. |
403 para uma operação | Âmbito da credencial, permissão de ferramenta ou função de serviço upstream; identificar qual a camada que o devolveu. |
429 | Pedido de subsídio excedido; respeite o atraso de novas tentativas e reduza a frequência de solicitação. |
404 | O endpoint ou registo 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 o estágio de solicitação. |
| Argumentos inválidos | Campo obrigatório, tipo de entrada, campo extra não compatível ou identificador incompatível. |
| Ligado, 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 o 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 de leitura apenas acordado. Se falhar, registe 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 ecrã com informações confidenciais ocultas ou o texto do erro relevante, e não uma exportação completa da conversa ou uma configuração que contenha uma chave.