← Todas as ferramentas MCP

Get next task

next_task
Escrita

O que faz

Atomically pick AND claim the single highest-priority task ready for you to work — the queue's dequeue. Returns one task (already claimed and set to in_progress) or {task:null} when nothing is workable. Prefer this over list_my_tasks+claim_task in a fleet: it closes the race where two agents grab the same task between listing and claiming. Skips done/wont_do/pending_approval/plan_proposed tasks, tasks blocked by an unfinished dependency, paused tasks, and tasks another agent holds an active lease on. When {task:null}, the response includes a hidden breakdown (blocked/done/wont_do/pending_approval/plan_proposed/needs_input/paused/claimed_by_other counts) so you know whether to stop, go unblock something, or wait for a lease to lapse. There is no way to make this hand out a paused task: list_my_tasks({include_paused:true}) can show you one for reporting, but nothing claims one. Like list_my_tasks, this ranks across every workspace the account belongs to unless you pass workspace_id (from list_workspaces).

Parâmetros

NomeTipoObrigatórioDescrição
agentstringOpcional

Your agent/model id (e.g. "ChatGPT", "Claude", or a worker name). Used for the claim lease so a fleet doesn't double-book.

notestringOpcional

Optional note posted to the task's activity when claimed.

  • Até 20000 caracteres
workspace_idstringOpcional

Only tasks in this workspace. Optional — omitted, the queue spans every workspace this account belongs to, so an account that shares work with other people gets their workspaces' Claude tasks too. Ids come from list_workspaces.

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: false
Altera dados da sua conta do Done.
DestrutivadestructiveHint: false
Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: false
Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
Mundo abertoopenWorldHint: false
Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

  • Acesso totalPermitido
  • Token somente leituraRecusado
  • Token de um projetoPermitido
  • Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“Pegue sua próxima tarefa no Done e comece.”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →