Roychri MCP Server Asana

🚀 MCP 服務器 - Asana 集成指南

本指南詳細介紹了 MCP（多渠道平臺）服務器與 Asana 平臺集成的配置和使用方法。藉助本指南，您能夠訪問 Asana 的 API 功能，並在 Claude Desktop 中開展項目管理和任務協作。

🚀 快速開始

本指南將幫助您完成 MCP 服務器與 Asana 平臺的集成，以便在 Claude Desktop 中使用 Asana 的功能。

📦 安裝指南

創建 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 訪問令牌"
      }
    }
  }
}

💻 使用示例

基礎用法

在 claude_desktop_config.json 中配置好 Asana 訪問令牌後，即可在 Claude Desktop 中使用 Asana 的功能。

{
  "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 文件。