trello-mcp-server

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="images/Trello_logo_dark.svg"> <img src="images/Trello_logo_light.svg" alt="Trello" width="200"> </picture> </p> <h1 align="center">Trello MCP 服务器</h1> <p align="center"> <b>Trello 官方模型上下文协议（MCP）服务器：一个云托管的桥梁，为您的 AI 工具提供安全、实时的 Trello 内容访问，包括板块、列表、卡片、检查清单等。</b> </p> <!-- Line 1 · Project --> <p align="center"> <a href="https://github.com/atlassian/trello-mcp-server"><img src="https://img.shields.io/badge/%E5%AE%98%E6%96%B9-Trello-1558BC?logo=trello&logoColor=white" alt="官方 Trello 服务器"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/atlassian/trello-mcp-server?label=%E6%89%8B%E6%9D%83&color=1558BC" alt="许可证：Apache 2.0"></a> <a href="https://github.com/atlassian/trello-mcp-server"><img src="https://img.shields.io/badge/%E7%8A%B6%E6%80%81-%E5%8F%AA%E7%94%B0-2EBC4F" alt="状态：可用"></a> </p> <!-- Line 2 · Protocol & access --> <p align="center"> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/%E6%A8%A1%E5%9E%9F%E6%96%87%E6%89%8B%E5%8D%8F%E8%AE%AA%E5%90%8C%E6%80%92-000000?logo=modelcontextprotocol&logoColor=white" alt="模型上下文协议兼容"></a> <a href="#data-and-security"><img src="https://img.shields.io/badge/%E9%AA%8C%E6%9A%8A-OAuth_2.0-2EBC4F" alt="验证：OAuth 2.0"></a> <a href="https://www.atlassian.com/cloud"><img src="https://img.shields.io/badge/%E9%99%8C%E5%90%8C-%E9%98%BF%E9%87%8C%E4%BA%AD%E4%BD%8E%E4%BA%91-1558BC?logo=atlassian&logoColor=white" alt="托管：Atlassian 云"></a> </p> Trello 官方 MCP（模型上下文协议）服务器是 Trello 账户与外部 AI 助手之间的云端桥梁。配置完成后，它允许这些工具使用自然语言与您的 Trello 板块、卡片和任务进行交互。 使用 Trello MCP，您可以在不需要不断切换应用程序的情况下管理工作。您的 AI 助手可以根据您授予的权限读取 Trello 数据、搜索数据并代表您采取行动。 **启动时：** 每个 Trello MCP 连接支持一个工作区。未来版本计划支持多工作区。 ## 支持的 AI 平台 Trello MCP 支持任何具有 MCP 支持的应用程序，包括： * [OpenAI ChatGPT](https://chatgpt.com/apps/trello/asdk_app_6a20b18a639081918c1b438f8381b27e) * [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) * [Cursor](https://cursor.com/docs/mcp#installing-mcp-servers) * [Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server) * [Google Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) 有关设置详细信息，请参阅您的 AI 客户端的 MCP 文档或内置说明。 ## 开始之前 确保您的环境满足成功连接到 Trello MCP 的必要要求。 ### 先决条件 * 任何计划的 Trello 账户 * 支持的 AI 客户端的访问权限 * 用于完成授权流程的现代浏览器 ## 如何连接 **对于 ChatGPT 用户：** 从我们的 [列表页面](https://chatgpt.com/apps/trello/asdk_app_6a20b18a639081918c1b438f8381b27e) 添加 Trello MCP。 **对于 Claude 用户：** 从我们的 [列表页面](https://claude.ai/directory/connectors/trello) 添加 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 MCP 使用 OAuth 2.0 进行安全身份验证和访问控制。 * **工作区范围的访问** - 您的 AI 助手只能访问您在同意屏幕上明确授权的工作区。 * **权限管理** - 所有操作都尊重您现有的 Trello 权限。您的 AI 助手无法执行您在 Trello 中无法直接执行的操作。 * **无破坏性操作** - 不支持破坏性删除操作。您的助手可以存档卡片和列表，但不能永久删除它们。 * **可撤销的访问** - 您可以随时撤销您的 AI 助手的访问权限。 ## 管理控制 组织管理员可以通过 Atlassian 管理来管理 Trello MCP 的使用方式。 * **[控制 Atlassian Rovo MCP 服务器设置](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/)** - 管理允许或阻止哪些 MCP 服务器域用于您的组织。 * **[配置 Atlassian Rovo MCP 服务器权限](https://support.atlassian.com/security-and-access-policies/docs/Configure-Atlassian-Rovo-MCP-server-permission/)** - 控制用户连接到 MCP 服务器（包括 Trello MCP）时允许的访问级别（读取、写入、搜索）。 * **管理员 MCP 访问控制** - 通过 [admin.atlassian.com](http://admin.atlassian.com/) 管理的企业组织可以在 Atlassian 管理中配置 MCP 访问控制。 Trello MCP 服务器使用与 Atlassian Rovo MCP 服务器相同的管理员控制框架。不需要单独的 Trello 特定管理工具。 ## 您可以使用 Trello MCP 执行的操作 连接后，您可以要求您的 AI 助手执行各种任务。 ### 捕获和组织想法 * "为我们刚刚讨论的项目计划创建一个 Trello 板块。" * "将这些书籍添加到我的阅读清单板块中。" ### 查看您的工作 * "这个星期有哪些 Trello 任务到期？" * "显示我所有板块中逾期的内容。" * "我的厨房改造板块的当前进度如何？" ### 更新任务 * "在我的季度审查卡片中添加一个名为 '准备步骤' 的检查清单。" * "将我的 '提交报告' 卡片标记为完成。" * "将 '修复登录错误' 卡片移动到我的 Sprint 板块的进行中列表中。" ### 清理和分类 * "存档我在收件箱中所有超过一周的项目。" * "将收件箱中的所有项目移动到相应的板块中。" * "帮助我将这三个板块合并成一个。" ### 安排专注时间 * "明天早上为 '草拟社交副本' 预留 2 小时。" * "今天什么时候是练习我的演讲的好时间？" ### 个人洞察和板块丰富 * "提取我过去一年标记为已完成的 Trello 卡片，并撰写一个总结，我可以在年度绩效评估中使用。" * "查看我的婚礼策划板块的任务，并添加任何缺失的内容。" ## 支持的功能 | 类别 | 您可以使用 Trello MCP 执行的操作 | | -------------------- | -------------------------------------------------------------------------------------------------------------- | | **成员** | 查看您的个人资料和默认值 | | **工作区** | 查看工作区详情 | | **板块** | 查看和创建板块；查看标签 | | **列表** | 查看和移动列表 | | **卡片** | 查看、创建、更新、移动、存档和标记卡片完成；附加和分离标签 | | **检查清单** | 查看、创建和更新检查清单；添加和更新检查清单项目 | | **搜索** | 按关键词搜索卡片和板块 | | **计划器** | 查看日历事件；创建专注时间事件；链接和取消链接卡片到事件 | | **收件箱** | 查看、创建、更新和存档收件箱卡片 | **计划器和专注时间** 用户可以将 Google 或 Outlook 日历连接到计划器以读取日历事件。但是，在计划器中创建专注时间需要 Trello Premium 或企业版。 ## 即将到来的功能 Trello MCP 正在积极开发中。当前版本包括用于管理板块、列表、卡片、检查清单和搜索的核心工具。 未来版本中将添加其他工具，以扩展您的 AI 助手可以与 Trello 配合使用的功能： | 类别 | 即将推出 | | ---------------------------- | ----------------------------------------------------------------------------------------- | | **活动和历史记录** | 查看卡片、列表和板块的操作历史记录 | | **评论** | 查看、添加和编辑卡片上的评论 | | **附件** | 查看、上传和下载卡片附件 | | **自定义字段** | 查看字段定义；在卡片上获取和设置值 | | **标签** | 创建、查看和更新标签 | | **板块** | 编辑板块详情（名称、可见性）；存档板块 | | **卡片** | 复制卡片 | | **成员** | 查看和管理板块、工作区和卡片成员 | | **计划器** | 查看链接到特定卡片的事件 | | **工作区** | 创建工作区 | 我们将在新功能发布时更新此页面。 ## Trello MCP 与 Atlassian Rovo MCP | | Trello MCP | Atlassian Rovo MCP | | ---------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------- | | **访问** | 仅限 Trello 数据 | Jira、Confluence、Compass、Bitbucket 和更多 Atlassian 产品数据 | | **适用对象** | 连接外部 AI 助手的 Trello 用户 | 连接外部 AI 助手的 Atlassian 云用户 | | **范围** | 启动时每个 Trello 工作区 | Atlassian 云站点范围 | 在未来版本中，Trello 数据也可能通过 Atlassian Rovo MCP 服务器提供给使用 Trello 和其他 Atlassian 产品的客户。 ## 常见问题 ### 我需要付费的 Trello 计划才能使用 Trello MCP 吗？ 不。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 服务器域。 请联系您的组织管理员请求访问或查看[域限制设置](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/)。 ### 我看到“此工作区的权限被阻止”。我该怎么办？ 您的管理员不允许该工作区或产品访问组合的 MCP 权限。 请联系您的组织管理员或查看 [MCP 权限设置](https://support.atlassian.com/security-and-access-policies/docs/Configure-Atlassian-Rovo-MCP-server-permission/)。 ### 我看到“找不到 Trello 工作区”或“没有可用工作区”。为什么？ 如果您使用与用于 Trello 的不同 Atlassian 帐户登录，或者您不再属于任何 Trello 工作区，或者您的访问权限已更改，可能会发生此情况。 在某些情况下，您可能仍然可以在没有工作区的情况下连接收件箱和计划器，但除非您加入或创建工作区，否则板块、卡片和列表将不可用。 ### 我看到“您不再有权访问此工作区”。发生了什么？ 您的访问权限已被移除该工作区。 如果有，请选择另一个可用工作区，或联系工作区管理员以恢复访问权限。 ### 我在权限屏幕上看到“出了问题”。我该怎么办？ 这通常意味着权限数据无法加载。 请刷新页面并重试。 如果问题仍然存在，请联系 [Trello 支持](https://support.atlassian.com/trello)。 ### 我的 AI 助手可以永久删除板块或卡片吗？ 不。Trello MCP 不支持破坏性删除操作。您的助手可以存档卡片和列表，但不能永久删除它们。 ### 我的数据安全吗？ 是的。Trello MCP 使用 OAuth 2.0 进行身份验证。您的 AI 助手只能访问您在同意屏幕上明确授权的工作区。您可以随时撤销访问权限。 ### 我是 Trello 企业管理员。如何控制我的用户是否可以使用 Trello MCP？ 前往 Atlassian 管理 → Rovo → Rovo MCP 服务器 → 权限。单击“编辑详细信息”在“读取”或“写入”下，然后取消选中 `read_trello` 或 `write_trello`。 ### 作为企业管理员，我可以限制用户连接哪些 MCP 服务器域，而不完全禁用 Trello MCP 吗？ 是的。前往 Atlassian 管理 → Rovo → Rovo MCP 服务器 → 域，以允许或阻止特定的 MCP 服务器域。 ### Atlassian 管理中的 API 令牌身份验证设置是否适用于 Trello MCP？ 不。 “身份验证”选项卡下的 Atlassian 管理 > Rovo > Rovo MCP 服务器不适用于 Trello MCP。Trello 目前不支持基于 API 令牌的身份验证的 MCP 连接。Trello MCP 使用 OAuth 同意（用户通过连接 AI 客户端时的同意屏幕授权）。 但是，如果您的组织还使用 **Atlassian Rovo MCP**（用于 Jira/Confluence），则此 API 令牌身份验证设置适用于那里。这些是单独的配置，对身份验证选项卡的更改不会影响 Trello MCP 访问。