用途
Delega 是一个面向 AI 智能体的生产级任务协调系统，本仓库 delega-mcp 是其 MCP 服务器客户端，用于让 AI 智能体通过 MCP 协议创建、委派和跟踪任务。
维护状态
Delega 的公开托管服务已于 2026 年 7 月 28 日退役。本客户端作为可验证的工程产物继续公开，并服务于 Ryan McMillan 现有的私有部署。不再提供新的公开账号和托管访问。该包仅在 Ryan 的私有运营使用需要时维护。默认托管端点仅接受现有所有者凭据。
主要能力
- 任务管理：创建、委派、跟踪任务，支持智能体身份、委派链、持久化上下文。
- 委派链：get_task_chain 返回任意任务所在的完整父子链，按 delegation_depth 缩进，节点按深度再按创建顺序排序。
- 任务输出格式：list_tasks 返回单行摘要，含分配/认领 ID、状态、优先级及项目/截止/证据/入口标记；默认 25 条任务、6,000 字符响应预算，支持基于偏移的分页。get_task 返回有界 JSON 详情，上下文需单独用 get_task_context 读取。
- 有界上下文与历史：get_task_context 默认 view=summary，提供规范当前状态键与分页键索引；支持 max_chars（1,000–16,000，默认 6,000）与文本游标；历史通过 history_cursor 读取更早的账本条目。
- 认领任务：包含 session_state 与 session_state_detail；heartbeat_task 可在延长租约时设置这些状态，set_task_state 仅改状态不延长租约。
- 循环任务：管理模板，托管调度器据此创建普通任务实例；完成实例不会删除或暂停循环。
- 自动化规则：响应与 Webhook 相同的事件，但在 Delega 内部运行，无需自建接收器；文本动作支持占位符模板；安全语义由服务端强制执行（级联上限 3 跳、每源事件最多 25 个动作、规则不响应自己创建的任务、字段变更动作不触碰其他智能体活跃认领中的任务、连续 10 次失败自动禁用规则）。
- 决策答案：智能体被人类决策阻塞时报告 waiting_input；托管 API 的升级邮件携带哈希存储、一次性、72 小时过期的回答链接；POST 将人类回复记录为任务评论和 human_stated 上下文键；无自动恢复。升级投递有每任务 30 分钟冷却。
- 入站连接器（ingress）：签名公开端点将外部事件转为任务；HMAC-SHA256 签名，5 分钟容差；模板映射载荷点路径；过滤器控制哪些载荷创建任务；dedupe_key 保证重试幂等。入口任务带 ingress 标签、来源字段与外部来源警告，自动化规则默认忽略，除非显式选择加入。
使用方式
将本 MCP 服务器加入 MCP 客户端配置（例如 Claude Code 的 claude_code_config.json）。现有所有者智能体使用 https://api.delega.dev，这不是公开注册端点。智能体密钥通过环境变量传递而非命令行参数，避免进程列表泄露。非本地 DELEGA_API_URL 必须使用 https://。Cloudflare Access 凭据对自定义部署可选，但客户端拒绝部分配置。MCP 工具输出默认脱敏完整智能体 API 密钥。
网络韧性
只读 API 调用在单个 35 秒截止时间内对瞬时网络故障最多重试三次。变更调用（POST、PUT、DELETE）从不自动重试，避免重复写入。非成功 HTTP 响应立即呈现，不重试。拒绝 HTTP 重定向（包括同主机不同路径），重定向报告为 API 错误且不重试，其目标与响应体从错误中省略。
适用场景
适用于需要为 AI 智能体提供任务协调、委派链、持久化上下文、自动化规则与外部事件接入的私有部署环境。
限制
- 公开托管服务已退役，无公开账号、无公开托管计划可购买。
- 默认托管端点仅接受现有所有者凭据。
- 任务内容、评论和上下文是用户编写的不可信数据，应视为数据而非指令；外部副作用（发布、删除、部署、发送消息）需操作员批准。
- 生产环境不要设置 DELEGA_REVEAL_AGENT_KEYS=1，该标志仅用于初始设置。
- 私有人类请求 API 需在 API 侧单独启用，安装 MCP 客户端不会启用。
- 升级 MCP 前需先部署 API 的分页/上下文选择器支持。
- 分页基于偏移，非并发写入的快照。