Usa el servidor MCP de Taskavel cuando un cliente de IA necesite acceso autenticado a tu trabajo de Taskavel. Antes de conectarlo, decide si el cliente puede completar OAuth en un navegador o si necesita un token de acceso personal. Esa decisión determina cómo demuestra el cliente su identidad ante Taskavel.
El endpoint público de Taskavel es:
https://taskavel.com/mcp/taskavel
Si utilizas una instancia de Taskavel autoalojada, copia en su lugar la URL que aparece en Account Settings → AI Integration (MCP). No sustituyas la URL de producción por un nombre de host de ejemplo de un fragmento de configuración.
Usa OAuth para clientes con conector
OAuth es la opción correcta para un cliente que ofrece un flujo interactivo de “añadir conector” o “añadir aplicación”. Te redirige a Taskavel, donde inicias sesión si es necesario y apruebas la conexión. El cliente actúa después como tu usuario de Taskavel y sigue sujeto a tus pertenencias de proyecto y restricciones de rol habituales.
ChatGPT y Claude Desktop tienen rutas de conectores documentadas en las guías siguientes. Añade únicamente el endpoint de Taskavel anterior y completa después la aprobación en Taskavel. No crees ni pegues un token personal para un cliente que puede utilizar el flujo OAuth.
Tras autorizarlo, abre el cliente y formula una pregunta inocua como “Enumera mis proyectos de Taskavel”. Una respuesta correcta confirma tanto la conexión MCP como la cuenta efectiva. Si no aparecen proyectos esperados, verifica la cuenta de Taskavel y la pertenencia al proyecto antes de volver a conectar.
Usa un PAT para clientes CLI
Claude Code, Codex y configuraciones similares de línea de comandos usan un token de acceso personal en lugar del flujo OAuth de navegador. En Taskavel, abre Account Settings → AI Integration (MCP) y crea un token con un nombre específico, por ejemplo el cliente y la máquina que lo usarán. Copia el valor cuando se muestre y colócalo únicamente en un almacén de secretos local o una variable de entorno.
Configura el cliente con el endpoint y una cabecera Authorization: Bearer. Nunca confirmes un token en un repositorio, lo incluyas en una captura de pantalla ni lo pegues en un archivo de configuración compartido. Un token con nombre por cliente o máquina hace que una revocación posterior sea precisa.
Verifica la configuración antes de usar herramientas de escritura
Primero pide al cliente que descubra datos: enumere proyectos, liste tus tareas o inspeccione una tarea conocida. Confirma que la respuesta corresponde a la cuenta de Taskavel conectada. Después prueba una solicitud de bajo riesgo, como una instantánea del tablero. Solo entonces pídele que cree, mueva o actualice trabajo.
Los errores de conexión suelen ser errores de endpoint o autenticación; los datos ausentes suelen ser un problema de cuenta, pertenencia o rol. Consulta solución de problemas para las comprobaciones ordenadas y lee seguridad y revocación antes de distribuir un PAT.