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.
Perguntas frequentes
Onde crio um token?
No Taskavel, abra Definições da conta → Integração de IA (MCP) e crie um token de acesso pessoal. Dê-lhe o nome da instalação, por exemplo claude-code-portatil-trabalho, e copie o valor quando aparecer. Só é mostrado uma vez.
O Claude Code suporta OAuth com o Taskavel?
Um token de acesso pessoal enviado num cabeçalho Bearer é a forma testada de ligar o Claude Code ao Taskavel. O OAuth é a via testada para o ChatGPT e o Claude Desktop.
O que devo experimentar primeiro?
Comece com um pedido que só leia, como “Lista os meus projetos do Taskavel”. Quando funcionar, peça uma pequena alteração num projeto concreto, por exemplo um comentário numa tarefa.
Como revogo o token?
Abra Definições da conta → Integração de IA (MCP) e revogue o token desta instalação. Um token revogado não pode ser restaurado, por isso crie um novo se ainda precisar de acesso.