使用说明

Trello MCP服务器

A. 模型上下文协议连接的（MCP）服务器特雷洛克劳德代码。通过自然语言管理你的公告板、列表、卡片、清单等。

73工具 | 零配置启动 | 自动加载 .env | Docker就绪 | 远程HTTP支持

先决条件

Node.js 22+
Claude 代码命令行界面已安装并验证
Trello账户
码头工人（仅远程/Docker模式需要）

选项A：本地设置（标准模式）

最适合在自己的机器上个人使用。Claude Code会自动启动服务器，无需Docker。

步骤1：克隆并安装

git clone https://github.com/GabrielRamirez/trello-mcp.git
cd trello-mcp
npm install

第二步：获取您的Trello证书

运行交互式安装向导：

npm run setup

它将：

询问您的API密钥-在 trello.com/power-ups/admin
打开浏览器以授权应用程序
您点击允许，复制令牌并将其粘贴回去
将这两个值保存到 .env 文件自动

这 .env 文件被git忽略。您的凭据将保留在本地。

步骤3：使用Claude Code注册服务器

claude mcp add trello -- npx tsx src/index.ts

步骤4：验证它是否有效

打开克劳德代码并询问：

List my Trello boards

你应该看到你的董事会列出。现在，每次Claude Code对话中都可以使用73个Trello工具。

选项B：Docker设置（远程HTTP模式）

最适合在服务器上运行、与团队共享或保持服务器始终打开。服务器公开了Claude Code通过URL连接到的HTTP端点。

步骤1：克隆仓库

git clone https://github.com/GabrielRamirez/trello-mcp.git
cd trello-mcp

步骤2：配置凭据

cp .env.example .env

打开 .env 在编辑器中填写您的值：

TRELLO_API_KEY=your-api-key-here
TRELLO_TOKEN=your-token-here

需要证书？获取API密钥： trello.com/power-ups/admin，然后单击该页面上的令牌链接进行授权。

步骤3：构建并启动服务器

docker compose up --build

您应该看到：

trello-mcp-1  | Trello MCP server listening on http://0.0.0.0:3333/mcp

如果缺少凭据，服务器将拒绝启动，并显示一个明确的错误，告诉您需要什么。

步骤4：验证服务器是否正在运行

在新终端中：

curl http://localhost:3333/health

预期响应：

{"status":"ok"}

步骤5：将Claude Code连接到服务器

claude mcp add --transport http trello http://localhost:3333/mcp

如果服务器在远程计算机上运行，请更换 localhost 使用服务器的主机名或IP：

claude mcp add --transport http trello http://your-server:3333/mcp

步骤6：验证它是否有效

打开克劳德代码并询问：

List my Trello boards

选项C：使用已发布的Docker镜像

图片发布于 Docker 中心。不需要克隆或Node.js。

步骤1：运行容器

docker run -d -p 3333:3333 \
  -e TRELLO_API_KEY=your_key \
  -e TRELLO_TOKEN=your_token \
  --name trello-mcp \
  gabermz/trello-mcp

步骤2：连接克劳德代码

claude mcp add --transport http trello http://localhost:3333/mcp

就是这样——没有Node.js，没有克隆，没有 npm install.

环境变量

变量	必填	默认	描述
`TRELLO_API_KEY`	是	-	您的Trello API密钥(在这里买一个)
`TRELLO_TOKEN`	是	--	您的Trello授权令牌
`PORT`	没有	`3333`	HTTP服务器端口（仅限Docker/远程模式）

与您的团队分享

选项1：项目范围配置

为在特定项目中工作的每个人注册服务器：

claude mcp add --transport http trello --scope project http://localhost:3333/mcp

这将配置保存到 .mcp.json 在项目根目录中，您可以将其提交到git。

选项2：手动 `.mcp.json` 具有环境变量支持

创建 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "trello": {
      "type": "http",
      "url": "${TRELLO_MCP_URL:-http://localhost:3333}/mcp"
    }
  }
}

每个队友都可以设置 TRELLO_MCP_URL 指向自己的服务器，或省略它以使用默认服务器 localhost:3333.

它能做什么？

连接后，用自然语言问克劳德：

你说	会发生什么
“列出我的Trello板”	获取您的所有板
“给我看Sprint板上的卡片”	获取该板上的所有卡片
“在待办事项列表中创建一张名为修复登录错误的卡”	创建新卡
“将该卡移至进行中”	在列表之间移动卡片
“在该卡中添加一个名为QA步骤的清单”	创建检查表
“搜索有关身份验证的卡”	全面搜索
“添加注释：被API速率限制阻止”	对卡片的评论
“将所有已完成的卡片存档”	归档已完成的卡片

工具参考

电路板（14个工具）

工具	说明
`list_boards`	列出经过身份验证的用户的所有板
`get_board`	按ID获取板详细信息
`get_board_lists`	将所有列表放在板上
`get_board_cards`	把所有卡片都放在黑板上
`get_board_labels`	将所有标签放在板上
`get_board_members`	获取董事会的所有成员
`get_board_actions`	获取公告板的活动提要
`get_board_custom_fields`	在板上获取自定义字段定义
`create_board`	创建新板
`update_board`	更新名称、描述、关闭状态或背景
`delete_board`	永久删除一个板（不可逆）
`create_label`	在电路板上创建新标签
`add_board_member`	将成员添加到具有角色的董事会
`remove_board_member`	从董事会中删除成员

卡片（20个工具）

