Tutoriais de uso e exemplos de fluxos de trabalho

Estes fluxos mostram o que pedir ao agente e quais chamadas ele faz por baixo. As chamadas usam os argumentos reais das ferramentas; os detalhes de cada uma estão na referência de ferramentas.

Duas regras valem para todos os fluxos:

• quadrantes são sempre identificadores técnicos (backlog, urgent-important, not-urgent-important, urgent-not-important, not-urgent-not-important);
• toda escrita precisa de allowWrites: true, de um requestId novo e da version que o agente acabou de ler.

Tutorial 1: revisão diária de tarefas

Cenário

Toda manhã, o agente revisa o quadrante "Fazer" e ajuda a reorganizar o que atrasou.

Passo a passo

1. Descobrir os boards. Peça: "Liste meus boards do Priorize.me".

{ "name": "list_boards", "arguments": {} }

A resposta traz os títulos atuais dos quadrantes de cada board, então o agente pode falar "Agora" em vez de "Fazer" se o board foi personalizado.

2. Ler as tarefas urgentes e importantes. Peça: "O que está no quadrante Fazer do board Produto?".

{
  "name": "list_tasks",
  "arguments": {
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "quadrant": "urgent-important",
    "status": "active"
  }
}

3. Reagendar o que não é para hoje. Peça: "Mova 'Revisar proposta' para Agendar". O agente usa a version que acabou de ler:

{
  "name": "move_task",
  "arguments": {
    "requestId": "a3b4c5d6-e7f8-4a9b-8c0d-1e2f3a4b5c6d",
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "taskId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "expectedVersion": 4,
    "quadrant": "not-urgent-important"
  }
}

4. Resumir o dia. Peça: "Resuma minhas três tarefas mais importantes de hoje". Aqui o agente só lê; nenhuma ferramenta nova é necessária.

Tutorial 2: preparação de reunião

Cenário

Antes de uma reunião, o agente reúne o que mudou no board e rascunha uma pauta.

Passo a passo

1. Ver a atividade recente. Peça: "O que mudou no board Produto esta semana?".

{
  "name": "get_task_activity",
  "arguments": { "boardId": "550e8400-e29b-41d4-a716-446655440000" }
}

Os eventos são do board inteiro, do mais recente para o mais antigo. Para falar de uma tarefa, o agente filtra por entity_id. Se a resposta trouxer nextCursor, ele pode pedir a página seguinte:

{
  "name": "get_task_activity",
  "arguments": {
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "cursor": "eyJpZCI6IjliMmYxYTRlIn0"
  }
}

2. Listar o que foi concluído.

{
  "name": "list_tasks",
  "arguments": {
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed"
  }
}

3. Rascunhar a pauta. Peça: "Transforme isso numa pauta de 20 minutos". O resultado fica na conversa; o MCP não cria documentos.

Tutorial 3: planejamento de projeto

Cenário

O agente divide um projeto em tarefas e já as classifica.

Passo a passo

1. Confirmar o board de destino. O board precisa estar em allowedBoardIds; use list_boards para conferir.

2. Criar as tarefas. Peça: "Crie as tarefas do lançamento: escrever release notes (importante, não urgente) e corrigir o bug de login (urgente e importante)". Uma chamada por tarefa, cada uma com o seu requestId:

{
  "name": "create_task",
  "arguments": {
    "requestId": "0b6a4c55-2f47-4f3a-9d2e-8a1b2c3d4e5f",
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Escrever release notes",
    "quadrant": "not-urgent-important",
    "dueDate": "2026-10-10"
  }
}

{
  "name": "create_task",
  "arguments": {
    "requestId": "1c7b5d66-3a58-4a4b-8e3f-9b2c3d4e5f60",
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Corrigir o bug de login",
    "quadrant": "urgent-important"
  }
}

Se a conexão cair no meio, repetir a mesma chamada com o mesmo requestId não duplica a tarefa.

3. Fechar o que ficou pronto. Peça: "Marque 'Corrigir o bug de login' como concluída".

{
  "name": "complete_task",
  "arguments": {
    "requestId": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
    "boardId": "550e8400-e29b-41d4-a716-446655440000",
    "taskId": "1c7b5d66-3a58-4a4b-8e3f-9b2c3d4e5f60",
    "expectedVersion": 2
  }
}

O que o MCP não faz

O servidor não gerencia responsáveis, checklist, comentários, anexos, membros nem arquivamento, e não cria nem edita tags do catálogo do board: só aplica as que já existem, com tagIds (veja list_board_tags). Peça ao agente que diga isso em vez de improvisar, e faça essas ações no app.

Boas práticas para prompts

• Diga qual board usar pelo nome; o agente resolve o UUID com list_boards.
• Peça confirmação antes de qualquer escrita: "mostre o que você vai mudar e espere o meu ok".
• Em VERSION_CONFLICT, peça ao agente que leia a tarefa de novo e mostre a diferença, em vez de tentar outra vez automaticamente.
• Mantenha allowWrites: false quando o agente só precisa ler.

Próximos passos

• Referência de ferramentas
• Modelo de segurança
• Solução de problemas