Cursor se conecta a servidores MCP remotos mediante un archivo mcp.json. Conéctalo a Taskavel con un token de acceso personal (PAT), enviado como cabecera Authorization: Bearer. Trata el token como una credencial privada del usuario de Taskavel que lo creó.
Crea un token dedicado
En Taskavel, abre Configuración de la cuenta → Integración de IA (MCP) y crea un token de acceso personal. Ponle un nombre para esta instalación, por ejemplo cursor-portatil-trabajo. Copia el valor cuando se muestre y guárdalo en una variable de entorno, por ejemplo TASKAVEL_MCP_TOKEN, definida en el perfil de tu shell o en el entorno del sistema. No pegues el token en un archivo que se suba a un repositorio.
Añade Taskavel a mcp.json
Usa ~/.cursor/mcp.json para tener Taskavel en todos los proyectos, o .cursor/mcp.json en un solo proyecto. Añade esta entrada:
{
"mcpServers": {
"taskavel": {
"url": "https://taskavel.com/mcp/taskavel",
"headers": {
"Authorization": "Bearer ${env:TASKAVEL_MCP_TOKEN}"
}
}
}
}
Cursor sustituye ${env:TASKAVEL_MCP_TOKEN} por el valor de la variable de entorno, así que el archivo no contiene ningún secreto. Los servidores remotos no admiten envFile, por lo que la variable debe existir en el entorno desde el que se inicia Cursor. Reinicia Cursor después de definirla.
Esta sintaxis sigue la documentación MCP de Cursor (cursor.com/docs/context/mcp, revisada en octubre de 2026). Si Cursor cambia el formato, sigue su documentación actual y mantén la misma URL y cabecera.
Comprueba la conexión
Abre Customize en la barra lateral de Cursor y confirma que taskavel está activado y muestra sus herramientas. Después pregunta: “Lista mis proyectos de Taskavel.” Empieza con una petición de solo lectura antes de dejar que Cursor cambie algo. Si el servidor falla, abre el panel Output, elige MCP Logs y busca errores de autenticación.
Trabaja con un alcance explícito
Nombra el proyecto y la tarea en tu petición, por ejemplo: “En Website, añade un comentario a la tarea #42 diciendo que la revisión de la API está terminada.” Taskavel aplica tu rol en el proyecto a través de MCP. Un token no puede convertir a un invitado en miembro o administrador. Por defecto, Cursor pide aprobación antes de cada llamada a una herramienta.
Si retiras la instalación o crees que el token se ha expuesto, revócalo en Integración de IA (MCP). Consulta Tokens de acceso CLI para el ciclo de vida del token.
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 cursor-portatil-trabajo, y copia el valor cuando aparezca. Solo se muestra una vez.
¿Cursor admite OAuth con Taskavel?
Un token de acceso personal enviado como cabecera Bearer es la forma probada de conectar Cursor 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.