内容
# Trello MCP — n8n
一款基于n8n的Trello模型上下文协议（MCP）服务器，为Claude（或任何MCP客户端）提供对Trello板块、列表、卡片和评论的完全读写访问权限。
**4个领域共18种工具：** 板块 · 列表 · 卡片 · 评论
---
## 功能介绍
连接后，您可以自然地与Claude交流：
- _"我有哪些板块？"_
- _"显示 backlog 列表中的所有卡片"_
- _"在 To Do 列表中创建一个名为 '修复登录错误' 的卡片，截止日期为周五"_
- _"将 API 集成卡片移动到进行中"_
- _"谁被分配到 onboarding 卡片？"_
- _"归档已完成列表中的所有内容"_
---
## 前置条件
- 一个具有API密钥和令牌的[Trello](https://trello.com)账户
- 一个[n8n](https://n8n.io)实例（云或自托管）
- [Claude Desktop](https://claude.ai/download) 或任何兼容MCP的客户端
---
## 设置
### 1. 获取您的Trello凭证
1. 访问 [https://trello.com/power-ups/admin](https://trello.com/power-ups/admin)
2. 创建一个新的Power-Up → 获取您的 **API密钥**
3. 点击 **令牌** 在您的API密钥旁边 → 授权 → 复制 **令牌**
### 2. 将工作流导入n8n
1. 下载 [`workflow/trello-mcp-v2.json`](workflow/trello-mcp-v2.json)
2. 在n8n中：**工作流 → 导入 → 上传文件**
3. 打开导入的工作流
4. 点击任意工具节点 → **凭证 → 创建新凭证 → Trello API**
5. 输入您的API密钥和令牌
6. 使用 **"将凭证应用于所有节点"** 选项 — 这会将其分配给所有18个节点
7. **激活** 工作流（右上角切换）
> **n8n云免费层：** 在 [n8n.io](https://n8n.io) 注册 — 免费层足以满足此工作流的需求。
### 3. 获取您的MCP端点URL
激活后，您的MCP端点是：
```
https://您的N8N实例/mcp/trello-v2
```
对于n8n云，网址如下：
```
https://您的用户名.app.n8n.cloud/mcp/trello-v2 4. 连接到Claude Desktop
如果您尚未安装，请安装 `mcp-remote`：
```bash
npm install -g mcp-```
将以下内容添加到您的 `claude_desktop_config.json` 中：
**macOS:** `/Application Support/Claude/claude_desktop`
** `%APPDATA%\Clclaude_desktop_config.jsonjson
{
"mcp {
"trello": {
"command": "npx",
"args": [
"mcp-remote "https://您的N8N实例/mcp/trello-v2"
]
}
```
重启Claude Desktop。您应该在工具面板中看到工具可用。
### 5.正常工作aude中尝试此提示：
> 获取我所有的Trello板块，然后显示第一个板块的列表，然后显示第一个列表中的卡片。
---
## 工具参考
### 板块
| 工具 | 描述 | 必需参数 |
|---|---|---|
| `trello_get_all_boards` | 认证用户可以访问的所有板块 | — |
| `trello_get_board_members` | 板块的所有成员 | `板块ID` |
| `trello_get_board_labels` | 板块上定义的所有标签 | `板块ID` |
### 列表
| 工具 | 描述 | 必需参数 |
|---|---|---|
| `trello_get_lists_on_board` | 板块上的所有开放列表 | `板块ID` |
| `trello_get_list_cards` | 列表中的所有开放卡片 | `列表ID` |
| `trello_create_list` | 在板块上创建新列表 | `板块ID`, `列表名称` |
| `trello_archive_list` | 存档列表 | `列表ID` |
### 卡片
| 工具 | 描述 | 必需参数 |
|---|---|---|
| `trello_get_board_cards` | 板块上的所有开放卡片 | `板块ID` |
| `trello_get_card_details` | 卡片的完整详情（评论、检查清单） | `卡片ID` |
| `trello_search_cards` | 按关键词或Trello搜索语法搜索卡片 | `查询` |
| `trello_create_card` | 创建卡片 | `列表ID`, `卡片名称` |
| `trello_update_card` | 更新名称、描述、截止日期或列表 | `卡片ID` |
| `trello_archive_card` | 存档卡片 | `卡片ID` |
| `trello_move_card` | 将卡片移动到不同列表或板块 | `卡片ID`, `目标列表ID` |
| `trello_assign_member` | 将成员分配给卡片 | `卡片ID`, `成员ID` |
| `trello_assign_label` | 将标签分配给卡片 | `卡片ID`, `标签ID### 评论
| 工具 | 描述 | 必需参数---|---|---|
| `trello_get_comments` | 卡片上的 | `卡片ID` |
| `trello_add_comment 向卡片添加卡`, `评论文本` |
完整参数文档：[`docs/tools.md`](docs/tools.md)
---
## 推荐的Claude项目系统如果您使用Claude添加 [`docs/system-prompt.md`](docs/system-prompt.md系统提示，以为Cl更好的上下文，告诉它如何使用这些工具。
---
## 故障aude Desktop中用**
- 确认在n8n中已激活
- 确认中启用了MCP（工作流设置 →MCP）
- 编辑aude_desktop_config.json` 后aude Desktop
**身份验证错误**
- 在 [https://.com/power-ups/admin](https://trello.com/power) 重新生成Trello令牌
- 在n更新凭证
**工具返回空结果 首先运行 `trello_get_all_boards` — 大多数工具需要从先前调用中发现的ID
- 确认您在Trello中有权访问板块
---
## 路线图
- [ ] 检查清单 — `create_checklist`, `add_checklist_item`,_item`
- [ ] 标签 — `create_label`, `delete_label`
- [hooks — 实时卡片更新通知
- [ ]独立部署（无需n8n）
---
## 贡献
欢迎提出问题和拉取请求。有关错误报告和功能请求，请参见 [ISSUE_TEMPLATE](.github/ISSUE_TEMPLATE)。
---
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)
