Trello MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供用于获取和与 Trello 看板、列表及卡片交互的工具。

功能

• 获取已认证用户的所有看板

• 获取看板详情

• 从看板获取列表

• 从看板或列表中获取卡片

• 获取特定卡片详情

• 跨看板搜索卡片

• 获取卡片操作/历史记录

Related MCP server: Trello MCP Server

设置

1. 获取 Trello API 凭据

重要： 你需要创建一个 Power-Up 来获取 API 凭据。

1. 访问 https://trello.com/power-ups/admin

2. 点击 "Create New Power-Up"（或 "Crear" 按钮）

3. 填写基本信息：

   • 名称："Trello MCP"（或任何你喜欢的名称）

   • 工作区：选择你的工作区

4. 创建完成后，进入 Power-Up 设置中的 "API Key" 部分

5. 你将看到显示的 API Key（一个 32 字符的字符串）

6. 点击 "Token" 链接（或描述中的 "token"）来生成你的 API token

7. 在提示时授权该 token

8. 复制 API key 和 API token

或者，如果你已经创建了 Power-Up，可以直接前往 https://trello.com/app-key。

2. 安装依赖

npm install

3. 配置环境变量

复制示例环境文件并添加你的凭据：

cp .env.example .env

编辑 .env 并添加你的凭据：

TRELLO_API_KEY=your_actual_api_key
TRELLO_API_TOKEN=your_actual_api_token

4. 测试服务器

直接运行服务器：

npm start

配置

你可以在 Claude Desktop 中全局配置此 MCP 服务器，或在 Claude Code CLI 中按项目进行配置。

选项 1：全局配置 (Claude Desktop)

编辑你的 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

将 /absolute/path/to/trello-mcp/ 替换为此目录的实际绝对路径。

添加配置后，重启 Claude Desktop。

选项 2：按项目配置 (Claude Code CLI)

对于 Claude Code CLI，MCP 服务器是在 ~/.claude.json 中按项目进行配置的。

重要： 你必须在配置中直接包含 type: "stdio" 字段和 env 变量。.env 文件不会自动加载。

使用此命令为特定项目进行配置：

# Using jq to add the configuration
jq '.projects."/path/to/your/project".mcpServers.trello = {
  "type": "stdio",
  "command": "node",
  "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
  "env": {
    "TRELLO_API_KEY": "your_api_key_here",
    "TRELLO_API_TOKEN": "your_api_token_here"
  }
}' ~/.claude.json > /tmp/claude_config.json && mv /tmp/claude_config.json ~/.claude.json

或者手动编辑 ~/.claude.json：

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "trello": {
          "type": "stdio",
          "command": "node",
          "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }
  }
}

添加配置后，重启 Claude Code。

可用工具

get_my_boards

获取已认证用户的所有看板。

参数：

• filter (可选)：按类型过滤看板 (all, open, closed, starred, organization, public, members)。默认值："open"

get_board

获取特定看板的详情。

参数：

• board_id (必填)：看板的 ID

get_board_lists

获取看板上的所有列表。

参数：

• board_id (必填)：看板的 ID

• filter (可选)：过滤列表 (all, open, closed, none)。默认值："open"

get_board_cards

获取看板上的所有卡片。

参数：

• board_id (必填)：看板的 ID

get_list_cards

获取特定列表中的所有卡片。

参数：

• list_id (必填)：列表的 ID

get_card

获取特定卡片的详情。

参数：

• card_id (必填)：卡片的 ID

search_cards

跨所有看板搜索卡片。

参数：

• query (必填)：搜索查询

• board_ids (可选)：要搜索的看板 ID（以逗号分隔）

get_card_actions

获取特定卡片的操作（活动/历史记录）。

参数：

• card_id (必填)：卡片的 ID

使用示例

在 Claude Desktop 中配置完成后，你可以使用自然语言与你的 Trello 看板进行交互：

• "Show me all my open Trello boards"

• "Get the cards from board [board_id]"

• "Search for cards containing 'bug fix'"

• "Show me the details of card [card_id]"

• "What are the lists in my board?"

故障排除

身份验证错误

如果你看到身份验证错误：

1. 验证你的 API key 和 token 是否正确

2. 确保 token 未过期

3. 如有必要，从 https://trello.com/app-key 重新生成 token

服务器无法启动

1. 检查是否安装了 Node.js：node --version

2. 确保已安装依赖：npm install

3. 验证环境变量设置是否正确

MCP 服务器显示 "Failed" 状态

如果 MCP 服务器在 Claude Code 中显示为 "failed"：

1. 缺少 type 字段：确保你的配置包含 "type": "stdio"。这是 Claude Code CLI 所必需的。

2. 环境变量未加载：当 Claude Code 运行 MCP 服务器时，不会自动加载 .env 文件。你必须在配置中直接包含带有 API 凭据的 env 对象：

   {
     "type": "stdio",
     "command": "node",
     "args": ["/path/to/trello-mcp/index.js"],
     "env": {
       "TRELLO_API_KEY": "your_api_key",
       "TRELLO_API_TOKEN": "your_api_token"
     }
   }

3. 检查日志：运行 claude --debug 查看详细错误日志

4. 手动测试：直接运行服务器以验证其是否正常工作：

   cd /path/to/trello-mcp
   TRELLO_API_KEY=your_key TRELLO_API_TOKEN=your_token node index.js

5. 重启 Claude Code：更改配置后，请完全退出并重启 Claude Code

MCP 服务器未在 Claude 中显示

1. 检查配置中的路径是否为绝对路径且正确

2. 完全重启 Claude Desktop/Code

3. 检查 Claude Desktop 日志以查找任何错误

4. 对于 Claude Code CLI，验证配置是否位于 ~/.claude.json 中的正确项目路径下

许可证

MIT