Asana MCP:如何把 Asana 连接到 ChatGPT、Claude 和 Cursor

作者:Andrei Finogeev,Weft 创始人 ·

Asana 的官方 MCP 服务器是位于 https://mcp.asana.com/v2/mcp 的 V2 服务器;旧的 V1 地址(mcp.asana.com/sse)已经停用。在 ChatGPT 和 Claude 里,你从它们的目录中连接 Asana 应用并登录即可。在 Claude Code、Cursor 和 VS Code 里则多一步:Asana 不支持动态客户端注册,所以你要先在 Asana 的开发者控制台创建一个 OAuth 应用,再把它的 client ID 和 secret 填进客户端。

Asana MCP 一览

服务器地址https://mcp.asana.com/v2/mcp(Streamable HTTP)。/sse 上的 V1 已停用
登录方式仅 OAuth 2.0,不支持 API 令牌。Claude Code、Cursor、VS Code 需要你自己的 OAuth 应用(client ID + secret)
免费方案未说明
速率限制未说明;批量调用上限为 50 项
删除可以,delete_task 和 delete_record
付费方案Starter 按年计费每用户每月 $10.99(按月 $13.49);Advanced 按年 $24.99(按月 $30.49)

“未说明”表示 Asana 没有写明。价格为美元标价,按每席位计;税费和地区价格会有差异。

如何在各个助手里设置 Asana MCP

ChatGPT

从 ChatGPT 的应用目录连接 Asana,登录,选择工作区并授权。Asana 没有说明哪些 ChatGPT 方案能用。

Claude(网页版和桌面版)

从 Claude 的连接器目录(claude.com/connectors/asana)连接 Asana 并登录。这个条目由 Asana 制作,标有“Anthropic verified”。

Claude Code

先在 Asana 开发者控制台创建一个 OAuth 应用,重定向地址填 http://localhost:8080/callback。添加服务器(Claude Code 会要你输入 client secret),然后在 Claude Code 里运行 /mcp 并登录。

claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp

Cursor

Cursor Settings → Tools & MCP → “+ Add new global MCP server”,粘贴配置,然后点 Connect。在你的 Asana OAuth 应用里把 cursor://anysphere.cursor-mcp/oauth/callback 注册为重定向地址。

{
  "mcpServers": {
    "asana": {
      "url": "https://mcp.asana.com/v2/mcp",
      "auth": {
        "CLIENT_ID": "${env:ASANA_CLIENT_ID}",
        "CLIENT_SECRET": "${env:ASANA_CLIENT_SECRET}"
      }
    }
  }
}

VS Code

Command Palette → “MCP: Add Server” → HTTP,输入地址,命名为 asana,按提示输入 client ID 和 secret。重定向地址:http://127.0.0.1:33418/(末尾带斜杠)和 https://vscode.dev/redirect。

你的 AI 在 Asana 里能做什么

  • 搜索和读取任务、项目、项目组合、状态更新、用户和团队。
  • 创建和更新任务与项目(也可以从模板创建),添加评论,发布项目状态更新。
  • 删除任务;处理 Asana 的表格和记录;读取和更新通知。
  • 预览类工具:在支持应用的客户端里显示可交互的任务或项目卡片。

值得了解的限制

  • 不支持动态客户端注册:在官方 ChatGPT 和 Claude 应用之外,你需要自己的 OAuth 应用。Asana 说有些客户端(比如 Replit 和 JetBrains)暂时还不支持这种方式。
  • 每个会话只能用一个工作区:“Tokens are workspace-scoped”。
  • 没有权限范围:令牌会请求所有工具的完整访问权限;你自己在 Asana 里的权限照样生效。
  • search_tasks 只有 Premium 能用;其他方案上助手会改用 get_tasks。
  • 目标、分配和时间段相关的工具在 V2 中已移除。
  • 没有让智能体认领任务或汇报进度的工具:AI 是在编辑 Asana,而不是按队列干活。

和 AI 一起工作,选 Asana 还是 Weft?

如果你的工作是带时间轴、项目组合和状态报告的跨团队项目,而且公司已经在用 Asana,就选 Asana。它的 MCP 服务器覆盖面广,由 Asana 维护。

如果你是独立创业者或小团队,想让 AI 来运转看板,就选 Weft。Weft 在 ChatGPT、Claude、Cursor 和 Codex 里用普通的 OAuth 接入,不用注册 OAuth 应用;它的工具是为助手直接干活而设计的:认领任务、汇报进度、向你提一个在收件箱里等你回答的问题、记录决策。它在所有 ChatGPT 方案上都能用,包括免费版。

手机上的 Weft 看板,Doing 列:AI 助手领走的三个任务,每个都标着 AI
助手会领走下一个任务;每张卡片都显示是谁在做。
一个由 AI 创建并已完成的 Weft 任务,带着助手记录的结果:修了什么,以及 40 次测试运行全部通过
助手完成任务时会留下回执:做了什么,以及是怎么核对的。

设置 Weft: 在 ChatGPT 里用 Weft · 在 Claude 里用 Weft · 在 Claude Code 里用 Weft · 在 Cursor 里用 Weft · 在 Codex 里用 Weft

常见问题

Asana MCP 服务器的地址是什么?

https://mcp.asana.com/v2/mcp。V1 地址 https://mcp.asana.com/sse 已经关闭。

为什么 Cursor 或 Claude Code 连接 Asana 时要 client ID?

Asana 的 V2 服务器不支持动态客户端注册,所以除了官方 ChatGPT 和 Claude 应用之外,其他客户端都需要你在 Asana 开发者控制台创建的 OAuth 应用。你把它的 client ID 和 secret 填进客户端。

能用 Asana 个人访问令牌连接 MCP 吗?

不能。服务器只接受 OAuth,而且为 MCP 签发的令牌也不能用于 Asana 的 REST API。

免费的 Personal 方案能用 Asana MCP 吗?

Asana 没有说明。它文档里唯一写明的方案限制是 search_tasks 需要 Premium。

资料来源

阅读于 2026年11月11日。

其他 MCP 设置指南