Solução de problemas do MCP
Encontre o próximo passo para um problema de conexão.
Não é possível conectar um cliente hospedado
Verifique se a URL configurada é https://mcp.altifigence.com/cloud-mcp e se o cliente suporta Streamable HTTP com OAuth. Siga as orientações de conexão e o estado atual de qualificação. A página de integridade do servidor e os metadados OAuth não provam que um cliente específico concluiu a autorização.
Resultado | Próximo passo |
|---|---|
HTTP 401 | Reconecte o Altifigence Cloud se a autorização expirou ou foi revogada; conclua novamente o fluxo de autorização do cliente |
HTTP 403 | Confira a organização consentida, o acesso atual ao projeto e a política de ferramentas; reconecte com a permissão necessária depois que a organização habilitar a ferramenta |
Ferramentas vazias ou ausentes | Confira o catálogo lançado, a aprovação explícita da organização e o novo consentimento para cada ferramenta; atualizar um token antigo não pode adicionar ferramentas |
Leitura do espaço de trabalho indisponível | Confira o estado e o acesso ao espaço de trabalho na Cloud; tente novamente quando ele estiver pronto |
Ferramentas de execução ausentes | Solicite um novo consentimento |
Ferramentas de gravação ausentes | Solicite um novo consentimento |
Conflito na alteração de arquivo | Leia o manifesto e o arquivo novamente, revise alterações simultâneas e envie a alteração pretendida com as revisões atuais |
Criação de projeto ou mutação do Git não confirmada | Inspecione a lista de projetos, o repositório ou o estado remoto antes de tentar novamente; repetir uma criação, um commit ou um push pode ter efeitos indesejados |
Exclusão de projeto aceita | Acompanhe o estado do projeto/espaço de trabalho até o fim da limpeza; aceitação não significa conclusão |
Transferência pelo provedor Git negada | Confira o repositório, a branch e a conexão atual do provedor selecionados; a ferramenta não pode contornar permissões do provedor |
Operação de runtime não confirmada | Leia o estado do runtime e guarde o ID da operação; a retomada usa o ID da operação do runtime parado |
Geração do projeto, versão do arquivo ou política alterada | Obtenha uma nova estimativa e revise sua oferta selecionada e a política de consumo |
Envio não confirmado | Inspecione o mesmo ID de job; tente novamente somente com argumentos idênticos e esse mesmo ID |
Resultado ainda não pronto | Leia o estado do job antes de solicitar o resultado novamente |
Créditos insuficientes | Revise o estado de cobrança da organização na Cloud |
HTTP 413 | Reduza a solicitação aos argumentos do esquema de ferramenta descoberto |
HTTP 501 de uma ferramenta local | O runtime instalado não implementa essa operação; apenas a descoberta não comprova suporte |
HTTP 503 | Aguarde a recuperação do serviço; mantenha o endpoint configurado |
Uma solicitação de leitura não inicia nem reinicia um projeto. Nomes de ferramentas desconhecidos ou não autorizados não habilitam edição nem execução. Corrija a condição de conexão ou acesso antes de tentar novamente; não forneça credenciais alternativas nos argumentos.
Solicitações em excesso
Se uma resposta incluir HTTP 429, aguarde o período especificado em Retry-After antes de tentar novamente. Evite tentativas repetidas de registro ou entrada.
Contatar o suporte
Contate o Suporte da Altifigence com o nome do cliente, a versão, o horário do problema e a mensagem de erro após remover informações sensíveis. Não inclua credenciais, cookies ou conteúdo do projeto.
Recuperar sem duplicar trabalho
Ponto de falha | Inspecionar antes de tentar novamente |
|---|---|
Identidade ou descoberta | Versão do cliente, endpoint, entrada/sessão e lista de ferramentas consentidas. |
Continuação da leitura de arquivo | Versões do arquivo e do manifesto; reinicie se o snapshot tiver mudado. |
Gravação de arquivo, commit ou push | Arquivo salvo atual, repositório e estado remoto. |
Envio de job | O ID e o estado do job existente; mantenha a identidade original. |
Entrada de terminal ou solicitação de IA | Sessão/saída atual; não reproduza a entrada automaticamente. |
Registre a menor solicitação reproduzível com marcadores para os dados do projeto. Preserve o código de erro, o estado HTTP, o identificador da solicitação, se exibido, e o horário. Remova tokens e conteúdo do código-fonte antes de compartilhar um diagnóstico.