todo.vu MCP

Conecte seu Agente de IA ao pacote de produtividade de gerenciamento de tarefas e controle de tempo do todo.vu. Seu agente pode ajudá-lo a realizar tarefas e fornecer insights profundos sobre o trabalho da sua equipe.

Ver em todo.vu

Documentação

Suporte do todo.vu

Páginas de ajuda, tutoriais e dicas sobre como aproveitar ao máximo o todo.vu

Usando o servidor MCP do todo.vu para conectar seu Agente de IA ao todo.vu

O Servidor MCP do todo.vu permite que clientes do Model Context Protocol (MCP) interajam diretamente com a plataforma de gerenciamento de tarefas e controle de tempo do todo.vu. Ele preenche a lacuna entre agentes de IA e seus dados de produtividade, permitindo gerenciamento automatizado de tarefas, registro de tempo e supervisão de projetos.

O servidor é totalmente hospedado e não requer nenhum software adicional instalado localmente. Ele suporta o protocolo http-stream e autenticação OAuth.

Casos de Uso

  • Gerenciamento Automatizado de Tarefas: Crie, atualize e organize tarefas com base no contexto conversacional.
  • Controle de Tempo: Inicie/pare cronômetros e registre entradas de tempo diretamente do seu cliente de chat.
  • Relatórios: Obtenha estatísticas de tarefas e status de projetos para gerar resumos ou insights.
  • Coordenação de Projetos: Liste clientes, projetos e usuários para manter-se alinhado com sua equipe.

Referência de Ferramentas

O servidor atualmente expõe 17 ferramentas para gerenciar seu espaço de trabalho (mais serão adicionadas ao longo do tempo):

Tarefas

  • list_tasks: Liste e filtre tarefas do painel do espaço de trabalho. Suporta filtragem complexa por cliente, projeto, usuário e status.
  • create_task: Crie uma nova tarefa ativa em um espaço de trabalho específico.
  • change_tasks: Atualize uma ou mais tarefas (status, nome, atribuição, etc.).
  • repeat_task: Defina ou atualize regras de recorrência (diária, semanal, etc.) para uma tarefa.
  • task_stats: Obtenha contagens agregadas de tarefas e estatísticas de tempo/dinheiro.
  • task_add_comment: Adicione um comentário rich-text ou HTML a uma tarefa.
  • list_comments_attachments_time_entries: Recupere a linha do tempo completa de uma tarefa específica.

Tempo e Cronômetros

  • add_time_entry: Registre manualmente uma duração de trabalho em uma tarefa.
  • list_time_entries: Busque e filtre registros de tempo para relatórios.
  • timer: Inicie, pare ou pause o cronômetro de trabalho ativo.

Espaço de Trabalho e Estrutura

  • list_workspaces: Liste todos os espaços de trabalho do todo.vu aos quais sua conta tem acesso.
  • list_clients: Liste e filtre registros de clientes.
  • create_client: Adicione um novo cliente ao espaço de trabalho.
  • list_projects: Liste e filtre registros de projetos.
  • create_project: Crie um novo projeto, opcionalmente vinculado a um cliente.
  • list_labels: Liste os rótulos/etiquetas de tarefas disponíveis.
  • list_users: Liste membros da equipe e contatos no espaço de trabalho.

Autenticação e Escopo

O servidor MCP do todo.vu suporta autenticação OAuth2 totalmente automatizada. Se o seu cliente puder suportar isso, você deverá ser direcionado automaticamente para a página de Autorização do todo.vu. Nesse momento, você deve estar conectado ao todo.vu e apenas autorizar o acesso ao Escopo Completo.

No momento, suportamos apenas clientes desktop. Mais especificamente, o redirect_url deve ser uma URL "localhost". Este é o caso da maioria dos clientes desktop, mas não funcionará para uma conexão servidor-a-servidor.

Tenha muito cuidado ao autorizar o acesso ao seu agente. Embora tenhamos ferramentas limitadas que são destrutivas, ainda é possível que um agente mal-intencionado cause danos significativos aos dados do seu espaço de trabalho.

Detalhes de Conexão

URL do Servidor

O endpoint principal do servidor MCP é:
https://mcp.todo.vu/mcp

Autenticação (OAuth 2.0)

O servidor usa OAuth 2.0 com PKCE. Para que clientes automatizados permaneçam estáveis (evitando reautenticação frequente),
use a seguinte Identidade de Cliente Fixa:

  • Client ID: 2e659cf8-03e6-4c14-8aa2-343a0b8d627d
  • Redirect URI: http://localhost:8080/callback

Nota: A porta e a uri podem ser alteradas para atender ao seu cliente, mas o host deve permanecer 'localhost'

Exemplos de Configuração

1. Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

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

Nota: O Claude Desktop lida com o fluxo OAuth automaticamente via navegador na primeira execução.

2. ChatGPT (via Ações Personalizadas)

Se conectar via uma Ação GPT Personalizada:

  • Importar da URL: https://mcp.todo.vu/mcp
  • Autenticação: OAuth 2.0
  • Client ID: 2e659cf8-03e6-4c14-8aa2-343a0b8d627d
  • URL de Autorização: https://todo.vu/oauth/authorize
  • URL do Token: https://todo.vu/oauth/token
  • Escopo: full

3. Cursor / VS Code (via mcporter)

Para o Cursor, é recomendado usar mcporter como uma ponte para garantir gerenciamento estável de tokens.

  1. Execute mcporter config add todovu --url https://mcp.todo.vu/mcp
  2. Adicione o seguinte às configurações de MCP do Cursor:
    • Tipo: command
      • Comando: mcporter call todovu

4. OpenClaw

O OpenClaw usa mcporter internamente para servidores MCP baseados em HTTP. Configure-o em ./config/mcporter.json:

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

5. Extensões do GitHub Copilot

Se você estiver desenvolvendo uma Extensão do Copilot, pode apontar as definições de ferramentas do seu manifesto para o baseUrl e usar o Client ID fornecido acima para o fluxo OAuth.