Maverick Asana MCP

Asana Quick 启动

Always invoke through bash {baseDir}/scripts/invoke.sh — never call mcporter directly. The wr应用er 种子s the OAuth vault from the env-supplied 令牌s when needed, then calls mcporter.

bash {baseDir}/scripts/invoke.sh call maverick-asana.获取_me bash {baseDir}/scripts/invoke.sh call maverick-asana.搜索_tasks text="launch" bash {baseDir}/scripts/invoke.sh call maverick-asana.获取_projects

For structured 输出 (also surfaces transport errors as JSON envelopes — workaround for mcporter #153):

bash {baseDir}/scripts/invoke.sh call --输出 json maverick-asana.搜索_tasks text="launch" | jq '.结果.content'

Discover avAIlable 工具s and 模式s:

bash {baseDir}/scripts/invoke.sh 列出 maverick-asana --模式

Safety

Write operations (创建_task, 更新_task, 添加_task_to_project, as签名ments, due dates, comments, project changes, and completion changes) modify Asana work visible to the connected workspace. Confirm clear user intent before invoking write 工具s — read and 搜索 工具s are safe to call freely while exploring. Resolve names to GIDs, read the current task or project 状态 before modifying it, and use opt_fields to keep 响应s small.

Authentication

令牌s are provisioned and rotated automatically. If a call returns HTTP 401 that doesn't 恢复 within a few seconds, the OAuth grant has been revoked — re-授权 the integration to refresh 凭证s.

Data flow

工具 calls travel to Asana's hosted MCP 服务 at https://mcp.asana.com/v2/mcp over HTTPS, 认证d via OAuth. Asana sees the task, project, portfolio, and workspace data referenced by each call. Use this 技能 for Asana-related work only; do not pass unrelated sensitive content through these 工具s.

Dependencies mcporter (github.com/steipete/mcporter) — MCP 命令行工具 used to invoke Asana's hosted MCP server. Auto-安装ed via npm 安装 -g --ignore-scripts mcporter if missing on PATH (see 安装 spec in frontmatter). The 安装 spec uses unpinned mcporter (npm latest); operators with strict supply-chAIn controls should override the 安装 to pin a specific version (e.g. mcporter@). jq (stedolan.github.io/jq) — JSON 处理器 used by the vault 初始化r. 系统 dependency; 安装 via your OS package 管理器 (apt 安装 jq, brew 安装 jq, etc.). flock (part of util-linux) — file locking used to 序列化 concurrent vault writes. AvAIlable by default on Linux; on macOS 安装 via brew 安装 flock. shasum (Perl, ships with Digest::SHA) — computes the SHA-256 哈希es used to derive the mcporter vault key and the provisioned-令牌 marker. Pre安装ed on macOS and on Debian/Ubuntu (incl. the 部署ed cloudflare/sandbox Ubuntu 22.04 image); on minimal Linux images 安装 perl-Digest-SHA. The script invokes shasum -a 256 rather than GNU sha256sum so it 运行s on stock macOS without coreutils.