Quando o MCP do Taskavel não se comportar como esperado, verifique a ligação por esta ordem: endpoint, método de autenticação, conta ligada, associação ao projeto, função e dados de entrada da ferramenta. Esta ordem evita substituir credenciais ou alterar dados do projeto quando o problema real é um URL ou uma sessão de conta incorretos.
O cliente não consegue ligar-se ou autenticar-se
Para o serviço público do Taskavel, utilize exatamente:
https://taskavel.com/mcp/taskavel
Para uma instalação alojada por si, utilize o URL apresentado em Configurações da conta → Integração de IA (MCP). Não utilize um anfitrião copiado de um exemplo, o URL de uma página ou um endpoint de outro ambiente.
O ChatGPT e o Claude Desktop devem utilizar o respetivo fluxo de ligação OAuth. Volte a abrir a configuração da ligação, confirme o endpoint e repita a aprovação no Taskavel com a conta pretendida. Um cliente CLI precisa de um PAT válido fornecido como credencial Authorization: Bearer. Se o token tiver sido revogado ou não tiver sido guardado na criação, crie um novo token identificado e atualize a definição privada de segredos do cliente; o Taskavel não volta a revelar posteriormente o valor de um token existente.
O servidor liga-se, mas falta trabalho esperado
Peça ao cliente que liste os projetos acessíveis. Se o projeto não estiver no resultado, verifique a conta Taskavel que aprovou OAuth ou criou o PAT. Depois, confirme a associação dessa conta ao projeto. O MCP não contorna as regras de associação nem combina o acesso de outra conta.
Se o projeto estiver presente, mas o nome for ambíguo, peça ao cliente que apresente as opções correspondentes e utilize o ID devolvido. Faça o mesmo com colunas, marcos, etiquetas e tarefas antes de tentar uma escrita. Uma pesquisa falhada deve-se frequentemente a um identificador pouco claro, não a uma falha de autorização.
Uma ação de escrita é recusada ou produz um resultado inesperado
Verifique a função do utilizador ligado no projeto. Os convidados podem ler o conteúdo e acompanhar tarefas, mas não podem alterar tarefas, comentários ou anexos. As ações de proprietário e administrador, como a gestão de membros, exigem essas funções. Não tente novamente com a credencial de um colega; se o acesso for pretendido, altere a associação através do proprietário adequado.
Perante um comportamento inesperado dos dados de entrada, consulte a página gerada da ferramenta. Os esquemas indicam os campos obrigatórios e as descrições esclarecem casos especiais. As descrições das tarefas têm de ser HTML com formatação válido, não Markdown. Um número de comentário apresentado como #123 identifica um comentário, não uma tarefa. Liste os marcos existentes antes de criar um e escolha uma coluna real devolvida pelo servidor.
Uma operação destrutiva é recusada
A eliminação permanente tem intencionalmente duas condições: a tarefa já tem de estar arquivada e a chamada tem de incluir confirmação explícita. Consulte ou arquive primeiro a tarefa. Se o objetivo for apenas removê-la do trabalho ativo, pare depois de arquivar e reveja o resultado; a eliminação não é um atalho geral de limpeza.
Continua bloqueado
Reúna o nome do cliente, o tipo de endpoint (OAuth ou PAT), o erro exato sem segredos e a informação sobre se um pedido apenas de leitura, como listar projetos, funciona. Não inclua um token no relatório. Esta informação permite distinguir um problema de ligação de um problema de conta, função ou dados da ferramenta sem expor credenciais.