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.
Preguntas frecuentes
¿Dónde creo un token?
En Taskavel, abre Configuración de la cuenta → Integración de IA (MCP) y crea un token de acceso personal. Ponle el nombre de la instalación, por ejemplo claude-code-portatil-trabajo, y copia el valor cuando aparezca. Solo se muestra una vez.
¿Claude Code admite OAuth con Taskavel?
Un token de acceso personal enviado como cabecera Bearer es la forma probada de conectar Claude Code con Taskavel. OAuth es la vía probada para ChatGPT y Claude Desktop.
¿Qué debería probar primero?
Empieza con una petición que solo lea, como “Lista mis proyectos de Taskavel”. Cuando funcione, pide un cambio pequeño en un proyecto concreto, por ejemplo un comentario en una tarea.
¿Cómo revoco el token?
Abre Configuración de la cuenta → Integración de IA (MCP) y revoca el token de esta instalación. Un token revocado no se puede restaurar, así que crea uno nuevo si todavía necesitas acceso.