Taskade MCP 是 Taskade 官方发布的 MCP（Model Context Protocol）服务器，同时提供 OpenAPI 到 MCP 的代码生成能力。它让 Claude、Cursor、VS Code、Windsurf 等 MCP 客户端能够连接到 Taskade 工作区或基于任意 OpenAPI 规范生成工具。仓库包含两个包：MCP Server（@taskade/mcp-server，本地 stdio 服务器，面向无法连接远程服务器的客户端）与 OpenAPI Codegen（可从任意 OpenAPI 规范生成 MCP 工具，不限于 Taskade）。
用途与主要能力
托管服务器（https://www.taskade.com/mcp，Streamable HTTP、OAuth）无需安装，提供 48 个工具；本地 stdio 包提供 62 个工具，覆盖 8 个类别。功能上可让 AI 助手访问工作区中的项目、任务、智能体、知识库、模板与自动化。本地包中还包含 webhook 工具（subscribeWebhook、unsubscribeWebhook），并支持与 Taskade 公共 API v1、v2 映射，包括与 AI 智能体进行实时对话和接收实时事件等 API v2（beta）能力。Taskade 表示它是唯一包含 AI 智能体管理（创建、训练、部署）、知识库训练（附加文档、项目、媒体）以及 OpenAPI 代码生成（从任意 API 规范生成 MCP 工具）的 MCP 服务器，共 62 个工具、8 个类别。
使用方式
托管服务器：可直接在 Claude 网页版、桌面版和移动版中，通过 Customize > Connectors 选择 Add custom connector 添加；团队或企业计划需由 Owner 先在 Organization settings > Connectors 中添加。名称为 Taskade，URL 为 https://www.taskade.com/mcp，随后连接并登录 Taskade 授权。在 Claude Code 中运行 /mcp 并选择 taskade 登录。Cursor 和 VS Code 可通过页面上的 Add / Install 按钮添加，或手动写入配置文件；Windsurf 使用 ~/.codeium/windsurf/mcp_config.json。无 OAuth 能力的客户端可使用 Taskade 个人访问令牌（在 Taskade Settings > API 创建）作为 Bearer token；未带令牌的 initialize 请求会故意返回 401，用于提示客户端启动 OAuth 登录。服务器还提供资源 taskade://getting-started。
本地包（stdio）：适用于客户端仅支持 stdio 服务器的场景，或需要仅本地包具备的工具（如 webhook 工具）。运行方式为 npx，使用个人访问令牌通过网络调用 Taskade 公共 API。需先在 Taskade Settings > API 创建 Personal Access Token，再按客户端（Claude Desktop、Cursor、Windsurf、Cline、VS Code 等）写入对应 MCP 配置文件；VS Code 可使用工作区 .vscode/mcp.json（使用 servers 键，${input:…} 首次运行时提示输入密钥）。也支持 HTTP / SSE 模式，默认服务地址 http://localhost:3000（可用 PORT 环境变量配置），通过 http://localhost:3000/sse?access_token=your-api-key 连接。
适用场景
官方示例包括：周度回顾（列出工作区、读取 Q4 Roadmap 项目并按负责人分组待办任务）；规划发布（创建项目与任务并设置日期）；构建支持智能体（创建智能体、添加 FAQ 项目为知识、向其提问）；关闭冲刺（将提及 shipped 的任务标记完成、完成项目）；编辑 Genesis 应用（读取并修改文件）。也适用于团队站会记录分散、基于文档训练 AI 智能体、每两周手动创建冲刺项目、需要监控竞品并报告的智能体、重复的客户项目结构等场景。
限制与说明
托管服务器读写范围限于你的 Taskade 账户可访问且处于付费计划的工作区，免费账户部分端点（如工作区列表）受限；服务器不读取你与 AI 客户端的聊天记录。prompt_agent 可运行 Taskade 智能体，并使用其自身的工具（如网页搜索）。本地包仅将数据发送至 Taskade 公共 API（https://www.taskade.com/api/v1 与 https://www.taskade.com/api/v2），不会发送至其他服务；令牌应保存在环境变量中，切勿提交。每个托管工具都声明了 MCP 工具注解，Claude 可无确认执行只读工具，删除或替换数据的工具会先询问。OpenAPI Codegen 支持 OpenAPI 3.0+ 规范，可为自有 API 生成 MCP 工具。