工具	说明
`get_card`	通过清单、标签和成员获取卡片详细信息
`create_card`	在列表中创建新卡
`update_card`	更新卡片名称、描述、到期日期或职位
`move_card`	将卡片移动到其他列表或板
`archive_card`	将卡片存档（可逆）
`unarchive_card`	取消存档（重新打开）已关闭的卡
`delete_card`	永久删除卡片（不可逆）
`add_comment`	在卡片上添加评论
`update_comment`	编辑卡片上的评论
`delete_comment`	从卡片中删除评论
`add_label_to_card`	为卡片添加标签
`remove_label_from_card`	从卡片上移除标签
`add_member_to_card`	为卡分配成员
`remove_member_from_card`	从卡中取消分配成员
`get_card_actions`	获取卡片的活动提要
`list_attachments`	列出卡片上的所有附件
`add_attachment`	向卡片添加URL附件
`delete_attachment`	从卡片中删除附件
`get_card_custom_fields`	获取卡片的自定义字段值
`update_custom_field_item`	在卡片上设置自定义字段值

列表（8个工具）

工具	说明
`get_list`	获取列表及其所有卡片
`create_list`	在板上创建新列表
`update_list`	重命名或重新定位列表
`archive_list`	存档列表
`unarchive_list`	取消存档（重新打开）已关闭的列表
`move_all_cards`	将所有卡片从一个列表移动到另一个列表
`archive_all_cards`	将所有卡片归档到列表中
`move_list_to_board`	将列表移动到其他板

检查表（7个工具）

工具	说明
`create_checklist`	在卡片上创建检查表
`get_checklist`	按ID获取所有项目的清单
`update_checklist`	重命名或重新定位检查表
`delete_checklist`	永久删除检查表
`add_checklist_item`	将项目添加到检查表中
`update_checklist_item`	切换、重命名或重新定位清单项
`delete_checklist_item`	从检查表中删除项目

标签（3个工具）

工具	说明
`get_label`	按ID获取标签
`update_label`	更新标签的名称或颜色
`delete_label`	永久删除标签

成员（7工具）

工具	说明
`get_member`	通过ID或用户名获取会员信息
`get_member_cards`	获取分配给会员的所有卡片
`get_member_boards`	获取成员所属的所有董事会
`get_member_organizations`	获取成员所属的所有工作区
`get_notifications`	获取已验证用户的通知
`mark_all_notifications_read`	将所有通知标记为已读
`search_members`	按姓名、用户名或电子邮件搜索成员

自定义字段（4个工具）

工具	说明
`create_custom_field`	在板上创建自定义字段定义
`get_custom_field`	按ID获取自定义字段定义
`delete_custom_field`	删除自定义字段定义
`get_custom_field_options`	获取列表类型自定义字段的下拉选项

组织（5种工具）

工具	说明
`get_organization`	按ID或名称获取工作区详细信息
`get_organization_members`	获取工作区的所有成员
`get_organization_boards`	将所有板放在一个工作区中
`create_organization`	创建新工作区
`update_organization`	更新工作区名称、描述或网站

Webhooks（4个工具）

工具	说明
`create_webhook`	为模型更改通知创建webhook
`get_webhook`	按ID获取webhook详细信息
`update_webhook`	更新webhook的URL、型号或活动状态
`delete_webhook`	删除webhook

搜索（1个工具）

工具	说明
`search`	搜索板和卡片 Trello搜索运营商 (`@member`, `#label`, `list:name`, `is:open`等等）

如果您的帐户没有访问权限，则需要Trello Premium或Enterprise（自定义字段、一些板功能）的工具将返回一条明确的错误消息。

项目结构

trello-mcp/
├── src/
│   ├── index.ts              # Stdio entry point (local mode)
│   ├── remote.ts             # HTTP entry point (Docker/remote mode)
│   ├── server.ts             # Shared server factory
│   ├── trello-client.ts      # HTTP client with auth and error handling
│   ├── types.ts              # TypeScript interfaces for Trello objects
│   ├── tools/
│   │   ├── boards.ts         # Board tools (14)
│   │   ├── cards.ts          # Card tools (20)
│   │   ├── lists.ts          # List tools (8)
│   │   ├── checklists.ts     # Checklist tools (7)
│   │   ├── labels.ts         # Label tools (3)
│   │   ├── members.ts        # Member tools (7)
│   │   ├── customfields.ts   # Custom Field tools (4)
│   │   ├── organizations.ts  # Organization tools (5)
│   │   ├── webhooks.ts       # Webhook tools (4)
│   │   └── search.ts         # Search tool (1)
│   └── utils/
│       ├── env.ts            # .env file loader
│       └── response.ts       # Response formatting helpers
├── Dockerfile
├── docker-compose.yml
├── .env.example
├── package.json
├── tsconfig.json
└── tsup.config.ts

故障排除

问题	解决方案
“缺少必需的环境变量”	复制 `.env.example` 到 `.env` 并填写您的凭据，或通过 `-e` 旗帜。
“未配置Trello API凭据”	快跑 `npm run setup` 以交互方式配置凭据。
401未经授权	您的API密钥或令牌无效。跑 `npm run setup` 生成新的。
服务器已启动，但未显示任何工具	确保你使用过 `claude mcp add`，不仅 `npx tsx src/index.ts` 直接。
“找不到模块”错误	快跑 `npm install` 安装依赖项。
Docker健康检查失败	确保端口3333尚未使用。检查日志 `docker compose logs`.
无法连接到远程服务器	检查防火墙规则是否允许端口3333。证实 `curl http://your-server:3333/health`.

发展

# Install dependencies
npm install

# Run in dev mode (stdio, auto-loads .env)
npm run dev

# Build for production
npm run build

# Run HTTP server locally without Docker
npm run start:remote

# Run production build (stdio)
npm run start

许可证

麻省理工学院