Skip to main content

​
前提条件

开始之前，请确保你具备以下条件：
  • 至少在一个班级中拥有 Owner 或 Admin 角色的 TaskNeo 账户
  • 你实例的 TaskNeo API URL - 如果没有，请询问管理员
  • 已安装 Node.js 18 或更高版本

​
认证方式

MCP 服务器支持三种认证方式。请选择一种：
方式环境变量适用场景
令牌TASKFLOW_TOKEN推荐 - 调用一次 login 获取令牌并保存结果
MCP 密钥TASKFLOW_MCP_KEY管理员向你发放了专用 MCP 密钥时使用
凭据TASKFLOW_EMAIL + TASKFLOW_PASSWORD备用方式 - 服务器会在首次使用时自动登录
基于令牌的认证最可靠。先在你的 AI 助手里运行一次 login 工具，复制响应中的令牌，并将其写入配置中的 TASKFLOW_TOKEN。服务端随后会直接使用它，而无需在每个会话中重新认证。

​
设置

1

验证 Node.js

确认已安装 Node.js 18 或更高版本：
node --version
MCP 服务器通过 npx 运行 - 无需全局安装。
2

配置你的 MCP 客户端

将 TaskNeo MCP 服务器添加到客户端的 MCP 配置文件中。请在下方选择你的客户端标签页。
打开你的 Claude Desktop 配置文件：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
在 mcpServers 下添加 taskflow 条目：
{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "@taskflow/mcp"],
      "env": {
        "TASKFLOW_API_URL": "https://your-taskflow-api.example.com",
        "TASKFLOW_TOKEN": "your-token-here"
      }
    }
  }
}
保存文件并重启 Claude Desktop。
3

验证连接

打开你的 AI 助手，并让它列出你的 TaskNeo 班级：
“List my TaskNeo classes.”
助手应该调用 list_my_classes 并返回你担任 Owner 或 Admin 的班级列表。如果出现错误，请查看下面的故障排查部分。

​
环境变量参考

变量必填说明
TASKFLOW_API_URL这三者之一TaskNeo API 的基础 URL，例如 https://api.taskflow.example.com
TASKFLOW_TOKEN这三者之一之前登录获得的 JWT 令牌。首选认证方式。
TASKFLOW_EMAIL这三者之一你的 TaskNeo 账户邮箱
TASKFLOW_PASSWORD这三者之一你的 TaskNeo 账户密码（与 TASKFLOW_EMAIL 一起使用）
TASKFLOW_MCP_KEY这三者之一管理员发放的 MCP 专用密钥
TASKFLOW_MCP_KEY 的优先级高于 TASKFLOW_EMAIL/TASKFLOW_PASSWORD。如果两者都设置了，将使用 MCP 密钥。

​
故障排查

检查 TASKFLOW_API_URL 是否正确，以及你的机器是否能够访问 API。尝试在浏览器中打开该 URL - 你应该看到 JSON 响应，而不是网络错误。
你的令牌或凭据可能错误或已过期。如果使用的是 TASKFLOW_TOKEN，可以尝试重新认证：让你的 AI 助手用邮箱和密码调用 login 工具，然后把新令牌复制到配置中。
该工具只会返回你担任 Owner 或 Admin 的班级。你只是 Member 的班级不会显示。如果你本应看到某个班级，请让班级 Owner 在班级设置中提升你的角色。
首次运行时，npx 会下载 @taskflow/mcp 包。之后会使用缓存版本，启动会更快。如果你在意启动时间，可以全局安装该包：npm install -g @taskflow/mcp，并把 "command": "npx", "args": ["-y", "@taskflow/mcp"] 替换成 "command": "taskflow-mcp"。

​
下一步

工具参考

查看每个可用工具、其参数以及示例用法。