名称: trello-setup 描述: 将Trello连接到Dex，实现可视化Kanban任务同步清单: id: trello 认证: api_key_token 类别: task_sync mcp_server: mcp-server-trello 运行时: bun

Trello设置

将您的Trello看板连接到Dex，使您的任务、项目和每日计划与Trello Kanban看板保持同步。

功能启用

一旦连接，Dex可以：

任务同步： 在Dex中创建的任务会出现在您的Trello看板上；在Trello中移动到“完成”列表的卡片会在Dex中标记任务为完成
项目健康： 查看实时看板状态——按列表的卡片、被阻止的项目、过时的卡片
每日计划： 显示分配给您的Trello卡片，包括逾期项目
会议准备： 知道哪个看板有被阻止的卡片需要与参会者讨论

隐私

同步卡片标题和状态。除非您要求，否则不会读取附件或评论。
您的API密钥和令牌保留在本地机器上，并被git忽略
同步是按需的（在每日计划或任务创建期间）——无后台轮询
仅访问您明确配置的看板

何时运行

用户输入/trello-setup
用户询问连接Trello
用户希望在每日计划或项目健康中获取Kanban看板上下文
在/integrate-mcp期间，如果提到Trello

设置流程

步骤1: 检查是否已连接

检查System/integrations/config.yaml是否有trello:部分，且enabled: true
如果找到，跳到步骤6（配置看板映射）
如果未找到，继续到步骤2

步骤2: 解释我们将要设置什么

说：

**让我们将Trello连接到Dex。**

这链接了您的Trello看板，使任务在Dex和Trello之间同步。
卡片在列表间移动 = Dex中的状态更新。简单的Kanban同步。

**您需要什么：**
- 至少有一个看板的Trello账户
- 您的Trello API密钥和令牌（我将引导您获取这些）
- 大约3分钟

**准备好了吗？**

等待确认。

步骤3: 获取API凭据

引导用户获取Trello API密钥和令牌：

**步骤1: 获取您的API密钥**

1. 访问 https://trello.com/power-ups/admin
2. 点击“新建”创建一个新的Power-Up（或使用现有的）
3. 从Power-Up设置中复制您的**API密钥**

**步骤2: 生成令牌**

1. 在同一页面，点击链接生成**令牌**
2. 授权应用
3. 复制出现的令牌

**准备好时粘贴您的API密钥和令牌。**

等待用户提供两个值。

步骤4: 添加MCP服务器

检查用户的MCP配置。如果mcp-server-trello未列出：

解释我们将要添加什么：

我将把Trello连接器添加到您的Dex配置中。
这使用mcp-server-trello，它在Bun上运行以实现高性能。

添加到用户的.mcp.json：

{
  "mcp-server-trello": {
    "command": "bunx",
    "args": ["-y", "mcp-server-trello"],
    "env": {
      "TRELLO_API_KEY": "<用户的api密钥>",
      "TRELLO_TOKEN": "<用户的令牌>"
    }
  }
}

告诉用户MCP服务器需要重启以使更改生效。

步骤5: 测试连接

运行快速测试以确认一切正常：

通过Trello MCP列出用户的看板
显示简要摘要：

**连接测试：**
- 找到[N]个看板：[看板名称1]、[看板名称2]、...
- API访问已确认

一切看起来很好！

如果失败，故障排除：

那没成功。检查以下几点：

1. **API密钥正确吗？** 应该是一个32个字符的字符串
2. **令牌正确吗？** 应该是一个更长的字符串（64+字符）
3. **账户访问权限？** 确保令牌有读/写权限

想重新输入您的凭据吗？

重试最多2次，然后提供跳过并稍后回来。

步骤6: 配置看板映射

询问用户要同步哪个看板：

**Dex应该同步哪个Trello看板？**

以下是您的看板：
1. [看板名称1]
2. [看板名称2]
3. [看板名称3]

选择一个看板（或说“显示全部”以获取完整列表）。

您稍后可以通过再次运行`/trello-setup`来添加更多看板。

在他们选择一个看板后：

**现在让我们将您的列表映射到Dex状态。**

我将查看[看板名称]上的列表：
- “待办” -> 待办事项（未开始）
- “进行中” -> 已开始
- “审核” -> （未映射——保留或映射到被阻止？）
- “完成” -> 完成

这个映射看起来对吗？或者我应该调整吗？

让用户确认或自定义映射。默认状态列表名称：

待办事项 / To Do / TODO -> 状态 n
进行中 / In Progress / Active -> 状态 s
被阻止 / On Hold / Waiting -> 状态 b
完成 / Complete / Finished -> 状态 d

步骤7: 信任级别

询问同步行为：

**Dex应该如何处理Trello同步？**

1. **自动同步** — 在每日计划和任务创建期间自动同步卡片
2. **每次询问** — Dex显示更改内容并在同步前询问

您偏好哪个？（大多数人选择自动同步）

步骤8: 保存配置

写入System/integrations/config.yaml —— 更新trello部分：

trello:
  enabled: true
  task_sync: true
  configured_at: YYYY-MM-DD
  api_key: <用户的api密钥>
  token: <用户的令牌>
  default_board: <看板id>
  board_name: <看板名称>
  trust_level: auto | ask
  list_mapping:
    backlog: <待办事项的列表id>
    in_progress: <进行中的列表id>
    blocked: <被阻止的列表id>
    done: <完成的列表id>
  features:
    task_sync: true
    project_health: true
    daily_plan: true
    meeting_prep: true

如果文件已存在，仅更新trello:部分。保留其他集成配置。

步骤9: 确认

**Trello已连接！**

以下是现在发生的变化：

- **任务同步** — 新的Dex任务出现在您的[看板名称]看板上。在Trello中完成的卡片会在Dex中标记任务为完成。
- **项目健康** (`/project-health`) 显示实时看板状态——按列表的卡片、被阻止的项目
- **每日计划** (`/daily-plan`) 包括分配给您的Trello卡片和逾期项目
- **会议准备** (`/meeting-prep`) 显示与参会者相关的被阻止卡片

**能力级联：** 这些技能现在内置了Trello意识。

您可以通过再次运行`/trello-setup`来随时调整设置。

故障排除

令牌过期

Trello令牌可以设置为过期。如果您看到认证错误：

访问 https://trello.com/power-ups/admin
生成一个新令牌
更新System/integrations/config.yaml中的新令牌
重启MCP服务器

看板未找到

如果配置的看板被删除或重命名：

运行/trello-setup重新配置
选择新看板
如果需要，重新映射列表

速率限制

Trello允许每10秒100个请求。这很宽松——只有在批量同步时才会触及。如果您看到速率限制错误，等待10秒后重试。

卡片未同步

检查：

看板ID在config.yaml中正确吗？
令牌有写访问权限吗？
列表名称匹配吗？（列表映射不区分大小写，但名称必须部分匹配）

重新配置

如果用户已配置时运行/trello-setup：

从System/integrations/config.yaml显示当前配置
提供选项：
- 更改同步看板
- 更新列表映射
- 更改信任级别（自动/询问）
- 重新认证（新API密钥/令牌）
- 添加额外看板
- 断开Trello连接

断开连接流程

如果用户想断开连接：

更新System/integrations/config.yaml：
```
trello:
  enabled: false
```
确认：“Trello已断开连接。您的每日计划和项目健康将不再包含Trello上下文。随时运行/trello-setup重新连接。”

名称: trello-setup 描述: 将Trello连接到Dex，实现可视化Kanban任务同步 清单: id: trello 认证: api_key_token 类别: task_sync mcp_server: mcp-server-trello 运行时: bun