LTD MCP

LTD MCP

面向 AI Agent 的项目管理 MCP。

LTD MCP 让 AI Agent 能通过 MCP 连接到 LTD 工作区，并安全地处理项目工作：检查项目健康状况、搜索任务、创建任务、更新任务、分配负责人，以及使用范围受限的 API 令牌和预览确认写入来添加评论。

状态：公开预览早期阶段。读取工具已可用。写入工具采用两步预览确认安全流程。

为什么要构建它

大多数项目管理工具都是为通过点击仪表板来操作的人类设计的。AI Agent 需要安全、结构化的工具。

LTD MCP 是 LTD 的原生 Agent 接口。LTD 是一个反 Jira 风格的项目工作区，面向希望人类和 AI Agent 协同工作的团队。

MCP 端点

https://api.eshway.com/mcp/

传输方式：Streamable HTTP / HTTP MCP

身份验证：Bearer 令牌

Authorization: Bearer <LTD_API_TOKEN>

功能

读取工具

• ltd_list_projects - 列出令牌有权访问的项目
• ltd_describe_project - 描述状态、自定义字段和成员
• ltd_search_tasks - 搜索／筛选任务
• ltd_get_task - 获取完整任务详情
• ltd_my_tasks - 列出令牌所有者未完成的任务
• ltd_get_comments - 读取任务评论
• ltd_project_pulse - 汇总项目健康状况
• ltd_analytics_query - 查询分析聚合数据
• ltd_drilldown_tasks - 深入查看分析数据点对应的任务

写入工具

• ltd_create_task - 创建任务
• ltd_update_task - 更新任务字段
• ltd_add_comment - 添加评论

写入工具有意设计为两步操作：

1. mode="preview" 返回拟议更改的准确内容和一个短时有效的确认令牌。不会写入任何内容。
2. 使用相同参数，并附上 confirm_token 调用 mode="confirm"，即可执行写入。

令牌权限范围

在 LTD Settings → API tokens 中创建 LTD API 令牌。

建议的权限范围：

• mcp:read 用于只读项目查看
• mcp:write 用于创建任务、更新任务、分配负责人和添加评论

请妥善保管令牌。需要时，可在 LTD 设置中撤销并轮换令牌。

快速入门

通用 MCP HTTP 配置

{
  "mcpServers": {
    "ltd": {
      "transport": "http",
      "url": "https://api.eshway.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${LTD_API_TOKEN}"
      }
    }
  }
}

Hermes

mcp add ltd --transport http \
  --url https://api.eshway.com/mcp/ \
  --header "Authorization: Bearer $LTD_API_TOKEN"

Smithery

smithery mcp add https://api.eshway.com/mcp/ --id ltd

示例提示词

Show me all LTD projects I can access.

Give me a project pulse for PS - Mini and list the top risks.

Create a low-priority test task in PS - Mini assigned to Eshu, but show me the preview before confirming.

Find stale tasks assigned to me, group them by status, and suggest next actions.

安全模型

LTD MCP 专为由人类控制的 Agent 操作而设计：

• 范围受限的 PAT 可限制访问权限。
• 读取权限范围与写入权限范围相互独立。
• 写入操作采用预览确认流程。
• 预览会明确返回 nothing_changed_yet: true。
• 确认令牌有效期短且只能使用一次。
• 无效的受指派人／状态会在写入前被拒绝。

写入流程示例

预览：

{
  "project_id": 168,
  "title": "Test task created by ZERO",
  "description": "Verify LTD MCP task creation.",
  "status": "To Do",
  "assignees": ["Eshu"],
  "priority": "Low",
  "mode": "preview"
}

确认：

{
  "project_id": 168,
  "title": "Test task created by ZERO",
  "description": "Verify LTD MCP task creation.",
  "status": "To Do",
  "assignees": ["Eshu"],
  "priority": "Low",
  "mode": "confirm",
  "confirm_token": "<token from preview>"
}

支持的客户端

任何支持远程 HTTP / Streamable HTTP MCP 服务的 MCP 客户端都应该可以使用。

计划编写的文档：

• Claude Desktop
• Cursor
• Cline
• Windsurf
• Hermes / ZERO
• Smithery

链接

• MCP 端点：https://api.eshway.com/mcp/
• 网站：https://ltd.eshway.com/
• 产品：Eshway 的 LTD

路线图

• 公开托管文档
• 演示工作区
• 特定客户端的设置指南
• 官方 MCP Registry 收录
• Smithery 收录
• MCP.so 收录
• 审计日志文档
• OAuth 支持

许可证

本仓库中的文档和示例采用 MIT 许可证。LTD 服务端实现和托管服务归 Eshway 所有。