Asana Automation 通过 Rube MCP 接入 Composio 的 Asana 工具包，用于自动化执行 Asana 中的各类操作。以下按用途、主要能力、使用方式、适用场景和限制进行说明。
一、用途 该工具集面向需要在自动化流程或智能体中操作 Asana 的场景，涵盖任务、项目、分节、团队和工作区的管理。用户无需直接调用 Asana API，而是通过 Rube MCP 暴露的工具完成操作。
二、前置条件
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
- 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Asana 连接，toolkit 为 asana。
- 始终先调用 RUBE_SEARCH_TOOLS 以获取当前的工具架构。
三、安装与设置
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，只需添加该端点即可工作。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，toolkit 为 asana。
- 若连接状态不是 ACTIVE，按返回的授权链接完成 Asana OAuth。
- 确认连接状态显示 ACTIVE 后再运行任何工作流。
四、核心工作流
- 管理任务 适用场景：用户希望创建、搜索、列出或整理任务。 工具序列：
- ASANA_GET_MULTIPLE_WORKSPACES - 获取工作区 ID [前置]
- ASANA_SEARCH_TASKS_IN_WORKSPACE - 搜索任务 [可选]
- ASANA_GET_TASKS_FROM_A_PROJECT - 列出项目任务 [可选]
- ASANA_CREATE_A_TASK - 创建新任务 [可选]
- ASANA_GET_A_TASK - 获取任务详情 [可选]
- ASANA_CREATE_SUBTASK - 创建子任务 [可选]
- ASANA_GET_TASK_SUBTASKS - 列出子任务 [可选] 关键参数：
- workspace：工作区 GID（搜索/创建时必需）
- projects：要添加任务的项目 GID 数组
- name：任务名称
- notes：任务描述
- assignee：负责人（用户 GID 或邮箱）
- due_on：截止日期（YYYY-MM-DD） 注意点：
- 大多数操作需要工作区 GID，应先获取。
- 任务 GID 以字符串返回，不是整数。
- 搜索以工作区为范围，而非项目。
- 管理项目和分节 适用场景：用户希望创建项目、管理分节或整理任务。 工具序列：
- ASANA_GET_WORKSPACE_PROJECTS - 列出工作区项目 [可选]
- ASANA_GET_A_PROJECT - 获取项目详情 [可选]
- ASANA_CREATE_A_PROJECT - 创建新项目 [可选]
- ASANA_GET_SECTIONS_IN_PROJECT - 列出分节 [可选]
- ASANA_CREATE_SECTION_IN_PROJECT - 创建新分节 [可选]
- ASANA_ADD_TASK_TO_SECTION - 将任务移动到分节 [可选]
- ASANA_GET_TASKS_FROM_A_SECTION - 列出分节中的任务 [可选] 关键参数：
- project_gid：项目 GID
- name：项目或分节名称
- workspace：创建工作区 GID
- task：分节分配的任务 GID
- section：分节 GID 注意点：
- 项目属于工作区；创建时需要工作区 GID。
- 分节在项目内有顺序。
- DUPLICATE_PROJECT 会创建副本，可选择是否包含任务。
- 管理团队和用户 适用场景：用户希望列出团队、团队成员或工作区用户。 工具序列：
- ASANA_GET_TEAMS_IN_WORKSPACE - 列出工作区团队 [可选]
- ASANA_GET_USERS_FOR_TEAM - 列出团队成员 [可选]
- ASANA_GET_USERS_FOR_WORKSPACE - 列出所有工作区用户 [可选]
- ASANA_GET_CURRENT_USER - 获取已认证用户 [可选]
- ASANA_GET_MULTIPLE_USERS - 获取多个用户详情 [可选] 关键参数：
- workspace_gid：工作区 GID
- team_gid：团队 GID 注意点：
- 用户以工作区为范围。
- 团队成员关系需要团队 GID。
- 并行操作 适用场景：用户需要高效执行批量操作。 工具序列：
- ASANA_SUBMIT_PARALLEL_REQUESTS - 并行执行多个 API 调用 [必需] 关键参数：
- actions：包含 method、path 和 data 的操作对象数组 注意点：
- 每个操作必须是有效的 Asana API 调用。
- 单个请求失败不会回滚已成功的请求。
五、常见模式 ID 解析：
- 工作区名称 -> GID：调用 ASANA_GET_MULTIPLE_WORKSPACES，按名称查找工作区，提取 gid 字段。
- 项目名称 -> GID：使用工作区 GID 调用 ASANA_GET_WORKSPACE_PROJECTS，按名称查找项目，提取 gid 字段。 分页：
- Asana 使用基于游标的分页，配合 offset 参数。
- 检查响应中的 next_page。
- 将 next_page.offset 中的 offset 用于下一次请求。
六、已知注意点 GID 格式：
- 所有 Asana ID 都是字符串（GID），不是整数。
- GID 是全局唯一标识符。 工作区范围：
- 大多数操作需要工作区上下文。
- 任务、项目和用户均以工作区为范围。
七、快速参考 任务：
- 列出工作区：ASANA_GET_MULTIPLE_WORKSPACES，无参数
- 搜索任务：ASANA_SEARCH_TASKS_IN_WORKSPACE，参数 workspace、text
- 创建任务：ASANA_CREATE_A_TASK，参数 workspace、name、projects
- 获取任务：ASANA_GET_A_TASK，参数 task_gid
- 创建子任务：ASANA_CREATE_SUBTASK，参数 parent、name
- 列出子任务：ASANA_GET_TASK_SUBTASKS，参数 task_gid
- 项目任务：ASANA_GET_TASKS_FROM_A_PROJECT，参数 project_gid
- 列出项目：ASANA_GET_WORKSPACE_PROJECTS，参数 workspace
- 创建项目：ASANA_CREATE_A_PROJECT，参数 workspace、name
- 获取项目：ASANA_GET_A_PROJECT，参数 project_gid
- 复制项目：ASANA_DUPLICATE_PROJECT，参数 project_gid
- 列出分节：ASANA_GET_SECTIONS_IN_PROJECT，参数 project_gid
- 创建分节：ASANA_CREATE_SECTION_IN_PROJECT，参数 project_gid、name
- 添加到分节：ASANA_ADD_TASK_TO_SECTION，参数 section、task
- 分节任务：ASANA_GET_TASKS_FROM_A_SECTION，参数 section_gid
- 列出团队：ASANA_GET_TEAMS_IN_WORKSPACE，参数 workspace_gid
- 团队成员：ASANA_GET_USERS_FOR_TEAM，参数 team_gid
- 工作区用户：ASANA_GET_USERS_FOR_WORKSPACE，参数 workspace_gid
- 当前用户：ASANA_GET_CURRENT_USER，无参数
- 并行请求：ASANA_SUBMIT_PARALLEL_REQUESTS，参数 actions
八、适用场景 适合在智能体或自动化流程中批量管理 Asana 任务、项目、分节、团队和用户，尤其是需要跨工作区搜索任务、创建项目和分节、查询成员信息以及并行执行多个 API 调用的场景。
九、限制 关于该工具的收费、价格、支持的平台范围、性能效果等信息暂未提供。用户应始终先调用 RUBE_SEARCH_TOOLS 获取最新工具架构，并以实际返回为准。