O Claude Code é um cliente de linha de comandos, por isso deve ligá-lo ao Taskavel com um token de acesso pessoal (PAT), em vez de uma ligação OAuth no navegador. O token deve ser tratado como credencial privada do utilizador Taskavel que o criou.
Crie um token dedicado
No Taskavel, abra Configurações da conta → Integração de IA (MCP) e crie um token de acesso pessoal. Dê-lhe um nome relativo a esta instalação, por exemplo claude-code-work-laptop. Copie o valor no momento da criação e coloque-o num armazenamento local de segredos ou numa variável de ambiente que o Claude Code possa ler. Não inclua o token num repositório de projeto nem num ficheiro de configuração controlado por versões.
Utilize o endpoint de produção:
https://taskavel.com/mcp/taskavel
Para uma instância Taskavel alojada por si, copie o endpoint da respetiva página Integração de IA. O token e o endpoint têm de corresponder: um token de produção não deve ser colocado numa configuração que aponte para outro ambiente.
Adicione o servidor MCP remoto
Adicione um servidor remoto chamado taskavel através do método de configuração MCP atual do Claude Code. Defina o URL como o endpoint do Taskavel e forneça o PAT como credencial HTTP Authorization: Bearer. Os formatos de configuração do Claude Code podem mudar, por isso consulte a documentação atual para conhecer o comando ou a sintaxe exatos. A propriedade de segurança importante é o token ser referenciado a partir de um ambiente privado ou armazenamento de segredos, não incorporado como texto simples numa configuração partilhada.
Inicie uma nova sessão do Claude Code depois de alterar a configuração. Peça-lhe «Lista os meus projetos do Taskavel» antes de permitir uma alteração. Isto confirma que o processo em execução consegue ler o token e está autenticado como o utilizador Taskavel esperado.
Trabalhe num âmbito explícito
Peça ao Claude Code que consulte uma tarefa antes de a editar e indique o projeto quando um pedido puder ser ambíguo. Um pedido preciso, como «Em Website, adiciona à tarefa n.º 42 um comentário a dizer que a revisão da API está concluída», é mais fácil de rever do que um pedido abrangente para atualizar um backlog.
O Taskavel aplica através de MCP a função do utilizador ligado. Um PAT suporta a ligação MCP, mas não pode elevar um convidado a membro ou administrador. Consulte a referência gerada de Ferramentas MCP antes de conceder permissão de escrita a um fluxo.
Se desativar a instalação ou suspeitar que o token foi exposto, revogue o token identificado em Integração de IA (MCP) e crie um substituto apenas se necessário. Consulte Tokens de acesso CLI para o ciclo de vida da credencial.