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 cloud.execute e confira o lançamento, a política da organização e o acesso ao runtime do projeto

Ferramentas de gravação ausentes

Solicite um novo consentimento cloud.write e confira as permissões explícitas de ferramenta e projeto da organização

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.