Utilize o servidor MCP do Taskavel quando um cliente de IA precisar de acesso autenticado ao seu trabalho. Antes de ligar, determine se o cliente consegue concluir OAuth num navegador ou se precisa de um token de acesso pessoal. A resposta determina como o cliente comprova a sua identidade perante o Taskavel.
O endpoint público do Taskavel é:
https://taskavel.com/mcp/taskavel
Se utilizar uma instância Taskavel alojada por si, copie o URL apresentado em Configurações da conta → Integração de IA (MCP). Não substitua o URL de produção por um nome de anfitrião de exemplo retirado de um excerto de configuração.
Utilize OAuth para clientes com ligação interativa
OAuth é a opção adequada para um cliente com um fluxo interativo de «adicionar ligação» ou «adicionar aplicação». Este encaminha-o para o Taskavel, onde inicia sessão, se necessário, e aprova a ligação. O cliente passa então a atuar como o seu utilizador Taskavel e continua sujeito às associações e restrições de função normais.
O ChatGPT e o Claude Desktop têm fluxos documentados nos guias seguintes. Adicione apenas o endpoint do Taskavel indicado acima e conclua a aprovação no Taskavel. Não crie nem cole um token pessoal num cliente que possa utilizar OAuth.
Depois de autorizar, abra o cliente e faça uma pergunta inofensiva, como «Lista os meus projetos do Taskavel». Uma resposta bem-sucedida confirma a ligação MCP e a conta efetiva. Se não aparecerem os projetos esperados, verifique a conta Taskavel e a associação aos projetos antes de voltar a ligar.
Utilize um PAT para clientes CLI
O Claude Code, o Codex e configurações semelhantes de linha de comandos utilizam normalmente um token de acesso pessoal. No Taskavel, abra Configurações da conta → Integração de IA (MCP) e crie um token com um nome específico, por exemplo o cliente e a máquina que o vão utilizar. Copie o valor quando este for apresentado e coloque-o apenas num armazenamento local de segredos ou numa variável de ambiente.
Configure o cliente com o endpoint e um cabeçalho Authorization: Bearer. Nunca inclua um token num repositório, numa captura de ecrã ou num ficheiro de configuração partilhado. Um token com nome por cliente ou máquina permite uma revogação posterior precisa.
Verifique a configuração antes de utilizar ferramentas de escrita
Comece por pedir ao cliente que descubra dados: listar projetos, listar as suas tarefas ou consultar uma tarefa conhecida. Confirme que a resposta corresponde à conta Taskavel com sessão iniciada. Depois, experimente um pedido de baixo risco, como obter a visão geral de um quadro. Só então peça ao cliente que crie, mova ou atualize trabalho.
Os erros de ligação são geralmente erros de endpoint ou autenticação; os dados em falta resultam normalmente da conta, associação ou função. Consulte a resolução de problemas para seguir as verificações por ordem e leia segurança e revogação antes de distribuir um PAT.