适合谁
- 已有 Taskade 付费或个人账号、希望用 AI 助手直接读写工作区内容的团队或个人
- 需要通过对话式界面批量管理项目、任务、模板和 AI 智能体的运营/项目管理人员
- 希望复用 OpenAPI 代码生成能力、为自有 API 快速生成 MCP 工具的开发者
T
62FMRS · C
官方维护、工具覆盖面广（62 个工具覆盖项目、任务、智能体、模板、媒体和 v2 版 Agent Chat/Webhook），支持 stdio 和 HTTP/SSE 两种接入方式，并附带可复用于任意 OpenAPI 规范的代码生成器；需要注意部分能力受付费计划限制，且个人令牌权限较广，应妥善保管。
Taskade MCP Server（官方包 @taskade/mcp-server）是 Taskade 官方维护的 Model Context Protocol 服务器，通过 62 个工具把工作区、项目、任务、AI 智能体、知识库、模板、媒体和实时 webhook 暴露给 Claude Desktop、Cursor、Windsurf、Cline、VS Code 等 MCP 客户端。默认以 stdio 方式通过 npx 启动，也可加 --http 参数以 HTTP/SSE 模式运行供远程或自定义客户端连接。仓库同时提供一个独立的 OpenAPI-to-MCP 代码生成工具（@taskade/mcp-openapi-codegen），可以为任意 OpenAPI 3.0+ 规范生成 MCP 工具，不限于 Taskade 自身。注意该仓库中的 Workspace MCP 与 Taskade 官方文档提到的、托管在 taskade.com/mcp 的 Genesis App MCP 是两个不同的服务面，后者通过 OAuth 2.0 鉴权，属于另一套系统，不在本包范围内。
工具能力
workspacesGet
列出所有工作区
workspaceFoldersGet
列出工作区中的文件夹
workspaceCreateProject
在工作区中创建项目
projectGet
获取项目详情
projectCreate
创建新项目
projectCopy
将项目复制到某个文件夹
projectComplete
将项目标记为已完成
projectRestore
恢复已完成的项目
projectMembersGet
列出项目成员
projectFieldsGet
获取项目的自定义字段
projectShareLinkGet
获取项目的分享链接
projectShareLinkEnable
启用项目分享链接
projectBlocksGet
获取项目中的所有内容块
projectTasksGet
获取项目中的所有任务
folderProjectsGet
列出文件夹中的项目
taskGet
获取任务详情
taskCreate
创建一个或多个任务
taskPut
更新任务
taskDelete
删除任务
taskComplete
将任务标记为已完成
taskUncomplete
将任务标记为未完成
taskMove
在项目内移动任务
taskAssigneesGet
获取任务的负责人
taskPutAssignees
为任务指派负责人
taskDeleteAssignees
移除任务负责人
taskGetDate
获取任务截止日期
taskPutDate
设置任务截止日期
taskDeleteDate
移除任务截止日期
taskNoteGet
获取任务备注
taskNotePut
更新任务备注
taskNoteDelete
删除任务备注
taskFieldsValueGet
获取任务的所有字段值
taskFieldValueGet
获取任务指定字段的值
taskFieldValuePut
设置任务字段值
taskFieldValueDelete
删除任务字段值
folderAgentGenerate
根据文本提示生成 AI 智能体
folderCreateAgent
使用自定义配置创建智能体
folderAgentGet
列出文件夹中的智能体
agentGet
获取智能体详情
agentUpdate
更新智能体配置
deleteAgent
删除智能体
agentPublicAccessEnable
将智能体公开发布
agentPublicGet
获取公开智能体详情
agentPublicUpdate
更新公开智能体的设置
agentKnowledgeProjectCreate
将项目添加为智能体知识
agentKnowledgeMediaCreate
将媒体添加为智能体知识
agentKnowledgeProjectRemove
从知识库中移除项目
agentKnowledgeMediaRemove
从知识库中移除媒体
agentConvosGet
列出智能体的对话
agentConvoGet
获取对话详情
publicAgentGet
通过公开 ID 获取智能体
folderProjectTemplatesGet
列出可用的项目模板
projectFromTemplate
基于模板创建项目
mediasGet
列出文件夹中的媒体文件
mediaGet
获取媒体详情
mediaDelete
删除媒体文件
meProjectsGet
列出你的所有项目
promptAgent
向 AI 智能体发送消息并获取回复
listConversations
列出智能体的对话列表
getConversation
获取某个对话的消息内容
subscribeWebhook
订阅 Taskade 实时事件 webhook
unsubscribeWebhook
取消 webhook 订阅
安装接入
1) 在 Taskade 设置的 Settings > API 页面创建一个 Personal Access Token 作为 TASKADE_API_KEY。2) 在 Claude Desktop / Cursor / Windsurf / Cline 的 MCP 配置文件中加入一个 mcpServers 条目，command 为 npx，args 为 ["-y", "@taskade/mcp-server"]，并在 env 中设置 TASKADE_API_KEY。3) VS Code 用户在工作区添加 .vscode/mcp.json，使用 servers 字段，并可用 ${input:taskade_api_key} 在首次运行时提示输入密钥。4) 如需远程或自定义客户端连接，可执行 TASKADE_API_KEY=your-api-key npx @taskade/mcp-server --http 以 HTTP/SSE 模式启动，默认监听 http://localhost:3000（可用 PORT 环境变量调整），SSE 端点为 /sse?access_token=your-api-key。5) 首次调用后确认工具列表可用，逐步授权具体操作。
claude_desktop_config.json
{
"mcpServers": {
"taskade": {
"command": "npx",
"args": [
"-y",
"@taskade/mcp-server"
],
"env": {
"TASKADE_API_KEY": "your-api-key-here"
}
}
}
}
选型与风险
不适合谁
- 需要免费账号完整功能的用户——部分接口（如工作区列表）在免费计划上受限
- 只想编辑已发布 Genesis App 代码或需要 OAuth 托管接入的场景——应使用单独的 Genesis App MCP（taskade.com/mcp），而非本 Workspace MCP
- 需要连接 Slack、Shopify、Gmail 等第三方服务的场景——应使用 Taskade 的 MCP Connectors，而非本服务器
所需权限
- 需要一个 Taskade Personal Access Token（TASKADE_API_KEY），以环境变量形式提供，标记为必需且敏感
- 该令牌授权服务器以你的身份调用 Taskade 公共 API（v1 与 v2），可读写工作区、项目、任务、智能体、媒体及 webhook
- HTTP/SSE 模式下密钥会通过查询参数（?access_token=）传递，需要注意本地网络暴露面
风险与副作用
- 令牌拥有较广的读写权限，泄露后攻击者可对你的 Taskade 数据进行增删改，包括删除任务/项目/媒体、修改或公开发布智能体
- 部分工具（如 agentPublicAccessEnable）会把智能体设为公开可访问，需谨慎使用避免信息意外外泄
- webhook 订阅/取消订阅工具会影响其他依赖该 webhook 的自动化流程，误操作可能中断现有集成
- README 声明服务器只与 taskade.com 的官方 API 通信，不向其他第三方服务发送数据，但仍应像对待其他 API 密钥一样妥善保管 TASKADE_API_KEY
常见排障
- 确认已在 Taskade Settings > API 页面生成有效的 Personal Access Token，并正确写入 TASKADE_API_KEY 环境变量
- 若通过 npx 启动失败，检查网络能否访问 npm registry，以及是否使用了 -y 参数避免交互确认
- 部分接口（如工作区列表）在免费账号上被限制，遇到权限错误时确认账号所在的付费计划
- 使用 --http 模式时，检查 PORT 环境变量与本地端口占用情况，并确认 SSE 连接地址与 access_token 拼写正确
- 如需操作 AI 智能体或知识库相关工具，确认对应项目/媒体资源存在且账号有权限访问
使用场景
在 Claude/Cursor 等客户端中用自然语言查看、创建和管理 Taskade 工作区的项目与任务
通过对话创建、训练（挂载项目/媒体知识）并公开发布 Taskade AI 智能体
基于模板批量生成项目（如客户 onboarding、冲刺计划），并自动分配任务与截止日期
订阅 Taskade webhook 或直接与已发布的智能体进行对话式交互（Agent Chat，v2 beta）
使用配套的 OpenAPI-to-MCP 代码生成工具，把任意 OpenAPI 3.0+ 规范转换为 MCP 工具
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持
Cline完整支持
VS Code完整支持