Corrigir erros do MCP do Democruit e revogar acesso
Identifique erros de permissão, cota, limite de solicitações e sessão expirada do MCP do Democruit e, em seguida, recupere a conexão ou revogue o acesso do cliente.
Para recuperar uma tarefa do MCP do Democruit que falhou, primeiro identifique se o problema está relacionado à autorização, às permissões, aos dados de entrada da ferramenta, a uma cota do produto ou à frequência de solicitações. Cada caso exige uma solução diferente. Reconectar não aumenta a cota do seu plano, e fazer upgrade não corrige uma permissão ausente. Para interromper o acesso de um cliente, abra as configurações do Democruit, encontre Agentes conectados e selecione Revogar acesso.
Etapa 1: Leia o erro antes de tentar novamente
Anote o cliente, a ferramenta solicitada, a mensagem de erro e se a tarefa já havia retornado um resultado. Evite repetir uma solicitação de gravação enquanto o resultado não estiver claro. Primeiro, verifique o documento ou o status da ação afetada para não confundir uma resposta atrasada com uma alteração que falhou.
Use esta tabela para escolher a próxima etapa:
| O que você vê | Categoria provável | Próxima ação |
|---|---|---|
| Autorização necessária ou expirada | Credenciais de conexão | Entre na conta ou autorize novamente, conforme descrito abaixo |
FORBIDDEN | Ferramenta indisponível nos escopos concedidos | Revise as permissões da conexão |
INVALID_ARGUMENTS | Dados de entrada ausentes ou inválidos | Informe a referência do documento ou os dados necessários |
| Uma mensagem de limite do plano com um link para preços | Cota do recurso | Confira a cota e os planos atuais |
| Uma mensagem de limite de solicitações | Frequência de solicitações | Reduza as solicitações e a frequência de consulta |
| Um link de confirmação no painel | Aprovação pendente | Revise a ação no Democruit |
| Um upload ou uma confirmação expirados | Fluxo de trabalho temporário expirado | Inicie uma nova solicitação, se ainda for necessário |
TOOL_EXECUTION_FAILED | Falha na operação da ferramenta | Leia a mensagem e confira o status da tarefa antes de tentar novamente |
Escolha a etapa de recuperação com base no erro retornado antes de tentar novamente.
Etapa 2: Restaure a autorização ou corrija as permissões
Se a autorização estiver ausente, conclua o processo de login e consentimento OAuth do cliente. Verifique se o endpoint é https://mcp.democruit.com/mcp e se você está conectando a conta desejada. O guia de conexão do Claude, ChatGPT e Gemini explica como configurar cada cliente. No Gemini CLI, use /mcp auth democruit quando o servidor precisar de autorização e, em seguida, conclua o login no navegador.
Os tokens de acesso são válidos por uma hora. Um cliente pode atualizar o acesso enquanto o token de atualização estiver válido. Portanto, a validade de uma hora do token de acesso não significa necessariamente que você precise entrar na conta a cada hora. Os tokens de atualização são válidos por 30 dias com duração móvel e 90 dias no total com offline_access, ou por sete dias com duração móvel e 30 dias no total sem essa permissão.
Se o token de atualização tiver expirado ou a conexão tiver sido revogada, autorize novamente. Os códigos de autorização são válidos por cinco minutos. Reinicie o login se um código não utilizado expirar antes da troca. Não cole tokens em um chat para contornar um erro de autorização.
Para FORBIDDEN, confira as permissões exigidas pela ferramenta e os escopos concedidos ao cliente. Os escopos de leitura e gravação são separados por área do produto. Um fluxo de trabalho combinado do application-kit exige permissões de gravação para currículo, carta de apresentação e ATS. Uma conexão para uma tarefa menor pode não ter todas essas permissões. Solicite apenas o acesso necessário para o trabalho que pretende realizar.
Etapa 3: Corrija os dados de entrada da ferramenta
Para INVALID_ARGUMENTS, peça ao assistente que verifique os requisitos de entrada da ferramenta e identifique o que está faltando. Forneça a referência do documento selecionado, a descrição da vaga ou outros dados solicitados. Não deixe o assistente inventar experiências profissionais nem escolher um documento com base apenas em um título incerto.
A ausência de dados de entrada não é um problema de cobrança. Forneça os dados necessários antes de considerar mudanças no plano. Para TOOL_EXECUTION_FAILED, leia a explicação retornada e verifique se existe um documento ou uma ação pendente antes de tentar outra gravação.
Etapa 4: Confira a cota do produto e o link para fazer upgrade
Uma cota do produto limita o uso de recursos de acordo com seu plano do Democruit. O MCP usa as mesmas cotas de plano do aplicativo. Se uma ferramenta informar que o limite do plano foi atingido, confira o uso do recurso afetado na sua conta. Consulte os preços do Democruit para comparar as cotas disponíveis antes de decidir se quer fazer upgrade.
A disponibilidade dos recursos e as cotas dependem do seu plano atual. Não presuma que todos os recursos do aplicativo têm uma ferramenta MCP ou que reconectar, excluir um documento ou esperar um minuto restaure uma cota de IA já consumida.
Por exemplo, reconectar o Claude não redefine uma cota de verificações ATS esgotada. Confira o uso do ATS e os planos atuais antes de decidir como prosseguir. Depois de fazer upgrade, confira o uso da conta e tente realizar a operação desejada uma vez. Se ela continuar bloqueada, entre em contato com o suporte e informe o erro retornado.
Etapa 5: Reduza as solicitações quando houver um limite
O limite padrão da API é de 500 solicitações por minuto, o mesmo padrão usado pelo aplicativo Democruit. Os endpoints de registro OAuth e de tokens têm limites mais restritos. Portanto, o limite de 500 solicitações não permite repetir rapidamente as tentativas de login. Reduza as solicitações repetidas, principalmente as consultas frequentes enquanto uma tarefa está aguardando. Uma resposta HTTP 429 significa que foram feitas solicitações demais. Se houver um intervalo de espera indicado na resposta, aguarde esse período e diminua a frequência antes de tentar novamente. Uma falha de cota ou de limite de solicitações também pode aparecer dentro de TOOL_EXECUTION_FAILED. Por isso, leia a explicação em vez de se basear apenas nesse código genérico.
Esperar o período do limite de solicitações passar não repõe uma cota do produto esgotada. Uma conexão pode ainda ter cota para usar um recurso e, mesmo assim, enviar solicitações rápido demais. Confira qual limite o erro descreve.
Uma resposta encurtada é outro caso. Respostas grandes são paginadas em grupos de 20 itens ou resumidas, a menos que detail=true. Continue usando as informações de paginação retornadas ou solicite detalhes quando a tarefa exigir o conteúdo completo. Uma página curta, por si só, não indica um erro de cota.
Etapa 6: Resolva uma confirmação pendente ou um upload expirado
As ferramentas destrutivas aguardam confirmação no painel do Democruit. Abra o link retornado e confira a ação exata. O assistente pode consultar get_action_status; ele não deve informar que uma exclusão foi concluída enquanto a aprovação estiver pendente.
Uma confirmação pendente não é um erro. O link de aprovação retornado abre a ação no Democruit. Confira o alvo antes de aprovar. Uma ação recusada retorna DENIED, e uma ação sem decisão acaba retornando EXPIRED.
A confirmação expira após dez minutos. Se ainda quiser realizar a ação depois da expiração, inicie uma nova solicitação de confirmação e revise-a novamente. Os uploads também têm validade de dez minutos e tamanho máximo de 10 MB. As finalidades de importação de currículo e upload de ATS aceitam apenas PDF. Crie um novo upload se o anterior expirar e use o tipo solicitado e o tamanho exato do arquivo.
Etapa 7: Desconecte e revogue o acesso
- Abra as configurações da conta do Democruit.
- Encontre o cliente em Agentes conectados e confira os escopos listados.
- Selecione Revogar acesso para a conexão que deseja interromper.
- Aguarde a confirmação de que a revogação foi concluída. Se a página de configurações informar um erro, tente novamente nessa página ou entre em contato com o suporte.
- Remova ou desative o servidor do Democruit no seu cliente de IA se também quiser impedir que ele ofereça ferramentas ou solicite que você entre na conta.
- Se conectar esse cliente novamente mais tarde, conclua a autorização e confira outra vez os escopos solicitados.
Revogue as credenciais no Democruit e, se não for mais usar o cliente, remova o servidor dele também.
A revogação desativa a autorização do cliente, os tokens de acesso e os tokens de atualização para a sua conta. Remover uma entrada de servidor do cliente é uma etapa de configuração separada. Use o controle Revogar acesso do Democruit para invalidar as credenciais.
Revogar o acesso não exclui sua conta nem seus documentos do Democruit. A ação impede futuras solicitações autorizadas que usem essas credenciais. Para o conteúdo que o cliente de IA já recebeu, confira o histórico e os controles de dados desse cliente. Esta revogação não define regras de exclusão ou retenção para outro serviço. Consulte a Política de Privacidade para conhecer as práticas de dados publicadas pelo Democruit.
Se a tarefa continuar bloqueada
Entre em contato pelo endereço [email protected] e informe o nome do cliente, o nome da ferramenta e a mensagem de erro. Explique se você estava entrando na conta, lendo um documento, salvando uma alteração ou aguardando uma confirmação. Não inclua senhas, tokens nem conteúdo privado de documentos na mensagem de suporte.