内容
-MCP
的 MCP 服务器 — 面向 AI 代理的任务交接将任何与 MCP 兼容的客户端（Claude Code、Cursor、Codex 等）连接到 Delega，并通过自然语言管理任务、项目和代理。
## 安装
```bash
npm install -g @-dev/mcp
```
##将以下内容添加到您的 MCP 客户端配置文件中（例如 Claude `claude_code_config.json`）：
```json
{
"mcpServers": {
"delega": {
"command": "npx",
" ["-y", "@delega-dev/mcp"],
"env": {
"DELEGA_API_URL": "https://api.dev",
"DELEGA_AGENT_KEY": "dlg_您的代理密钥"
}
}
}
```
### 环境变量
| 变量名 | 默认值 | 描述 |
| --- | --- | --- |
| `DELEGA_API_URL` | `https://api.delega.dev` | Delega API 端点。默认为托管 API；自定义 `/api` 风格的端点（例如 `http://localhost:18890`）是高级覆盖。 |
| `DELEGA_AGENT_KEY` | （无） | 用于身份验证请求的代理 API 密钥。MCP 配置中优先使用；如果设置了两个密钥环境变量，则此变量优先。 |
| `DELEGA_API_KEY` | （无） | 备用别名，接受以便 MCP、CLI 和 SDK 在需要时共享一个环境变量。 |
| `DELEGA_REVEAL_AGENT_KEYS` | `0` | **限开发使用。** 设置为 `1` 以在中打印完整的 API 密钥。切勿在生产环境中提示注入的代理可以从 `register_agent` 或 `list_agents` 响应中窃取密钥。 |
使用 `https://api.delega.dev` 作为 URL。
## 安全注意事项
- 非本地的 `DELEGA_API_URL` 值必须使用 `https://`。
- 代理密钥通过环境变量传递，而不是命令行参数，这避免了进程列表泄漏。
- MCP 工具输出默认会编辑完整的 密钥。
- **请勿在生产环境中设置 `DELEGA_REVEAL_AGENT_KEYS=1`。** 此标志仅用于初始设置。在生产环境中，通过提示注入的代理可以从 `register_agent` 或 `list_agents工具输出中窃。密钥仅在创建时返回一次；如果需要新密钥，请注册一个替换代理。
## 工具
| 工具 | 描述 |
| --- | --- |
| `list_tasks` | 列出任务，按项目、标签、截止日期、完成状态过滤 |
| `get_task` | 获取任务的，包括子任务和任务| `link_task`分支、提交、PR 或到任务 |
| `list_task_links` | 列出附加到任务的分支、提交、PR 和 URL 链接 |
| `create_task` | 创建新任务 |
| `list_rec | 列出定期任务模板 |
| `create_recurring | 创建定期任务模板（`daily`、`weekly`、` 或 `yearly`| `update_recurrence 更新定期任务模板，包括使用` 暂停/恢复 |
| `delete_recurrence`定期任务模板；现有的已生成的任务实例仍保留 |
| `update_task` | 更新任务字段（包括 `assigned_to_agent_id`） |
| `assign_task` | 将任务分配给代理传递 `null`分配） |
| `delegate_task` | 委托任务与父任务链接的子任务（父任务状态变为 `delegated`）。用于多代理交接 — `assign_task` 不链。 |
| `get_task_chain` | 返回任务的链（根 + 后代，按深度排序） |
|_task_context` | 将键合并到任务的持久上下文 blob 中（深度合并，而不是替换）， |
| `get_task_context` | 读取任务的持久上下文选地使用每个来源 |
| `get | 读取任务上下文的追加式来源账本 |
| `find_duplicate_tasks` | 检查提议的任务内容是否与现有的开放任务相似（TF-IDF + 余弦相似度）。在 `create_task` 之前调用以避免冗余工作。 |
| `get_usage` | 返回配额 + 速率限制**仅限托管 (`api.delega.dev自定义端点会收到明确的错误。 |
| `claim_task` | 从队列中认领下一个可用的任务进行独占处理（工作队列语义）。基于租约：300 秒，可配置 30-3600 秒。返回任务或报告空队列。**仅限托管 API。** |
| `heartbeat_task` | 在工作时延长认领任务的租定期调用以防止认领被回收。**仅限托管 API。** |
| `release_task` | 将认领释放回队列而不完成它。**仅限托管 API |
| `set_task | 在认领的任务上报告 `working`、`waiting 或 `errored` 状态，而不延长租约。**仅限托管 API。** |
| `complete_task` |标记为已完成 |
| `delete_task` | 任务 |
| `add_comment` | 在任务上添加评论 |
| `list_projects` | 列出所有项目 |
| `get_stats` | 获取任务统计信息 |
| `list_agents` | 列出已注册的代理 |
| `register_agent` | 注册新代理（返回 API 密钥），可选地使用角色预设 |
| `set_agent_role` | 设置代理的角色：`worker`、`coordinator` 或 `admin`（需要管理员密钥） |
| `delete_agent` | 删除代理（如果代理有活动任务，则拒绝） |
| `list_webhooks` | 列出所有 Webhook（仅限管理员） |
| `create_webhook` | 创建用于事件通知的 Webhook，包括 `task.linked`（仅限管理员） |
| `delete_webhook` | 按 ID 删除 Webhook（仅限管理员） |
### 任务输出格式
返回任务的工具（`list_tasks`、`get_task`、`create_task`、`update_task`、`assign_task`）在可用时，会渲染每个任务并附带分配元数据：
```
[#42] 发布版本
描述：剪辑 RC，标记，推送到 npm
项目：Delega
标签：release优先级：3
截止日期：20204-20
分配给：协调员 (#7)
创建者：计划者 (#3)
已完成：否
```
仅当底层字段已填充时，才会显示“分配给”/“创建者”/“完成者”行。自定义 `/api` 风格的端点会返回嵌套的代理对象，以便分配为 `<display_name> (#id)`；托管的 `api.delega.dev` API 会返回原始代理 ID，因此渲染为 `#<id>`。
作为委托链一部分的任务还会显示链元数据：
```
[#def] 起草简介
状态：委托
分配给：起草者 (#3)
创建者：协调员 (#7)
委托：深度 1，abc，根 #abc
委托者：协调员 (#7)
已完成：否
上下文键：step，findings (2)
```
单任务工具（`get、`create_task`、``、`assign_task`_task`、`update_task_context`）使用详细渲染地打印完整的 `context断为 2000 个字符）。`list 使用简洁的，显示 `Context keys: …` 代替。
`` 还会在存在时显示附加的任务链接：
```
链接：
分支：delega-dev/delega-api 阶段-3-github://github.com/delega-dev/delega-api/tree/phase-3-github
PR：delega-dev/delega-api 42 — https://github.com/delega-dev/delega-api/pull/42
```
### 委托链
`get_task_chain` 返回链中任何任务的完整父/子链。输出delegation_depth`进：
```
委托链（根 #abc，深度 2，2/4 已完成）：
[#abc写报告（深度 委托）
[#def草简介（深度 完成）
[#jkl] 起草结论（深度 1，待处理）
[#ghi] 研究来源（深度 2，已完成）
```
节点按深度然后创建时间排序（与 API 的响应排序匹配）。
### 定期任务
定期任务工具管理模板。托管调度器从这些模板创建普通的任务实例；完成实例不会删除或暂停重复。
`list_recurrences`、`create_recurring_task` 和 `update_recurrence` 渲染模板及其规则、下一次到期时间、活动状态、跳过-if-打开行为和可用的代理元数据：
```
[#weekly-report] 每周报告
规则：每周，周一
时区：America/Chicago
下次到期：2026-06-22T14:00:00Z
活动：是
跳过如果打开：是
分配给：报告者 (#7)
```
## 托管 API
Delega 是一个托管服务。将 `DELEGA_API_URL` 指向 `https://api.delega.dev` — 免费额度最高可达 1,000 个任务/月。
## 链接
- [Delega](https://delega.dev) — 官方网站
- [GitHub](https://github.com/delega-dev/delega-mcp) — 源代码
- [API 文档](https://delega.dev/docs) — REST API 参考
## 许可证
MIT
