Taskade MCP Server

官方

把你的 Taskade 工作区接入任意 AI 客户端

分类: 团队协作第 7 / 55
Stars: ★ 165 非常热门
传输方式: stdio（本地进程） · SSE
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 天前
工具数: 62

62FMRS · C

官方维护、工具覆盖面广（62 个工具覆盖项目、任务、智能体、模板、媒体和 v2 版 Agent Chat/Webhook），支持 stdio 和 HTTP/SSE 两种接入方式，并附带可复用于任意 OpenAPI 规范的代码生成器；需要注意部分能力受付费计划限制，且个人令牌权限较广，应妥善保管。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

13/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: server.json 清单格式规范（stdio 传输、npm 包、版本 0.1.1），README 列出了 62 个工具及分类说明，结构看起来合理。但仓库提供的材料中没有测试文件、没有 CI 工作流证据，无法验证声明的工具列表与实际实现行为是否一致，也无法确认 MCP 初始化/工具列表握手能否顺利完成。按静态审查规则，缺少可执行证据时可靠性不得超过 12 分，故给出偏保守的分数。
安全与权限 11/20: 凭证通过环境变量 TASKADE_API_KEY 传入，并在清单中标记为 isSecret/isRequired，README 也提醒不要提交密钥，这是良好实践。但该服务器暴露了大量高风险操作（taskDelete、deleteAgent、mediaDelete、projectComplete、agentPublicAccessEnable 等），文档中未描述任何确认或二次校验机制，权限模型是单一 API Key 对整个工作区的全量访问，缺乏最小权限/细粒度授权说明。此外 HTTP/SSE 模式将 access_token 作为 URL 查询参数传递（`/sse?access_token=...`），存在通过日志、代理或 Referrer 泄露令牌的风险。网络边界的说法（仅访问 Taskade v1/v2 API）是自述性质，未经代码验证。未达到红线级别（无恶意代码、无隐蔽外泄、无虚假身份），但权限收敛与确认机制不完整，故评分中等。
维护活跃度 13/20: 项目采用 MIT 许可证，仓库未归档，存在 SECURITY.md 漏洞报告渠道，README 的 Roadmap 部分显示近期发布记录（v0.1.0 到 v0.1.1）及后续计划，表明有持续维护迹象。但版本号仍处于 0.1.x 早期阶段，材料中未提供提交频率、发布节奏或多贡献者治理的直接证据，9 个未关闭 issue 的响应情况也未知，因此不能给出高分。
文档质量 16/20: 文档质量较高：为 Claude Desktop、Cursor、Windsurf、Cline、VS Code 提供了具体配置示例，并说明了 HTTP/SSE 远程模式；62 个工具按 8 个类别列出并附简要说明；还包含使用场景、Agent Recipes 示例和专门的 Privacy & Security 小节。不足之处在于：未提供各工具的具体参数/输入模式（仅有工具名和一句话描述）、没有独立的故障排查章节，也未给出速率限制或成本的量化说明（仅笼统提到部分功能对免费账户受限）。
安装易用性 14/20: 安装路径清晰：单条 `npx -y @taskade/mcp-server` 命令，并为六种主流客户端给出即用配置片段，另外说明了 HTTP/SSE 模式的启动方式和默认端口。用户仅需在 Taskade 后台获取一次 API Key 即可完成配置，摩擦较低。由于静态审查规则要求在没有真实执行证据时安装易用性不得超过 15 分，故在该上限内给出较高分数。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已有 Taskade 付费或个人账号、希望用 AI 助手直接读写工作区内容的团队或个人
需要通过对话式界面批量管理项目、任务、模板和 AI 智能体的运营/项目管理人员
希望复用 OpenAPI 代码生成能力、为自有 API 快速生成 MCP 工具的开发者

不适合谁

需要免费账号完整功能的用户——部分接口（如工作区列表）在免费计划上受限
只想编辑已发布 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

安装接入

准备工作

运行环境：Node.js

TASKADE_API_KEY 必填密钥 Taskade 个人访问令牌，在 Taskade 设置 > API（taskade.com/settings/api）中创建。

其他可选配置项（1 个）

PORT 可选仅 --http 模式下使用，指定本地 HTTP 服务器监听端口，默认 3000。

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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "taskade": {
      "command": "npx",
      "args": [
        "-y",
        "@taskade/mcp-server"
      ],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add taskade -e TASKADE_API_KEY=your-api-key-here -- npx -y @taskade/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cursor 的工具列表中确认出现 taskade 服务器的工具（如 workspacesGet 或 meProjectsGet）；或直接问“列出我的 Taskade 项目”，若能返回项目即连接成功。

常见排障

确认已在 Taskade Settings > API 页面生成有效的 Personal Access Token，并正确写入 TASKADE_API_KEY 环境变量
若通过 npx 启动失败，检查网络能否访问 npm registry，以及是否使用了 -y 参数避免交互确认
部分接口（如工作区列表）在免费账号上被限制，遇到权限错误时确认账号所在的付费计划
使用 --http 模式时，检查 PORT 环境变量与本地端口占用情况，并确认 SSE 连接地址与 access_token 拼写正确
如需操作 AI 智能体或知识库相关工具，确认对应项目/媒体资源存在且账号有权限访问

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的所有 Taskade 工作区和项目
为昨天完成的任务生成一份站会总结，并创建今天的优先任务
在 Customer Success 文件夹里创建一个基于我们文档项目的支持 AI 代理并公开发布
把 Sprint Template 复制成一个名为 Sprint 2026-W15 的新项目，并把前 10 个任务移进去

工具能力 62

workspacesGet 只读

列出所有工作区

workspaceFoldersGet 只读

列出工作区中的文件夹

workspaceCreateProject 写入

在工作区中创建项目

projectGet 只读

获取项目详情

projectCreate 写入

创建新项目

projectCopy 写入

将项目复制到某个文件夹

projectComplete 写入

将项目标记为已完成

projectRestore 写入

恢复已完成的项目

展开其余 54 个工具

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 订阅

使用场景

在 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

依据项目文档列出，未经本站实测。

详细介绍

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 鉴权，属于另一套系统，不在本包范围内。