运行时依赖
安装命令
点击复制技能文档
Asana 快速入门 始终通过 bash 调用 {baseDir}/scripts/invoke.sh —— 永远不要直接调用 mcporter。 该包装器在需要时从环境提供的令牌中初始化 OAuth 密钥库,然后调用 mcporter。 bash {baseDir}/scripts/invoke.sh call maverick-asana.get_me bash {baseDir}/scripts/invoke.sh call maverick-asana.search_tasks text="launch" bash {baseDir}/scripts/invoke.sh call maverick-asana.get_projects 为了得到结构化的输出(同时将传输错误作为 JSON 封装 —— 用于解决 mcporter #153): bash {baseDir}/scripts/invoke.sh call --output json maverick-asana.search_tasks text="launch" | jq '.result.content' 发现可用的工具和模式: bash {baseDir}/scripts/invoke.sh list maverick-asana --schema 安全 写操作(create_task、update_task、add_task_to_project、assignments、due dates、comments、project changes 和 completion changes)会修改 Asana 工作空间中的可见内容。 在调用写工具之前,请确认用户的明确意图 —— 读取和搜索工具可以自由调用。 在修改之前,解析名称为 GIDs,读取当前任务或项目状态,并使用 opt_fields 来保持响应的小。 身份验证 令牌会自动分配和轮换。 如果一个调用返回 HTTP 401 并且在几秒钟内无法恢复,OAuth 授权已经被撤销 —— 重新授权集成以刷新凭据。 数据流 工具调用通过 HTTPS 访问 Asana 的托管 MCP 服务 https://mcp.asana.com/v2/mcp,通过 OAuth 进行身份验证。 Asana 可以看到每个调用引用的任务、项目、portfolio 和工作空间数据。 仅将此技能用于 Asana 相关的工作;不要通过这些工具传递无关的敏感内容。 依赖 mcporter (github.com/steipete/mcporter) —— 用于调用 Asana 托管 MCP 服务器的 MCP CLI。 如果 mcporter 在 PATH 中不存在,会通过 npm install -g --ignore-scripts mcporter 自动安装(见前置安装规范)。 安装规范使用未固定版本的 mcporter(npm 最新版本);具有严格供应链控制的运营商应覆盖安装以固定特定版本(例如 mcporter@)。 jq (stedolan.github.io/jq) —— 由密钥库初始化器使用的 JSON 处理器。 系统依赖;通过操作系统包管理器安装(apt install jq、brew install jq 等)。 flock (util-linux的一部分) —— 用于序列化并发密钥库写操作的文件锁定。 在 Linux 上默认可用;在 macOS 上通过 brew install flock 安装。 shasum (Perl,随 Digest::SHA 发布) —— 计算用于派生 mcporter 密钥库密钥和分配令牌标记的 SHA-256 哈希值。 在 macOS 和 Debian/Ubuntu(包括部署的 cloudflare/sandbox Ubuntu 22.04 镜像)上预安装;在最小的 Linux 镜像上安装 perl-Digest-SHA。 脚本调用 shasum -a 256 而不是 GNU sha256sum,因此可以在不需要 coreutils 的 stock macOS 上运行。