Claude Desktop 集成

将 TaskFlow AI 集成到 Claude Desktop，让 AI 助手拥有强大的文件操作和代码执行能力

---

📋 前置要求

• Claude Desktop 已安装
• Node.js 18+ 或 npm 已安装

---

🚀 快速配置

方法一：NPM 安装（推荐）

# 全局安装
npm install -g taskflow-ai

编辑 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "taskflow-ai"]
    }
  }
}

---

方法二：Docker 部署

{
  "mcpServers": {
    "taskflow": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/your/project:/workspace",
        "agions/taskflow-ai:latest"
      ]
    }
  }
}

---

方法三：本地路径

{
  "mcpServers": {
    "taskflow": {
      "command": "/usr/local/bin/taskflow",
      "args": ["mcp", "start"]
    }
  }
}

---

✅ 验证安装

1. 重启 Claude Desktop

2. 打开 Claude 聊天界面

3. 查看可用工具列表

   应该看到 taskflow_* 系列工具：

   taskflow_filesystem_listDirectory
   taskflow_filesystem_readFile
   taskflow_shell_exec
   taskflow_git_status
   ...

4. 测试工具

   尝试以下提示词：

   列出当前目录的文件

   Claude 应该能调用 taskflow_filesystem_listDirectory 并返回结果。

---

⚙️ 高级配置

自定义工作目录

{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "taskflow-ai", "--work-dir", "/path/to/your/project"]
    }
  }
}

启用详细日志

{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "taskflow-ai"],
      "env": {
        "TASKFLOW_LOG_LEVEL": "debug"
      }
    }
  }
}

多项目支持

{
  "mcpServers": {
    "taskflow-project-a": {
      "command": "npx",
      "args": ["-y", "taskflow-ai"],
      "env": {
        "TASKFLOW_WORK_DIR": "/path/to/project-a"
      }
    },
    "taskflow-project-b": {
      "command": "npx",
      "args": ["-y", "taskflow-ai"],
      "env": {
        "TASKFLOW_WORK_DIR": "/path/to/project-b"
      }
    }
  }
}

---

🐛 故障排查

问题	解决方案
工具不显示	检查配置文件格式，重启 Claude Desktop
权限错误	确保 Node.js 有文件访问权限
命令超时	检查网络或增加超时配置
配置无效	验证 JSON 格式，检查路径是否正确

---

💡 提示

提示	说明
🔍 工具发现	Claude 会自动发现所有注册的 MCP 工具
📁 工作目录	默认使用 Claude 打开的项目目录
🔒 安全限制	所有操作都经过安全验证
⏱️ 超时控制	所有操作都有超时限制

---

🔗 相关链接

• 快速入门
• MCP 工具总览
• 安装指南

---

集成遇到问题随时问我