Lista workspaces (clientes/projetos) da empresa no Ekyte.

👉 PREFIRA usar o parâmetro "search" para achar um workspace pelo nome (ex: search="ferraz" acha "V4 Ferraz Piai"). É mais rápido que iterar páginas.

Use esta ferramenta ANTES de criar tasks ou apontar horas. Retorna: id, nome, status (ativo/inativo).

Paginação client-side: 50 registros por página. Total típico: 600+ workspaces.

Lista usuários/membros da empresa no Ekyte.

👉 PREFIRA usar "search" (busca por nome OU email, case-insensitive) para achar alguém rapidamente. Ex: search="pietro".

Retorna: id (UUID), nome, email.

IMPORTANTE: O ID do usuário é um UUID (ex: "feff4a61-b0a3-483d-a384-172c4b301ee0"), não um número.

Paginação client-side: 50 por página.

Lista todos os tipos de tarefa (templates) da empresa.

Use para descobrir o task_type_id antes de criar tarefas. Retorna: id, nome, workflow_id (importante: cada task-type pertence a um workflow, e as phases vivem no workflow).

DICA: Depois de achar o task_type, use ekyte_list_phases com o workflow_id correspondente para descobrir as phases disponíveis.

Lista as fases (phases) de um workflow do Ekyte.

Cada tipo de tarefa pertence a um workflow, e o workflow contém as fases possíveis para tarefas daquele tipo.

Use esta ferramenta ANTES de criar uma tarefa: descubra o workflow_id via ekyte_list_task_types, depois use este tool para achar o phase_id correto (normalmente a fase inicial).

Retorna: id, nome, sequencial, ativo.

Lista tarefas da empresa no Ekyte com filtros opcionais.

Filtros server-side: workspace_id, status, task_type_id, phase_id, executor_id, datas. Filtro client-side: search (texto no título).

PAGINAÇÃO: a API do Ekyte não pagina este endpoint — o MCP faz paginação client-side (50 por página) após aplicar todos os filtros.

DICA: sempre filtre por workspace_id para reduzir o volume. Use ekyte_list_workspaces com search para achar o ID.

Retorna: id, título, status, responsável, datas, tempo estimado/real, workspace, tipo de tarefa.

Lista TODAS as fases de uma tarefa específica, mostrando quem é o responsável (executor), datas e tempo estimado POR FASE.

Use ANTES de editar executor/datas/esforço de uma fase específica com ekyte_update_phase.

Diferença vs ekyte_list_phases:

• ekyte_list_phases: lista fases do WORKFLOW (template) — o que pode existir.

• ekyte_list_task_flow_phases: lista fases DESTA TAREFA — o que existe de fato, com quem.

Retorna para cada fase: phase_id, sequential, nome, executor (UUID + nome), effort, start/due date.

Busca os detalhes completos de uma tarefa específica pelo ID.

Use ekyte_list_tasks primeiro para encontrar o ID.

Retorna: título, descrição, status, responsável, workspace, tipo, datas, tempos.

Lista projetos da empresa no Ekyte. Use is_planning=1 para buscar projetos que estão com tarefas planejadas mas não ativas ainda. Você pode sobrescrever o endpoint caso a API utilize um caminho diferente de 'projects' (ex: 'ctc-projects').

Lista modelos (templates) de projetos disponíveis para criar novos projetos.

Lista as tarefas associadas a um projeto específico. Excelente para verificar se existem "tarefas planejadas mas não ativas" dentro de um projeto.

Cria um apontamento de horas vinculado a uma tarefa específica no Ekyte.

Equivalente a abrir uma tarefa no Ekyte e clicar em "Adicionar apontamento" → "Manual".

Parâmetros obrigatórios:

• workspace_id: ID do workspace (use ekyte_list_workspaces)

• task_id: ID da tarefa (use ekyte_list_tasks)

• date: Data do apontamento (AAAA-MM-DD)

• start_time: Hora de início (HH:MM)

• end_time: Hora de fim (HH:MM)

IMPORTANTE: Sempre confirme os dados com o usuário antes de executar. A hora de fim DEVE ser posterior à hora de início. O esforço (duração) é calculado automaticamente.

Cria um apontamento de horas avulso (sem vincular a uma tarefa específica).

Equivalente a usar o botão "Adicionar apontamento" na tela principal do Ekyte, selecionando Workspace, Tipo de Tarefa e Etapa manualmente.

Parâmetros obrigatórios:

• workspace_id: ID do workspace (use ekyte_list_workspaces)

• task_type_id: ID do tipo de tarefa (use ekyte_list_task_types)

• phase_id: ID da etapa

• date, start_time, end_time

IMPORTANTE: Sempre confirme os dados com o usuário antes de executar.

Lista apontamentos de horas no Ekyte para um workspace em um período.

Parâmetros obrigatórios:

• workspace_id: ID do workspace (use ekyte_list_workspaces para descobrir)

