Claude Code es un cliente de línea de comandos, así que conéctalo a Taskavel con un token de acceso personal (PAT) en vez de un conector OAuth de navegador. El token debe tratarse como una credencial privada del usuario de Taskavel que lo creó.
Crea un token dedicado
En Taskavel, abre Account Settings → AI Integration (MCP) y crea un token de acceso personal. Ponle un nombre para esta instalación, por ejemplo claude-code-work-laptop. Copia el valor al crearlo y colócalo en un almacén de secretos local o una variable de entorno que Claude Code pueda leer. No pongas el token en un repositorio de proyecto ni en una configuración confirmada.
Usa el endpoint de producción:
https://taskavel.com/mcp/taskavel
Para una instancia de Taskavel autoalojada, copia el endpoint de su página AI Integration. El token y el endpoint van juntos: un token de producción no debe colocarse en una configuración que apunte a otro entorno.
Añade el servidor MCP remoto
Añade un servidor remoto denominado taskavel mediante el método actual de configuración MCP de Claude Code. Establece su URL en el endpoint de Taskavel y proporciona el PAT como credencial HTTP Authorization: Bearer. Los formatos de configuración de Claude Code pueden cambiar, así que usa su documentación actual para la sintaxis exacta de comando o archivo. La propiedad de seguridad importante es que el token se referencia desde un secreto o entorno privado, no que se incrusta en texto plano en una configuración compartida.
Inicia una sesión nueva de Claude Code después de modificar la configuración. Pídele “Enumera mis proyectos de Taskavel” antes de una mutación. Esto confirma que el proceso en ejecución puede leer el token y que se autentica como el usuario de Taskavel esperado.
Trabaja dentro de un alcance explícito
Pide a Claude Code que inspeccione una tarea antes de editarla y nombra el proyecto cuando una solicitud pueda ser ambigua. Una petición precisa como “En Website, añade un comentario a la tarea #42 indicando que la revisión de API está completa” es más fácil de verificar que una petición amplia de actualizar un backlog.
Taskavel aplica por MCP el rol normal de proyecto del usuario conectado. Un PAT permite la conexión MCP pero no puede elevar a un invitado a miembro o administrador. Revisa la referencia generada de MCP tools antes de conceder permiso de escritura a un flujo.
Si retiras la instalación o sospechas que el token se expuso, revoca el token con nombre en AI Integration (MCP) y crea un reemplazo solo si es necesario. Consulta Tokens de acceso CLI para el ciclo de vida de la credencial.