Trello MCP Server

官方

Trello 官方模型上下文协议(MCP)服务器:一个云托管桥接服务,为您的 AI 工具提供对 Trello 内容(包括看板、列表、卡片、检查清单等)的安全实时访问。

你可以用 Trello MCP 做什么?

  • 创建并组织看板 — 让助手创建新的 Trello 看板,或向现有看板添加卡片,用于项目规划。
  • 管理卡片和列表 — 指示助手创建、更新、移动、归档或标记卡片为已完成,并在不同位置间移动列表。
  • 处理清单 — 让助手创建和更新清单,并在卡片上添加或更新单个清单项。
  • 在 Trello 中搜索 — 让助手在授权的工作区中按关键词查找卡片和看板。
  • 管理标签 — 指示助手在卡片上附加或移除标签,以对工作进行分类。
  • 安排专注时间 — 让助手查看日历事件并创建专注时间事件,将卡片链接或取消链接到这些事件。

文档

Trello

Trello MCP Server

Trello 官方 Model Context Protocol (MCP) 服务器:一个云托管桥接器,为您的 AI 工具提供对 Trello 内容(包括看板、列表、卡片、清单等)的安全、实时访问。

Official Trello Server GitHub stars License: Apache 2.0 Status: Available

Model Context Protocol compatible Auth: OAuth 2.0 Hosting: Atlassian Cloud

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 来连接。

  1. 将 Trello MCP 服务器 URL 添加到您的 AI 客户端的 MCP 设置中:https://mcp.trello.com/v1
  2. 从您的 AI 客户端启动连接流程。
  3. 在同意屏幕上,选择您要授权的 Trello 工作区。
  4. 查看并批准您要授予的权限。

提示: 如果您之后想使用需要您未授予权限的功能,请断开 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 的使用方式。

Trello MCP 服务器使用与 Atlassian Rovo MCP 服务器相同的管理员控制框架。不需要单独的 Trello 特定管理工具。

您可以做什么

连接后,您可以要求 AI 助手执行各种任务。

捕获和组织想法

  • “为我们刚刚讨论的项目计划创建一个 Trello 看板。”
  • “将这些书添加到我的 Trello 阅读列表看板中。”

查看您的工作

  • “本周我有哪些 Trello 任务到期?”
  • “显示我所有看板中逾期未完成的所有内容。”
  • “我的厨房翻新看板当前进展如何?”

更新任务

  • “在我的季度回顾卡片中添加一个名为‘准备步骤’的清单。”
  • “将我的‘提交报告’卡片标记为完成。”
  • “将‘修复登录错误’卡片移动到我的冲刺看板上的‘进行中’列表。”

清理和分类

  • “归档我收件箱中超过一周的所有内容。”
  • “将我收件箱中的所有内容移动到相应的看板。”
  • “帮助我将这三个看板合并为一个。”

安排专注时间

  • “明天早上为‘起草社交文案’预留 2 小时。”
  • “今天什么时候适合我排练演示文稿?”

个人洞察和看板丰富

  • “提取我去年标记为完成的所有 Trello 卡片,并写一份我可以在年度绩效评估中使用的总结。”
  • “查看我的婚礼策划看板上的任务,并添加任何缺失的内容。”

Trello MCP 与 Atlassian Rovo MCP 对比

Trello MCPAtlassian 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_trellowrite_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 的访问。