Trello MCP Server
官方Trello 官方模型上下文协议(MCP)服务器:一个云托管桥接服务,为您的 AI 工具提供对 Trello 内容(包括看板、列表、卡片、检查清单等)的安全实时访问。
你可以用 Trello MCP 做什么?
- 创建并组织看板 — 让助手创建新的 Trello 看板,或向现有看板添加卡片,用于项目规划。
- 管理卡片和列表 — 指示助手创建、更新、移动、归档或标记卡片为已完成,并在不同位置间移动列表。
- 处理清单 — 让助手创建和更新清单,并在卡片上添加或更新单个清单项。
- 在 Trello 中搜索 — 让助手在授权的工作区中按关键词查找卡片和看板。
- 管理标签 — 指示助手在卡片上附加或移除标签,以对工作进行分类。
- 安排专注时间 — 让助手查看日历事件并创建专注时间事件,将卡片链接或取消链接到这些事件。
文档
Trello MCP Server
Trello 官方 Model Context Protocol (MCP) 服务器:一个云托管桥接器,为您的 AI 工具提供对 Trello 内容(包括看板、列表、卡片、清单等)的安全、实时访问。
Trello MCP(Model Context Protocol)官方版是一个基于云的桥接器,连接您的 Trello 账户与兼容的外部 AI 助手。配置完成后,它能让这些工具使用自然语言与您的 Trello 看板、卡片和任务进行交互。
借助 Trello MCP,您无需频繁切换应用即可管理工作。您的 AI 助手可以读取 Trello 数据、搜索数据,并根据您授予的权限代表您执行操作。
发布时: 每个 Trello MCP 连接支持一个工作区。多工作区支持计划在未来的版本中提供。
支持的 AI 平台
Trello MCP 支持任何具有 MCP 支持的应用程序,包括:
有关设置详情,请参阅您的 AI 客户端的 MCP 文档或内置说明。
开始之前
确保您的环境满足成功连接 Trello MCP 的必要要求。
前提条件
- 任意套餐的 Trello 账户
- 可访问受支持的 AI 客户端
- 用于完成授权流程的现代浏览器
如何连接
对于 ChatGPT 用户: 从我们的列表页面添加 Trello MCP。
对于 Claude 用户: 从我们的列表页面添加 Trello MCP。
对于 Cursor 用户: 点击此深层链接打开 Cursor 并安装 Trello MCP。
其他 AI 平台市场中的列表可能会随着时间的推移而提供。在此之前,您可以通过在 AI 客户端中手动添加 MCP URL 来连接。
- 将 Trello MCP 服务器 URL 添加到您的 AI 客户端的 MCP 设置中:
https://mcp.trello.com/v1 - 从您的 AI 客户端启动连接流程。
- 在同意屏幕上,选择您要授权的 Trello 工作区。
- 查看并批准您要授予的权限。
提示: 如果您之后想使用需要您未授予权限的功能,请断开 Trello MCP 并重新连接,并更新权限。
代理技能
此仓库附带一个 trello-use 代理技能,指导 AI 代理如何正确调用 Trello MCP 工具——每个工具期望的 ARI id 格式、UTC 日期处理、收件箱与看板工具,以及有序创建。提前加载它可以避免常见的格式错误 ID 和时区错误。
使用 skills CLI 安装它:
# Install the trello-use skill from this repo
npx skills install atlassian/trello-mcp-server
# Or install globally (available to all your projects)
npx skills install atlassian/trello-mcp-server -g
CLI 会检测您的代理(Claude Code、Cursor 等),并将技能安装到该代理查找的位置。
支持的功能
| 类别 | 您可以执行的操作 |
|---|---|
| 成员 | 查看您的个人资料和默认设置 |
| 工作区 | 查看工作区详情 |
| 看板 | 查看和创建看板;查看标签 |
| 列表 | 查看和移动列表 |
| 卡片 | 查看、创建、更新、移动、归档和标记卡片完成;附加和移除标签 |
| 清单 | 查看、创建和更新清单;添加和更新清单项 |
| 搜索 | 按关键字搜索卡片和看板 |
| 规划器 | 查看日历事件;创建专注时间事件;将卡片链接到事件或取消链接 |
| 收件箱 | 查看、创建、更新和归档收件箱卡片 |
规划器和专注时间
用户可以将 Google 或 Outlook 日历连接到规划器以读取日历事件。但是,在规划器中创建专注时间需要 Trello Premium 或企业版。
更多功能即将推出
Trello MCP 正在积极开发中。当前版本包含用于管理看板、列表、卡片、清单和搜索的核心工具。计划在即将发布的版本中提供更多工具,以扩展您的 AI 助手可以使用 Trello 执行的操作:
| 类别 | 即将推出的功能 |
|---|---|
| 工作区 | 选择并连接多个 Trello 工作区 |
| 活动与历史 | 查看卡片、列表和看板的操作历史 |
| 评论 | 查看、添加和编辑卡片上的评论 |
| 附件 | 查看、上传和下载卡片附件 |
| 自定义字段 | 查看字段定义;获取和设置卡片上的值 |
| 标签 | 创建、查看和更新标签 |
| 看板 | 编辑看板详情(名称、可见性);归档看板 |
| 卡片 | 复制卡片 |
| 成员 | 查看和管理看板、工作区和卡片成员 |
| 规划器 | 查看与特定卡片关联的事件 |
随着新功能的推出,我们将更新此页面。
数据与安全
- 身份验证 - Trello MCP 使用 OAuth 2.0 进行安全身份验证和访问控制。
- 工作区范围访问 - 您的 AI 助手只能访问您在同意屏幕上明确授权的工作区。
- 权限管理 - 所有操作都尊重您现有的 Trello 权限。您的 AI 助手无法执行超出您直接在 Trello 中可执行的操作。
- 无破坏性操作 - 不支持破坏性删除操作。您的助手可以归档卡片和列表,但不能永久删除它们。
- 可撤销访问 - 您可以随时撤销 AI 助手的访问权限。
管理员控制
组织管理员可以通过 Atlassian Administration 管理 Trello MCP 的使用方式。
- 控制 Atlassian Rovo MCP 服务器设置 - 管理允许或阻止您的组织使用的 MCP 服务器域。
- 配置 Atlassian Rovo MCP 服务器权限 - 控制用户连接到 MCP 服务器(包括 Trello MCP)时允许的访问级别(读取、写入、搜索)。
- 管理员 MCP 访问控制 - 通过 admin.atlassian.com 管理的企业组织可以在 Atlassian Administration 中配置 MCP 访问控制。
Trello MCP 服务器使用与 Atlassian Rovo MCP 服务器相同的管理员控制框架。不需要单独的 Trello 特定管理工具。
您可以做什么
连接后,您可以要求 AI 助手执行各种任务。
捕获和组织想法
- “为我们刚刚讨论的项目计划创建一个 Trello 看板。”
- “将这些书添加到我的 Trello 阅读列表看板中。”
查看您的工作
- “本周我有哪些 Trello 任务到期?”
- “显示我所有看板中逾期未完成的所有内容。”
- “我的厨房翻新看板当前进展如何?”
更新任务
- “在我的季度回顾卡片中添加一个名为‘准备步骤’的清单。”
- “将我的‘提交报告’卡片标记为完成。”
- “将‘修复登录错误’卡片移动到我的冲刺看板上的‘进行中’列表。”
清理和分类
- “归档我收件箱中超过一周的所有内容。”
- “将我收件箱中的所有内容移动到相应的看板。”
- “帮助我将这三个看板合并为一个。”
安排专注时间
- “明天早上为‘起草社交文案’预留 2 小时。”
- “今天什么时候适合我排练演示文稿?”
个人洞察和看板丰富
- “提取我去年标记为完成的所有 Trello 卡片,并写一份我可以在年度绩效评估中使用的总结。”
- “查看我的婚礼策划看板上的任务,并添加任何缺失的内容。”
Trello MCP 与 Atlassian Rovo MCP 对比
| Trello MCP | Atlassian Rovo MCP | |
|---|---|---|
| 访问范围 | 仅 Trello 数据 | Jira、Confluence、Compass、Bitbucket 以及更多 Atlassian 产品数据 |
| 适用对象 | 连接外部 AI 助手的 Trello 用户 | 将外部 AI 助手连接到 Atlassian 产品的 Atlassian Cloud 用户 |
| 范围 | 启动时每个连接一个 Trello 工作区 | Atlassian 云站点范围 |
在未来的版本中,对于同时使用 Trello 和其他 Atlassian 产品的客户,Trello 数据也可能通过 Atlassian Rovo MCP 服务器提供。
常见问题解答
使用 Trello MCP 是否需要付费 Trello 套餐?
不需要。Trello MCP 适用于所有 Trello 套餐。但是,在规划器中创建专注时间需要 Trello Premium 或企业版。在规划器中从连接的 Google 或 Outlook 日历读取日历事件则更广泛可用。
什么是 Trello MCP 服务器?
Trello MCP 服务器是安全连接层,允许 Claude 或 ChatGPT 等 AI 助手根据您批准的权限访问 Trello 数据。
我可以授予哪些权限?
Trello MCP 可以请求读取和写入权限。读取权限允许 AI 助手查看您现有的工作作为上下文。写入权限允许它们使用您现有的 Trello 权限代表您创建和更新工作。搜索权限允许它们查找相关的 Trello 内容而不更改它。
如果我不授予所有权限会怎样?
某些 Trello MCP 功能可能无法使用。如果您之后想使用依赖于您未授予权限的功能,请断开 Trello MCP 并重新连接,并更新权限。
为什么我无法为组织外部的工作区授予收件箱和规划器权限?
收件箱和规划器权限在账户级别运行,并与您组织的管理控制相关联。如果您选择的工作区不属于您的组织,这些权限可能会被禁用。您仍然可以授予该工作区看板和卡片的读取和写入权限。
我看到“对此域的访问受到限制。”这是什么意思?
您的组织管理员已在组织设置中阻止了 MCP 服务器域。请联系您的组织管理员请求访问或查看域限制设置。
我看到“此工作区的权限已被阻止。”我该怎么办?
您的管理员尚未允许该工作区或产品访问组合的 MCP 权限。请联系您的组织管理员或查看 MCP 权限设置。
我看到“未找到 Trello 工作区”或“没有可用的工作区。”为什么?
如果您使用与 Trello 不同的 Atlassian 账户登录,或者您不再属于任何 Trello 工作区,或者您的访问权限已更改,则可能出现这种情况。在某些情况下,即使没有工作区,您仍然可以连接 Inbox 和 Planner,但在您加入或创建工作区之前,看板、卡片和列表将不可用。
我看到“您不再拥有此工作区的访问权限。”发生了什么?
您对该工作区的访问权限已被移除。如果还有其他工作区,请选择其他工作区,或联系工作区管理员恢复访问权限。
我在权限屏幕上看到“出现问题”。我该怎么办?
这通常意味着无法加载权限数据。请刷新页面并重试。如果问题仍然存在,请联系 Trello 支持。
我的 AI 助手可以永久删除看板或卡片吗?
不可以。Trello MCP 不支持破坏性删除操作。您的助手可以归档卡片和列表,但不能永久删除它们。
我的数据安全吗?
是的。Trello MCP 使用 OAuth 2.0 进行身份验证。您的 AI 助手只能访问您在同意屏幕上明确授权的工作区。您可以随时撤销访问权限。
我是 Trello Enterprise 管理员。如何控制我的用户是否可以使用 Trello MCP?
转到 Atlassian Administration → Rovo → Rovo MCP server → Permissions。在 Read 或 Write 下点击“Edit details”,然后取消选中 read_trello 或 write_trello。
作为 Enterprise 管理员,我能否在不完全禁用 Trello MCP 的情况下限制用户连接的 MCP 服务器域名?
可以。转到 Atlassian Administration → Rovo → Rovo MCP server → Domains,以允许或阻止特定的 MCP 服务器域名。
Atlassian Administration 中的 API 令牌身份验证设置是否适用于 Trello MCP?
不适用。Atlassian Administration > Rovo > Rovo MCP server 下的“Authentication”选项卡与 Trello MCP 无关。Trello 目前不支持基于 API 令牌的 MCP 连接身份验证。Trello MCP 使用 OAuth 同意(用户在连接其 AI 客户端时通过同意屏幕进行授权)。
但是,如果您的组织还使用 Atlassian Rovo MCP(用于 Jira/Confluence),则 API 令牌身份验证设置确实适用于该处。这些是独立的配置,对 Authentication 选项卡的更改不会影响 Trello MCP 的访问。