todo.vu MCP

Conecta tu agente de IA con el conjunto de productividad de gestión de tareas y seguimiento de tiempo de todo.vu. Tu agente puede ayudarte a realizar tareas y proporcionar información detallada sobre el trabajo de tu equipo.

Documentación

Soporte de todo.vu

Páginas de ayuda, tutoriales y consejos sobre cómo aprovechar al máximo todo.vu

Uso del servidor MCP de todo.vu para conectar tu Agente de IA a todo.vu

El Servidor MCP de todo.vu permite que los clientes del Protocolo de Contexto de Modelos (MCP) interactúen directamente con la plataforma de gestión de tareas y seguimiento de tiempo de todo.vu. Cierra la brecha entre los agentes de IA y tus datos de productividad, permitiendo la gestión automatizada de tareas, el registro de tiempo y la supervisión de proyectos.

El servidor está completamente alojado y no requiere software adicional para instalarse localmente. Soporta el protocolo http-stream y autenticación OAuth.

Casos de uso

  • Gestión automatizada de tareas: Crear, actualizar y organizar tareas según el contexto conversacional.
  • Seguimiento de tiempo: Iniciar/detener temporizadores y registrar entradas de tiempo directamente desde tu cliente de chat.
  • Informes: Obtener estadísticas de tareas y estados de proyectos para generar resúmenes o perspectivas.
  • Coordinación de proyectos: Listar clientes, proyectos y usuarios para mantenerte alineado con tu equipo.

Referencia de herramientas

El servidor actualmente expone 17 herramientas para gestionar tu espacio de trabajo (se agregarán más con el tiempo):

Tareas

  • list_tasks: Listar y filtrar tareas desde el panel del espacio de trabajo. Soporta filtrado complejo por cliente, proyecto, usuario y estado.
  • create_task: Crear una nueva tarea activa en un espacio de trabajo específico.
  • change_tasks: Actualizar una o más tareas (estado, nombre, asignación, etc.).
  • repeat_task: Establecer o actualizar reglas de recurrencia (diaria, semanal, etc.) para una tarea.
  • task_stats: Obtener recuentos agregados de tareas y estadísticas de tiempo/dinero.
  • task_add_comment: Agregar un comentario de texto enriquecido o HTML a una tarea.
  • list_comments_attachments_time_entries: Recuperar la línea de tiempo completa de una tarea específica.

Tiempo y temporizadores

  • add_time_entry: Registrar manualmente una duración de trabajo contra una tarea.
  • list_time_entries: Obtener y filtrar registros de tiempo para informes.
  • timer: Iniciar, detener o pausar el temporizador de trabajo activo.

Espacio de trabajo y estructura

  • list_workspaces: Listar todos los espacios de trabajo de todo.vu a los que tu cuenta tiene acceso.
  • list_clients: Listar y filtrar registros de clientes.
  • create_client: Agregar un nuevo cliente al espacio de trabajo.
  • list_projects: Listar y filtrar registros de proyectos.
  • create_project: Crear un nuevo proyecto, opcionalmente vinculado a un cliente.
  • list_labels: Listar etiquetas/etiquetas de tareas disponibles.
  • list_users: Listar miembros del equipo y contactos en el espacio de trabajo.

Autenticación y alcance

El servidor MCP de todo.vu soporta autenticación OAuth2 totalmente automatizada. Si tu cliente puede soportar esto, deberías ser dirigido automáticamente a la página de Autorización de todo.vu. En ese momento, debes haber iniciado sesión en todo.vu y simplemente autorizar el acceso al Alcance Completo.

Por el momento, solo soportamos clientes de escritorio. Más específicamente, la redirect_url debe ser una URL de "localhost". Este es el caso para la mayoría de los clientes de escritorio, pero no funcionará para una conexión servidor a servidor.

Ten mucho cuidado al autorizar el acceso a tu agente. Aunque tenemos herramientas limitadas que son destructivas, aún es posible que un agente malicioso cause daños significativos a los datos de tu espacio de trabajo.

Detalles de conexión

URL del servidor

El punto final principal para el servidor MCP es:
https://mcp.todo.vu/mcp

Autenticación (OAuth 2.0)

El servidor utiliza OAuth 2.0 con PKCE. Para que los clientes automatizados permanezcan estables (evitando reautenticaciones frecuentes),
usa la siguiente Identidad de Cliente Fija:

  • ID de Cliente: 2e659cf8-03e6-4c14-8aa2-343a0b8d627d
  • URI de Redirección: http://localhost:8080/callback

Nota: El puerto y la uri pueden cambiarse para adaptarse a tu cliente, pero el host debe permanecer como 'localhost'

Ejemplos de configuración

1. Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "todovu": {
      "url": "https://mcp.todo.vu/mcp"
    }
  }
}

Nota: Claude Desktop maneja el flujo OAuth automáticamente a través del navegador en la primera ejecución.

2. ChatGPT (a través de Acciones Personalizadas)

Si te conectas a través de una Acción GPT Personalizada:

  • Importar desde URL: https://mcp.todo.vu/mcp
  • Autenticación: OAuth 2.0
  • ID de Cliente: 2e659cf8-03e6-4c14-8aa2-343a0b8d627d
  • URL de Autorización: https://todo.vu/oauth/authorize
  • URL de Token: https://todo.vu/oauth/token
  • Alcance: full

3. Cursor / VS Code (a través de mcporter)

Para Cursor, se recomienda usar mcporter como puente para asegurar una gestión estable de tokens.

  1. Ejecuta mcporter config add todovu --url https://mcp.todo.vu/mcp
  2. Agrega lo siguiente a la configuración MCP de Cursor:
    • Tipo: command
      • Comando: mcporter call todovu

4. OpenClaw

OpenClaw usa mcporter internamente para servidores MCP basados en HTTP. Configúralo en ./config/mcporter.json:

{
  "mcpServers": {
    "todovu": {
      "baseUrl": "https://mcp.todo.vu/mcp",
      "oauthClientId": "2e659cf8-03e6-4c14-8aa2-343a0b8d627d",
      "oauthRedirectUrl": "http://localhost:8080/callback"
    }
  }
}

5. Extensiones de GitHub Copilot

Si estás desarrollando una Extensión de Copilot, puedes apuntar las definiciones de herramientas de tu manifiesto al baseUrl y usar el ID de Cliente proporcionado anteriormente para el flujo OAuth.