MCP 服务器 - Asana 集成指南（翻译版）

简介

此文档详细介绍了如何与 Asana 平台集成的 MCP (Multi-Channel Platform) 服务器的配置和使用方法。通过本指南，您将能够访问 Asana 的 API 功能，并在 Claude Desktop 中进行项目管理和任务协作。

安装说明

创建 Asana 账户

1. 访问 Asana。
2. 点击 "注册" 开始创建账户。

获取 Asana 访问令牌

• 您可以通过 Asana 开发者控制台生成个人访问令牌：
  • 登录后，访问路径：https://app.asana.com/0/my-apps。
• 更详细的信息请参考：Asana API 文档

配置 Claude Desktop

在您的 claude_desktop_config.json 文件中添加以下配置：

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@roychri/mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "您的 Asana 访问令牌"
      }
    }
  }
}

故障排除

如果遇到权限错误：

1. 确保您的 Asana 帐户启用了 API 访问权限。
2. 核对访问令牌是否正确配置在 claude_desktop_config.json 文件中。

贡献指南

克隆仓库并开始开发

您可以克隆此仓库并在项目基础上进行开发。

使用 MCP 检查工具测试本地更改

npm run inspector

这将启动客户端界面，默认占用端口 5173，服务端默认占用端口 3000。如果这些端口已被占用，请使用以下命令指定不同端口：

CLIENT_PORT=5009 SERVER_PORT=3009 npm run inspector

许可证

此 MCP 服务器遵循 MIT 许可证，这意味着您可以自由地使用、修改和分发该软件，具体条款请参考项目仓库中的 LICENSE 文件。