asana-admin-mcp

MCP 服务器，用于整理 Asana 结构 — 项目组合、自定义字段/下拉列表、项目、分区 填补标准 Asana connector 无法完成的部分（那个连接器专注于 task/read）

⚠️ Dashboard 无法做到——这不是本 MCP 的限制

Asana 完全未开放用于 Dashboard / chart / widget / project view tab 的 public API （翻遍了官方 OpenAPI spec 中的全部 175 个 endpoint——没有一个）

唯一能自动化的方式是 project_duplicate——规格说明指出，在 duplicate project 时 Project Views（List / Board / Dashboard 标签页）总是会被一并复制，并且无法关闭 → 在一个“原型项目”中配置好 Dashboard，然后每次需要新项目时就 duplicate

🟡 尚未验证： 规格说明写着“Project Views”会跟随，但没有明确说明 Dashboard 中配置的图表 是否也会跟随，还是只会得到空标签页——无法通过 API 检查（没有读取图表的 endpoint），必须亲眼查看 2026-08-17 的 smoke test 复制的是没有图表的项目，因此还不能回答这个问题

注意：Project Template 不会带上 Dashboard（这仍是 Asana 论坛中悬而未决的功能请求） 必须使用 duplicate，而不是 template

安装

1. 先获取 Asana token（每个人都必须有自己的）

按照 GET-TOKEN.md 操作 → 保存到 ~/.asana_token

printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_token

token 与个人权限绑定，严禁使用他人的——Asana 的日志中会显示 token 所有者的名字

2. 安装插件（推荐）

在 Claude Code 中输入两行：

/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcp

Claude Code 会自动 clone repo 并运行 npm ci，然后注册 MCP——无需手动修改 ~/.claude.json 之后要更新就运行 /plugin update

本机需要 Node 20+（用 node -v 检查）

方法 2——手动安装（如果不想用插件）

克隆 repo 后双击 ติดตั้ง-asana-admin-mcp.command 脚本会请求 token，运行 npm install，然后写入 ~/.claude.json（每次都会备份）

不要同时使用这两种方法——否则会得到两个重名的 asana-admin MCP

Token 优先从环境变量 ASANA_TOKEN 读取，如果没有则回退到 ~/.asana_token → token 绝不会出现在 repo 中，也不需要放在 ~/.claude.json 里

工具（21）

每个 tool 都接收 gid 而不是名称——先用 asana_find 将名称转换成 gid

发现

项目组合

自定义字段 / 下拉列表

Asana 无法删除下拉列表选项——只能通过 enabled:false 来停用；之前选中该选项的任务仍会保留原值

项目 / 分区

有意不提供删除 project / portfolio / custom field 的工具——删除这些后无法恢复，请在网页端操作

颜色（适用于 portfolio / project / enum option）

none red orange yellow-orange yellow yellow-green green blue-green aqua blue indigo purple magenta hot-pink pink cool-gray

测试

ASANA_TOKEN=$(cat ~/.asana_token) npm run smoke

在 token 的第一个 workspace 中创建真实对象，名称以 ZZ-mcp-smoke-* 开头 → 检查所有 tool → 自行全部删除 如果不提供 token，则只会运行前半部分（server 启动 + 列出 tools）

运行说明

• 429 → 根据 Retry-After 自动重试 3 次

• Asana 的错误会返回来自 API 的真实消息（指出缺少哪个字段 / 哪个 gid 错误），而不只是状态码

• 未传递的字段不会被修改——只传 name 的 portfolio_update 不会清除颜色