KarposKarpos

Tarefas

CRUD completo de tarefas, incluindo operações em batch. A categoria mais poderosa do MCP.

Use batch-update-tasks para operações em massa. É muito mais eficiente do que chamar update-task em loop. Uma única chamada atualiza até 50 tarefas.

list-tasks

list-tasks

Lista tarefas de um workspace com suporte a filtros por projeto, status, responsável e limite. Retorna as tarefas com todos os campos principais.

Parâmetros

workspaceId* obrigatório

string

ID do workspace

projectIdopcional

string

Filtrar por projeto específico

statusopcional

string

"todo" | "in_progress" | "done" | "cancelled"

assigneeIdopcional

string

Filtrar por responsável (userId)

limitopcional

number

Máximo de resultados (padrão: 50)

Exemplo

{
  "tool": "list-tasks",
  "workspaceId": "wsp_abc123",
  "projectId": "prj_001",
  "status": "in_progress"
}

Resposta

{
  "tasks": [
    {
      "id": "tsk_001",
      "title": "Implementar auth OAuth",
      "status": "in_progress",
      "priority": "high",
      "assignee": "João Silva",
      "dueDate": "2024-03-15",
      "projectId": "prj_001"
    }
  ],
  "total": 1
}

create-task

create-task

Cria uma nova tarefa com título, descrição, responsável, prioridade, data limite e status inicial. Retorna a tarefa criada com ID gerado.

Parâmetros

projectId* obrigatório

string

ID do projeto

title* obrigatório

string

Título da tarefa

descriptionopcional

string

Descrição em texto ou markdown

priorityopcional

string

"low" | "medium" | "high" | "urgent"

assigneeIdopcional

string

ID do usuário responsável

dueDateopcional

string

Data limite (ISO 8601: YYYY-MM-DD)

statusopcional

string

Status inicial (padrão: "todo")

Exemplo

{
  "tool": "create-task",
  "projectId": "prj_001",
  "title": "Revisar mockups do dashboard",
  "priority": "high",
  "assigneeId": "usr_xyz",
  "dueDate": "2024-03-20"
}

Resposta

{
  "task": {
    "id": "tsk_005",
    "title": "Revisar mockups do dashboard",
    "status": "todo",
    "priority": "high",
    "projectId": "prj_001"
  }
}

update-task

update-task

Atualiza qualquer campo de uma tarefa existente: status, prioridade, responsável, datas, título. Envie apenas os campos a alterar.

Parâmetros

taskId* obrigatório

string

ID da tarefa

titleopcional

string

Novo título

statusopcional

string

"todo" | "in_progress" | "done" | "cancelled"

priorityopcional

string

"low" | "medium" | "high" | "urgent"

assigneeIdopcional

string

ID do novo responsável

dueDateopcional

string

Nova data limite (ISO 8601)

descriptionopcional

string

Nova descrição

Exemplo

{
  "tool": "update-task",
  "taskId": "tsk_005",
  "status": "done"
}

Resposta

{
  "success": true
}

delete-task

delete-task

Remove permanentemente uma tarefa. Esta operação é irreversível e não pode ser desfeita.

Parâmetros

taskId* obrigatório

string

ID da tarefa a deletar

Exemplo

{
  "tool": "delete-task",
  "taskId": "tsk_005"
}

Resposta

{
  "success": true
}

batch-update-tasks

batch-update-tasks

Atualiza múltiplas tarefas de uma vez aplicando a mesma operação. Ideal para mover status em bulk, reatribuir responsável ou ajustar prioridade de um conjunto de tarefas.

Parâmetros

taskIds* obrigatório

string[]

Array com IDs das tarefas a atualizar

statusopcional

string

Novo status para todas as tarefas

priorityopcional

string

Nova prioridade para todas as tarefas

assigneeIdopcional

string

Novo responsável para todas as tarefas

Exemplo

{
  "tool": "batch-update-tasks",
  "taskIds": [
    "tsk_001",
    "tsk_003",
    "tsk_007"
  ],
  "status": "done"
}

Resposta

{
  "success": true,
  "updatedCount": 3
}

Valores de referência

Status

todoin_progressdonecancelled

Prioridade

lowmediumhighurgent