Cuando Taskavel MCP no se comporta como se espera, comprueba la conexión en este orden: endpoint, método de autenticación, cuenta conectada, pertenencia al proyecto, rol y entrada de la herramienta. Este orden evita sustituir credenciales o cambiar datos de proyecto cuando el problema real es una URL incorrecta o una sesión de cuenta equivocada.
El cliente no puede conectar o autenticar
Para el servicio público de Taskavel, usa exactamente:
https://taskavel.com/mcp/taskavel
Para una instalación autoalojada, usa la URL mostrada en Account Settings → AI Integration (MCP). No uses un host de ejemplo copiado, una URL de página ni un endpoint de un entorno diferente.
ChatGPT y Claude Desktop deben usar su flujo de conector OAuth. Vuelve a abrir la configuración del conector, confirma el endpoint y repite la aprobación de Taskavel con la cuenta prevista. Un cliente CLI necesita un PAT válido proporcionado como credencial Authorization: Bearer. Si el token se revocó o no se conservó al crearlo, crea un token nuevo con nombre y actualiza el ajuste privado de secretos del cliente; Taskavel no revela más tarde un valor de token existente.
El servidor conecta pero falta el trabajo esperado
Pide al cliente que enumere los proyectos accesibles. Si el proyecto no aparece en ese resultado, comprueba la cuenta de Taskavel que aprobó OAuth o creó el PAT. Después verifica la pertenencia de esa cuenta al proyecto. MCP no evita las reglas de pertenencia ni puede combinar acceso de otra cuenta.
Si el proyecto está presente pero un nombre es ambiguo, pide al cliente que muestre las opciones coincidentes y utiliza el ID de proyecto devuelto. Haz lo mismo con columnas de tablero, hitos, etiquetas y tareas antes de intentar una escritura. Una búsqueda fallida suele ser un identificador poco claro, no un fallo de autorización.
Se deniega una escritura o produce un resultado inesperado
Comprueba el rol de proyecto del usuario conectado. Los invitados pueden leer contenido de proyecto y observar tareas, pero no modificar tareas, comentarios o adjuntos. Las acciones de propietario o administrador como gestionar miembros requieren esos roles. No lo reintentes con la credencial de un compañero; cambia la pertenencia mediante el propietario adecuado del proyecto si se pretende el acceso.
Para un comportamiento de entrada inesperado, revisa la página de herramienta generada. Los esquemas de herramienta indican los campos requeridos y las descripciones aclaran casos especiales. Las descripciones de tareas deben ser HTML de texto enriquecido válido, no Markdown. Un número de comentario como #123 identifica un comentario, no una tarea. Enumera hitos existentes antes de crear uno y elige una columna real devuelta por el servidor.
Se rechaza una operación destructiva
La eliminación permanente tiene deliberadamente dos condiciones: la tarea debe estar ya archivada y la llamada debe incluir confirmación explícita. Inspecciona o archiva primero la tarea. Si tu objetivo es solo eliminarla del trabajo activo, detente tras archivarla y revisa el resultado; la eliminación no es un atajo general para limpiar.
Sigues bloqueado
Recopila el nombre del cliente, el tipo de endpoint (OAuth o PAT), el error exacto no secreto y si funciona una solicitud de solo lectura como enumerar proyectos. No incluyas un token en un informe. Esta información distingue un problema de conector de un problema de cuenta, rol o entrada de herramienta sin exponer credenciales.