1. 服务概述一句话简介本地MCP服务器让Claude Code管理Trello工单 - 包括看板、列表、卡片、评论、检查清单、标签和成员服务名称trello-mcp版本号最新版本开发者/提供方Artemnikov协议类型MCP (Model Context Protocol)2. 核心功能trello-mcp提供以下主要功能看板管理列出和查看Trello看板信息列表管理查看看板中的列表卡片管理创建、更新、移动、归档卡片评论功能为卡片添加评论检查清单创建检查清单、添加检查项、设置检查状态标签管理列出现有标签、为卡片添加标签成员管理查看看板成员、为卡片分配成员3. 使用场景trello-mcp适用于以下场景项目管理通过自然语言管理Trello看板和项目进度任务跟踪创建、更新和跟踪任务卡片团队协作分配任务给团队成员添加评论和标签工作流自动化自动创建和移动卡片管理检查清单进度监控查看看板状态检查任务完成情况文档管理为任务添加详细描述和附件链接4. 接入方式4.1 服务端点trello-mcp采用本地stdio连接方式协议stdio标准输入输出运行方式本地Python进程客户端Claude Code、Claude Desktop等MCP兼容客户端4.2 认证与权限trello-mcp使用Trello API进行认证API密钥从Trello Power-Up管理页面获取令牌通过授权URL获取非OAuth密钥权限范围读写权限read, write有效期永不过期expirationnever4.3 数据格式支持以下数据格式看板信息ID、名称、描述列表信息ID、名称、位置卡片信息ID、名称、描述、截止日期、标签检查清单检查项列表和完成状态4.4 服务器配置环境变量配置.env文件TRELLO_API_KEYyour_api_key_here TRELLO_TOKENyour_token_here TRELLO_DEFAULT_BOARDoptional_default_board_idClaude Code配置claude mcp add trello --scope user -- \ uv run --directory $(pwd) trello-mcp5. 接口定义trello-mcp提供16个工具接口工具名称功能描述类型list_boards列出所有看板读取list_lists列出现有列表读取list_cards列出卡片读取get_card获取单个卡片详情读取list_labels列出标签读取list_board_members列出现有看板成员读取create_card创建新卡片创建update_card更新卡片信息更新move_card移动卡片到其他列表更新archive_card归档卡片删除add_comment为卡片添加评论注释add_checklist添加检查清单注释add_checklist_item添加检查项注释set_check_item设置检查项状态注释add_label为卡片添加标签注释assign_member为卡片分配成员注释6. 快速开始6.1 环境要求Python 3.8或更高版本uv包管理器Trello账户和API访问权限MCP兼容客户端Claude Code、Claude Desktop等6.2 示例代码步骤1获取API密钥和令牌# 访问授权URL替换API_KEY https://trello.com/1/authorize?expirationneverscoperead,writeresponse_typetokennameClaudeMCPkeyAPI_KEY # 批准授权后复制生成的令牌步骤2配置环境变量cp .env.example .env # 编辑.env文件粘贴TRELLO_API_KEY和TRELLO_TOKEN步骤3安装依赖uv sync步骤4注册到Claude Codeclaude mcp add trello --scope user -- \ uv run --directory $(pwd) trello-mcp # 验证安装 claude mcp list使用示例对话# 列出看板 列出我的所有Trello看板 # 创建卡片 在我的项目看板中创建一个新卡片标题是完成文档编写描述是需要在周五前完成技术文档 # 移动卡片 将完成文档编写卡片移动到进行中列表 # 添加检查清单 为完成文档编写卡片添加一个检查清单包括编写API文档、更新README、添加示例代码 # 分配成员 将这个任务分配给张三7. 注意事项API令牌安全令牌具有永不过期的读写权限请妥善保管默认看板可设置TRELLO_DEFAULT_BOARD以简化工具调用看板ID获取在浏览器中打开看板在URL后添加.json查看或调用list_boards权限范围令牌需要read和write权限才能使用所有功能重启客户端配置后需要重启Claude Code会话才能看到新工具MCP Inspector可使用uv run fastmcp dev src/trello_mcp/server.py打开检查器进行测试工具数量服务器提供16个工具覆盖看板、列表、卡片的完整生命周期本地运行服务器在本地运行需要保持Python进程活跃
