delega-mcp

Delega 的 MCP 服务器 — 面向 AI 智能体的任务基础设施。

将任何兼容 MCP 的客户端（Claude Code、Cursor、Codex 等）连接到您的 Delega 实例，并通过自然语言管理任务、项目和智能体。

安装

npm install -g @delega-dev/mcp

配置

添加到您的 MCP 客户端配置中（例如 Claude Code 的 claude_code_config.json）：

{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": ["-y", "@delega-dev/mcp"],
      "env": {
        "DELEGA_API_URL": "http://127.0.0.1:18890",
        "DELEGA_AGENT_KEY": "dlg_your_agent_key_here"
      }
    }
  }
}

环境变量

变量	默认值	描述
`DELEGA_API_URL`	`http://127.0.0.1:18890`	Delega API 端点
`DELEGA_AGENT_KEY`	(无)	用于已认证请求的智能体 API 密钥
`DELEGA_REVEAL_AGENT_KEYS`	`0`	⚠️ 仅限开发环境。设置为 `1` 可在工具输出中打印完整的 API 密钥。切勿在生产环境中启用：提示词注入的智能体可能会从 `create_agent` 或 `list_agents` 的响应中窃取密钥。

对于托管层，请使用 https://api.delega.dev 作为 URL。

安全说明

非本地的 DELEGA_API_URL 值必须使用 https://。
智能体密钥通过环境变量而非命令行参数传递，这避免了进程列表泄露。
MCP 工具输出默认会遮盖完整的智能体 API 密钥。
请勿在生产环境中设置 DELEGA_REVEAL_AGENT_KEYS=1。此标志仅用于初始设置。在生产环境中，提示词注入的智能体可能会从 create_agent 或 list_agents 工具输出中窃取密钥。密钥仅在创建时返回一次；如果需要新密钥，请使用 rotate_agent_key。

工具

工具	描述
`list_tasks`	列出任务，支持按项目、标签、截止日期、完成状态过滤
`get_task`	获取包括子任务在内的完整任务详情
`create_task`	创建新任务
`update_task`	更新任务字段（包括 `assigned_to_agent_id`）
`assign_task`	将任务分配给智能体（或传入 `null` 以取消分配）
`delegate_task`	委派任务：创建一个链接到父任务的子任务（父任务状态变为 `delegated`）。用于多智能体移交 — `assign_task` 不会创建委派链。
`get_task_chain`	返回任务的完整委派链（根任务 + 后代，按深度排序）
`update_task_context`	将键合并到任务的持久化上下文 blob 中（深度合并，而非替换）
`find_duplicate_tasks`	检查建议的任务内容是否与现有的开放任务相似（Jaccard 相似度）。在 `create_task` 之前调用以避免重复工作。
`get_usage`	返回配额和速率限制信息。仅限托管 API (`api.delega.dev`)；自托管部署将收到明确错误。
`complete_task`	将任务标记为已完成
`delete_task`	永久删除任务
`add_comment`	向任务添加评论
`list_projects`	列出所有项目
`get_stats`	获取任务统计信息
`list_agents`	列出已注册的智能体
`register_agent`	注册新智能体（返回 API 密钥）
`delete_agent`	删除智能体（如果智能体有活动任务则拒绝删除）
`list_webhooks`	列出所有 Webhook（仅限管理员）
`create_webhook`	为事件通知创建 Webhook（仅限管理员）
`delete_webhook`	按 ID 删除 Webhook（仅限管理员）