O que faz
Claim a task: mark it in_progress, assign it to the AI agent, and post a comment so the human sees you started. Call the moment you pick up a task. Pass agent when running in a fleet — the claim takes a 30-minute lease and this call fails if another agent already holds an active lease on the task, so two agents never work the same one. Re-claiming with your own agent id (or after the lease lapses) succeeds. Release it with release_task if you stop before finishing. The task comes back with url, its link in the Done app: when you tell the human you've started, give them that link, not the id.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Obrigatório | |
note | string | Opcional | First message posted to the activity feed
|
agent | string | Opcional | Your agent id when running as part of a fleet (defaults to a shared claim) |
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 leitura
readOnlyHint: false - Altera dados da sua conta do Done.
- Destrutiva
destructiveHint: false - Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
- Idempotente
idempotentHint: false - Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
- Mundo aberto
openWorldHint: 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 projetoRecusado
- Token de um espaço de trabalhoPermitido
Experimente
Com o Done conectado, peça ao seu assistente algo como:
“Assuma a tarefa do lembrete de faturas e me avise que você está nela.”
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: