← 返回目录

MCP Server Trello

社区

为 AI 代理提供完整访问 Trello 看板的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 16 / 55
Stars: ★ 446 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Bun 1.0.0+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前
工具数: 35

58FMRS · C

该服务器提供了全面的 Trello 集成，包含 57 种工具，涵盖清单、附件、评论和自定义字段管理。它支持动态看板和工作区选择，并内置速率限制。唯一潜在缺点是依赖 Bun 和需要高权限的 API 凭据。

最强项 · 文档质量 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

12/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: README 和 manifest 描述了 stdio 服务器和大量工具，但未提供源代码、CI 工作流或测试文件，无法实际验证启动、初始化握手或工具行为。README 中的多处代码片段存在乱码/拼写错误（如 'mbs;'、's;'），进一步降低了可信度。评分低于 10 是因为快乐路径仅停留在文档层面，测试和错误处理证据缺失。
安全与权限 10/20: 凭据通过环境变量 TRELLO_API_KEY 和 TRELLO_TOKEN 传入，manifest 标记为 secret，安装示例中无真实令牌。TRELLO_ALLOWED_WORKSPACES 提供了可选的工作区访问限制，符合最小权限原则。但未提供源码供检查日志泄露、凭据存储或数据流披露；archive/delete 等破坏性操作没有描述显式确认机制，Trello token 本身也是全权限的，故不能给高分。
维护活跃度 12/20: 仓库未归档，MIT 许可证明确，manifest 显示 npm 包版本 1.8.1，README 引用 CHANGELOG，说明有一定维护轨迹。但缺少 issue 响应时效、依赖更新节奏、安全漏洞响应渠道等证据，21 个 open issues 也未展示处理情况，因此达不到 20 分。
文档质量 15/20: README 覆盖面广：安装、认证、环境变量、工具参数示例、日期格式、速率限制、错误处理、客户端配置（Claude Desktop / Claude Code）均有说明，且有 CHANGELOG 和 skill 分层文档。扣分原因是代码片段中有明显损坏/乱码，缺少 troubleshooting 章节，宣传的 57 个工具并未完整枚举。
安装易用性 14/20: 安装路径清晰：npm 发布、npx/bunx 一条命令、提供 Claude Desktop 和 Claude Code 的复制即用配置、环境变量说明完整。但静态校准要求 setup 不超过 15，且收到的材料中没有 CI 或测试证据可验证执行；Bun 的依赖前提和 Node 兼容性也未完全说明，因此给 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要 AI 代理访问 Trello 并管理项目任务的团队。
希望使用 AI 助手自动化看板工作流的开发者。

不适合谁

不需要 Trello 的实时交互，僅需只读访问的场景。
对性能要求极高，且无法接受 Bun 依赖的环境。

所需权限

需要 Trello API 密钥和令牌，允许服务器代表用户访问 Trello 数据。
默认可以访问令牌权限范围内的所有看板和工作区。
可选限制访问特定工作区（通过环境变量 TRELLO_ALLOWED_WORKSPACES）。

风险与副作用

API 凭据泄露风险，需妥善保管密钥和令牌。
AI 可能误操作，如意外删除卡片或评论。
不当使用可能触发 Trello 速率限制。

安装接入

准备工作

运行环境：Node.js · Bun 1.0.0+

TRELLO_API_KEY 必填密钥必填，Trello API密钥，在 trello.com/app-key 获取；为私密信息。

TRELLO_TOKEN 必填密钥必填，Trello令牌，在 trello.com/app-key 同一页面用API密钥生成；为私密信息。

其他可选配置项（3 个）

TRELLO_BOARD_ID 可选可选（已弃用），默认看板ID，可从看板URL获取，之后可用 set_active_board 更改。

TRELLO_WORKSPACE_ID 可选可选，初始工作区ID，可在工作区设置中找到或用 list_workspaces 工具查询。

TRELLO_ALLOWED_WORKSPACES 可选可选，逗号分隔的工作区ID列表，用于限制可访问的工作区。

在 Trello 获取 API 密钥和令牌：访问 https://trello.com/app-key。
在 MCP 客户端配置中添加服务器，例如 Claude Desktop 的配置。
使用 bunx 或 npx 启动服务器，并设置环境变量 TRELLO_API_KEY 和 TRELLO_TOKEN。

claude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "bunx",
      "args": [
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "your-trello-api-key",
        "TRELLO_TOKEN": "your-trello-token"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "trello": {
      "command": "bunx",
      "args": [
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "your-trello-api-key",
        "TRELLO_TOKEN": "your-trello-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add trello -e TRELLO_API_KEY=your-trello-api-key -e TRELLO_TOKEN=your-trello-token -- bunx @delorenj/mcp-server-trello

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后重启客户端，工具列表中应出现 get_acceptance_criteria、list_boards、set_active_board 等工具；调用 list_boards 能返回你的Trello看板即证明连接成功。

常见排障

常见问题检查： - 确认 TRELLO_API_KEY 和 TRELLO_TOKEN 正确无误。 - 检查网络连接，确保能访问 Trello API。 - 如遇速率限制，等待稍后重试。 - 查看错误消息，确认提供的看板、列表或卡片 ID 是否正确。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我所有的Trello看板，然后把开发看板设为活跃看板。
把当前看板所有列表里的卡片列出来，并按待办状态整理。
给卡片加上一条验收标准清单项，然后帮我查看完成进度。
查看这张卡片的最近评论，并回复一条备注。

工具能力 35

get_checklist_items 只读

按名称获取清单中的所有项目。

add_checklist_item 写入

向现有清单添加新项目。

find_checklist_items_by_description 只读

搜索包含特定文本的清单项目。

get_acceptance_criteria 只读

获取“验收标准”清单中的所有项目。

get_checklist_by_name 只读

获取完整清单，包括所有项目和完成百分比。

update_checklist_item 写入

更新现有清单项目。

delete_checklist_item 破坏性

删除现有清单项目。

get_card 只读

获取指定 Trello 卡片的详细完整信息。

展开其余 27 个工具

get_cards_by_list_id 只读

从特定列表获取所有卡片。

get_lists 只读

从看板获取所有列表。

get_recent_activity 只读

获取看板上的最近活动。

add_card_to_list 写入

向指定列表添加新卡片。

update_card_details 写入

更新现有卡片的详情。

archive_card 写入

将卡片存档。

add_list_to_board 写入

向看板添加新列表。

archive_list 写入

将列表存档。

update_list 写入

更新列表的名称、存档状态、订阅状态或所属看板。

update_list_position 写入

更新列表在看板上的位置。

get_my_cards 只读

获取分配给当前用户的所有卡片。

move_card 写入

将卡片移动到不同的列表。

attach_image_to_card 写入

从 URL 将图像附加到卡片。

attach_file_to_card 写入

从 URL 或本地文件路径将任意类型文件附加到卡片。

download_attachment 只读

按 ID 下载卡片中的附件。

add_comment 写入

向 Trello 卡片添加评论。

update_comment 写入

更新卡片上的现有评论。

delete_comment 破坏性

从卡片中删除评论。

get_card_comments 只读

获取特定卡片的所有评论。

list_boards 只读

列出用户有权访问的所有看板。

set_active_board 写入

设置活跃看板以供后续操作使用。

list_workspaces 只读

列出用户有权访问的所有工作区。

set_active_workspace 写入

设置活跃工作区以供后续操作使用。

list_boards_in_workspace 只读

列出特定工作区中的所有看板。

get_active_board_info 只读

获取当前活跃看板的信息。

get_board_custom_fields 只读

获取看板上所有自定义字段的定义。

update_card_custom_field 写入

设置或清除卡片上的自定义字段值。

使用场景

通过 AI 助手管理看板、列表和卡片。

从卡片中提取验收标准。

自动化评论和附件操作。

在多个工作区和看板之间切换。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

一个 Model Context Protocol (MCP) 服务器，为 AI 代理提供对 Trello 看板的全面访问，包括卡片、列表、清单、附件、评论、自定义字段和工作区。内置速率限制、类型安全和工作流级工具，如验收标准提取和清单依赖查询。共 57 个工具，通过 npx 安装，基于 Bun 构建。