• date_from / date_to: Período de datas (AAAA-MM-DD)

Filtros client-side opcionais:

• user_id: UUID do usuário

• task_id: ID da tarefa

PAGINAÇÃO: client-side (50 por página). O MCP puxa todos os apontamentos do período e filtra depois.

Retorna: id, data, horário, duração, tarefa, usuário, comentário.

Remove um apontamento de horas no Ekyte (soft delete via mudança de status).

Parâmetros obrigatórios:

• workspace_id: ID do workspace

• time_entry_id: ID do apontamento (use ekyte_list_time_entries para descobrir)

IMPORTANTE: Esta ação NÃO pode ser desfeita. Sempre confirme com o usuário antes de executar. Use ekyte_list_time_entries para verificar o apontamento correto antes de deletar.

Cria uma nova tarefa no Ekyte. Suporta DOIS modos:

MODO 1 — FASE ÚNICA (simples): Forneça executor_id + phase_id. Tarefa nasce com 1 fase.

MODO 2 — MULTI-FASE (com executores diferentes por fase): Forneça phases[] com uma entrada por fase. Cada entrada tem { phase_id, executor_id, effort_minutes, phase_start_date?, phase_due_date? }. A tarefa começa na PRIMEIRA fase da lista.

Fluxo recomendado ANTES:

1. ekyte_list_workspaces → workspace_id

2. ekyte_list_task_types → task_type_id (+ workflow_id)

3. ekyte_list_phases(workflow_id) → phase_ids disponíveis

4. ekyte_list_users → executor_id (UUID)

5. Chamar este tool

IMPORTANTE: Sempre confirme TODOS os dados com o usuário antes de criar.

Atualiza campos TOP-LEVEL de uma tarefa existente (título, descrição, executor/fase ATIVA, datas da fase atual, prioridade) usando JSON Patch.

Para editar executor/datas/esforço de uma FASE ESPECÍFICA não-atual, use ekyte_update_phase em vez deste.

Campos opcionais (pelo menos 1 obrigatório):

• title: Novo título

• description: Nova descrição (texto simples → convertido para HTML)

• executor_id: UUID do novo responsável da fase atual

• phase_id: ID da nova fase ATIVA (muda a fase corrente)

• phase_start_date / phase_due_date: Datas da fase atual

• priority_group: Grupo de prioridade (35=Baixa, 50=Média, 60=Alta, 90=Urgente)

• priority: Prioridade bruta (0-1000) — normalmente prefira priority_group

IMPORTANTE: Sempre confirme as alterações com o usuário antes de executar.

Atualiza uma fase específica dentro de uma tarefa — permite trocar executor/datas/esforço de QUALQUER fase do fluxo, não só da fase atual.

Caso de uso: "mudar quem é o responsável pela fase de Execução da tarefa #123", sem alterar as outras fases.

Fluxo recomendado:

1. ekyte_list_task_flow_phases(task_id) → ver todas as fases e seus phase_ids

2. ekyte_update_phase(task_id, phase_id, ...campos a trocar)

Campos opcionais (pelo menos 1 obrigatório):

• executor_id: Novo responsável desta fase (UUID)

• effort_minutes: Novo tempo estimado desta fase (minutos)

• phase_start_date: Nova data de início desta fase (AAAA-MM-DD)

• phase_due_date: Nova data de entrega desta fase (AAAA-MM-DD)

IMPORTANTE: Confirme as alterações com o usuário antes de executar.

Ativa (adiciona) ou desativa (remove) uma fase no fluxo de uma tarefa de projeto.

Use ekyte_list_task_flow_phases PRIMEIRO para ver todas as fases disponíveis (ativas e inativas) e seus IDs.

Parâmetros:

• task_id: ID da tarefa

• project_id: ID do projeto (OBRIGATÓRIO)

• phase_id: ID da fase (phaseId) a ativar/desativar

• active: 1 = ATIVAR (adicionar), 0 = DESATIVAR (remover)

• executor_id: UUID do executor (opcional ao desativar, recomendado ao ativar)

FUNCIONAMENTO: Busca o estado atual da tarefa, modifica o campo 'active' da fase desejada e envia o array completo via PUT.

Marca uma tarefa como concluída (situation=30) no Ekyte.

Parâmetro obrigatório:

• task_id: ID da tarefa a ser concluída (use ekyte_list_tasks para encontrar)

IMPORTANTE: Esta ação marca a tarefa como CONCLUÍDA. Confirme com o usuário antes de executar. Para verificar o status atual da tarefa, use ekyte_get_task primeiro.

Adiciona um comentário em uma tarefa existente no Ekyte.

Parâmetros obrigatórios:

• task_id: ID da tarefa (use ekyte_list_tasks para encontrar)

• comment: Texto do comentário

O comentário será adicionado como uma nova mensagem na timeline da tarefa, visível para todos que têm acesso.

Cria um novo projeto no Ekyte baseado nos parâmetros e num payload adicional dinâmico.