Unitask代理
开始完成任务，而不仅仅是组织任务：将任何AI代理连接到Unitask（Unitask.app），以安全的优先级、标签、时间块等来管理和完成任务。
Unitask现已上线 公开测试版。任何人都可以在以下网址注册 https://unitask.app 并创建有作用域的API令牌。 推荐运行时：OpenClaw、Codex IDE、Claude Code和任何兼容MCP的客户端。
它做什么
- 使用令牌高效检索控件读取任务(
fields,compact，描述整形） - 通过以下方式创建/更新任务（包括子任务
parent_id) - 在父任务之间移动子任务
- 合并父任务（先预览）
- 创建/编辑/删除标签
- 添加/删除任务上的标签
- 软删除任务
- 时间阻挡了你的一天（写道
scheduled_start+duration_minutes) - 读取/更新入职和工作流程首选项的设置
它能帮助你实现什么
- 只查看现在重要的内容（今天、即将到来、重复出现、高优先级切片）
- 通过首先返回较小的任务有效负载来减少代理工作流的令牌使用
- 将高层意图转化为具体行动（创建、重新确定优先级、安排、闭环）
- 在移动/合并操作中，首先进行模拟运行，以保持较低的变更风险
它还没有做什么
- 没有单个调用批量状态更新端点（代理应迭代任务ID）
- 破坏性操作没有撤消端点
- 没有本地“解释为什么选择此优先级”推理端点（代理应用自己的策略）
设置
- 注册地址：
https://unitask.app（公测版），如果您还没有帐户。 - 在Unitask中：
Dashboard -> Settings -> API使用所需的作用域创建API令牌。 - 在您的AI应用/MCP客户端配置中，将令牌存储为
UNITASK_API_KEY（切勿在聊天中粘贴令牌）。 - 可选但建议一次性设置：通过设置帐户时区
update_settings({ settings: { timeZone: "" } }).
托管MCP端点
- 网址：
https://unitask.app/api/mcp - 头球
Authorization: Bearer
前5个提示
- “我今天的任务是什么，包括逾期任务，按优先级排序？使用紧凑的输出。”
- 使用字段id、title、priority、due_date显示我未来7天的任务
- “创建一个任务：起草测试版发布更新，明天下午5点到期。然后将其标记为发布。”
- 将子任务\移动到父任务\
下；先预览，然后应用
- “将父级\合并为\<target_parent_id'；在应用之前显示模拟运行摘要。”
list_tasks 快速控制
- 视图/时间窗口：
view,tz（可选超控），window_days - 日期筛选器：
due_from,due_to,start_from,start_to - 目标选择器：
recurring_only,priority_buckets,has_scheduled,has_start_date,has_due_date - 响应整形：
fields,compact=compact|minimal,include_description,description_max_chars,description_ellipsis
如果 tz 省略，Unitask默认为帐户时区 settings.timeZone.
有关完整的工具合同，请参阅：
SKILL.md（完整的MCP工具清单+范围/安全规则）USE_CASES.md（实际情景矩阵）EXAMPLES.md（带提示的顶部意图+预期输出形状）
示例库
顶部意图的提示+预期输出库：
EXAMPLES.md
客户端配置示例
克劳德代码（远程HTTP MCP）
创建/编辑 ~/.claude.json:
{
"mcpServers": {
"unitask": {
"type": "http",
"url": "https://unitask.app/api/mcp",
"headers": {
"Authorization": "Bearer ${UNITASK_API_KEY}"
}
}
}
}VS代码（远程HTTP MCP）
创建 .vscode/mcp.json 在您的工作空间中：
{
"inputs": [
{
"id": "unitask_api_key",
"type": "promptString",
"description": "Unitask API key",
"password": true
}
],
"servers": {
"unitask": {
"type": "http",
"url": "https://unitask.app/api/mcp",
"headers": {
"Authorization": "Bearer ${input:unitask_api_key}"
}
}
}
}安全
- 使用所需的最小范围。
- 范围指导：
read为了检索，write对于创建/更新，delete只有在需要的时候。 - 保持
dry_run=true首先是复合操作（移动/合并/应用时间块）。 - 确认删除，除非用户明确请求删除。
- 避免过度提取：从紧凑/投影查询开始，仅对您要执行的任务进行扩展。