O Cursor conecta-se a servidores MCP remotos através de um arquivo mcp.json. Conecte-o ao Taskavel com um token de acesso pessoal (PAT), enviado num cabeçalho Authorization: Bearer. Trate o token como uma credencial privada do usuário do 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 para esta instalação, por exemplo cursor-portatil-trabalho. Copie o valor quando for mostrado e guarde-o numa variável de ambiente, por exemplo TASKAVEL_MCP_TOKEN, definida no perfil do seu shell ou no ambiente do sistema. Não cole o token num arquivo que vá para um repositório.
Adicione o Taskavel ao mcp.json
Use ~/.cursor/mcp.json para ter o Taskavel em todos os projetos, ou .cursor/mcp.json num único projeto. Adicione esta entrada:
{
"mcpServers": {
"taskavel": {
"url": "https://taskavel.com/mcp/taskavel",
"headers": {
"Authorization": "Bearer ${env:TASKAVEL_MCP_TOKEN}"
}
}
}
}
O Cursor substitui ${env:TASKAVEL_MCP_TOKEN} pelo valor da variável de ambiente, por isso o arquivo não contém nenhum segredo. Servidores remotos não suportam envFile, portanto a variável tem de existir no ambiente a partir do qual o Cursor é iniciado. Reinicie o Cursor depois de a definir.
Esta sintaxe segue a documentação MCP do Cursor (cursor.com/docs/context/mcp, verificada em outubro de 2026). Se o Cursor mudar o formato, siga a documentação atual e mantenha a mesma URL e o mesmo cabeçalho.
Verifique a conexão
Abra Customize na barra lateral do Cursor e confirme que taskavel está ativado e mostra as suas ferramentas. Depois pergunte: “Liste os meus projetos do Taskavel.” Comece com um pedido só de leitura antes de deixar o Cursor alterar alguma coisa. Se o servidor falhar, abra o painel Output, escolha MCP Logs e procure erros de autenticação.
Trabalhe com um âmbito explícito
Indique o projeto e a tarefa no pedido, por exemplo: “No Website, adicione um comentário à tarefa #42 a dizer que a revisão da API está concluída.” O Taskavel aplica o seu papel no projeto através do MCP. Um token não transforma um convidado em membro ou administrador. Por padrão, o Cursor pede aprovação antes de cada chamada de ferramenta.
Se desativar a instalação ou achar que o token foi exposto, revogue-o em Integração de IA (MCP). Consulte Tokens de acesso CLI para o ciclo de vida do token.
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 cursor-portatil-trabalho, e copie o valor quando aparecer. Só é mostrado uma vez.
O Cursor suporta OAuth com o Taskavel?
Um token de acesso pessoal enviado num cabeçalho Bearer é a forma testada de ligar o Cursor 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.