🌈 Taskade MCP

此代码库包含 Taskade Agent 插件和两个软件包：

• MCP 服务（@taskade/mcp-server）：本地 stdio 服务，适用于无法连接远程服务的客户端。
• OpenAPI 代码生成：从任何 OpenAPI 规范生成 MCP 工具，而不仅限于 Taskade。

适用于 Claude Code、Codex、Copilot、Gemini CLI 和 Cursor 的 Agent 插件

taskade 插件通过托管服务将你的 AI 工具连接到 Taskade 工作区，并添加 7 项技能：一个入口（taskade）和六项具体任务（getting-started、import-spreadsheet、fix-my-app、app-report、backup-my-app、plan-new-app）。这些技能会告知 Agent 应调用哪些工具、按什么顺序调用，以及在汇报结果前要检查哪些内容。

• 套餐： 所有付费 Taskade 套餐（Starter 及以上）均支持 MCP 访问。使用你的 Taskade 账户登录一次即可。
• 功能： 将电子表格导入项目；一次只进行一项已检查的更改来修复 Taskade Genesis 应用；汇报项目和自动化情况；将应用备份到文件夹；以及规划新应用。
• 仍需在 Taskade 中完成的操作： 此插件无法创建或编辑自动化、构建或发布应用，也无法设置谁可以使用应用。要完成这些任务，插件会为你撰写请求，供你粘贴到 Taskade EVE 中。

VS Code： 启用 chat.plugins.enabled 设置。然后从命令面板运行 Chat: Install Plugin From Source，并输入 https://github.com/taskade/mcp。

Cursor： 本仓库中的 Cursor 插件 taskade（.cursor-plugin/）会添加相同的托管服务和技能。

若要仅向 Codex 添加托管服务，请运行 codex mcp add taskade --url https://www.taskade.com/mcp，然后运行 codex mcp login taskade。

目录

• Agent 插件
• Taskade MCP 服务：快速入门（Claude、Claude Code、ChatGPT、Cursor、VS Code、Windsurf）
• 托管工具
• 提示词示例
• 故障排除
• 本地包（stdio）
• 本地包工具（62 个）
• 为什么选择 Taskade MCP？
• Agent 配方
• OpenAPI 代码生成
• 什么是 Taskade？
• 隐私与安全
• 支持
• 参与贡献
• 许可证

演示

由 Anthropic 提供的 Claude Desktop 中运行的 MCP 驱动型 Taskade Agent：

通过 MCP 构建 Agent	运行自动化	管理项目
从 Claude/Cursor 创建、训练和部署 AI Agent	列出自动化、运行自动化并查看其运行记录	在 AI 助手中全面管理工作区*（付费套餐）*

Taskade MCP 服务：快速入门

不带令牌的 initialize 请求会有意返回 401。401 会告知客户端从哪里开始 OAuth 登录。

Claude（网页、桌面端和移动端）

1. 在 Claude 中，前往 自定义 > 连接器，然后选择 添加自定义连接器。使用 Team 或 Enterprise 套餐时，所有者需先在 组织设置 > 连接器 中添加连接器（选择 添加，然后选择 自定义）。
2. 输入名称 Taskade 和 URL https://www.taskade.com/mcp，然后选择 添加。
3. 选择 连接，登录 Taskade 并批准访问。
4. 在聊天中，选择 + > 连接器，然后启用 Taskade。

如果对话框询问 OAuth 客户端，请选择 自动注册。同一账号也可以在 Claude Desktop 和 Claude 移动应用中使用此连接器。

Claude Code

claude mcp add --transport http taskade https://www.taskade.com/mcp

然后在 Claude Code 中运行 /mcp，并选择 taskade 登录。

ChatGPT

ChatGPT 会在开发者模式下将远程 MCP 服务作为自定义连接器连接。它仅使用 OAuth。

1. 在 ChatGPT 设置中，为应用和连接器启用开发者模式。
2. 创建连接器。将名称设为 Taskade，并将服务器 URL 设为 https://www.taskade.com/mcp。
3. 选择 OAuth 作为身份验证方式。登录 Taskade 并允许访问。

开发者模式仅适用于部分 ChatGPT 套餐，其界面标签也经常变化。

Cursor

选择本页面顶部的 添加到 Cursor，或将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "taskade": {
      "url": "https://www.taskade.com/mcp"
    }
  }
}

VS Code

选择本页面顶部的 在 VS Code 中安装，或运行：

code --add-mcp '{"name":"taskade","type":"http","url":"https://www.taskade.com/mcp"}'

Windsurf

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "taskade": {
      "serverUrl": "https://www.taskade.com/mcp"
    }
  }
}

其他客户端和服务（API 令牌）

无法使用 OAuth 的客户端可以将 Taskade 个人访问令牌作为 Bearer 令牌发送。在 Taskade 设置 > API 中创建令牌。

{
  "mcpServers": {
    "taskade": {
      "type": "http",
      "url": "https://www.taskade.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TASKADE_API_TOKEN" }
    }
  }
}

完整指南：托管的 Taskade MCP。

托管工具

每个托管工具都会声明 MCP 工具注解。Claude 可以在无需确认的情况下运行只读工具；对于会删除或替换数据的工具，它会先征求确认。

• get_flow_runs：读取某个自动化最近的运行记录，按时间从新到旧排列。每条记录都包含状态和时间信息。失败的运行还会指出失败步骤并提供简短错误说明。该工具需要自动化编辑权限。
• run_flow：启动一个已启用且触发条件为“When asked”的自动化。每次运行都会实际执行：计入套餐的每月自动化运行次数，AI 步骤也会消耗额度。

该服务还提供资源 taskade://getting-started，其中包含供模型使用的简短指南。

示例提示词

1. 每周回顾。“列出我的 Taskade 工作区，读取 Q4 路线图项目，并按负责人分组列出未完成的任务。” 工具：list_spaces、list_projects、read_project。
2. 规划发布。“在我的 Marketing 工作区中创建一个名为 Website Launch 的项目，添加文案、设计、QA 和发布日相关任务，并将发布任务设为 11 月 3 日。” 工具：list_spaces、create_project、create_task、set_task_date。
3. 构建支持 Agent。“在我的 Support 工作区中创建一个名为 Help Bot 的 Agent，将 FAQ 项目添加为其知识，然后询问它客户如何重置密码。” 工具：create_agent、add_knowledge_project、prompt_agent。
4. 结束冲刺。“在 Sprint 42 项目中，将所有提到‘shipped’的任务标记为已完成，然后将项目标记为已完成。” 工具：list_tasks、complete_task、complete_project。
5. 编辑 Genesis 应用。“在我的 CRM 应用中，读取 app/src/App.tsx，并将页面标题更改为 Acme CRM。” 工具：inspect_space、write_file。

故障排除

如果问题仍然存在，请提交 issue 或发送邮件至 [email protected]。

本地包（stdio）

当你的客户端仅支持 stdio 服务，或需要使用只有本地包提供的工具（例如 webhook 工具 subscribeWebhook、unsubscribeWebhook）时，请使用本地包。它通过 npx 在你的机器上运行，并使用个人访问令牌通过网络调用 Taskade 公共 API。

1. 获取 API 密钥

前往 Taskade Settings > API 并创建个人访问令牌。

2. Claude Desktop

添加到你的 claude_desktop_config.json：

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

3. Cursor

添加到 Cursor MCP 设置：

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

4. Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json（或选择 Settings → Cascade → MCP → Add Server）：

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

5. Cline

在 VS Code 中，打开 Cline MCP Servers 面板 → Configure MCP Servers 并添加：

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

6. VS Code

在工作区中添加 .vscode/mcp.json（VS Code 使用 servers 键；${input:…} 会在首次运行时提示输入密钥）：

{
  "servers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "${input:taskade_api_key}"
      }
    }
  }
}

7. 远程和 HTTP 客户端

本地包仅通过 stdio 运行，不提供 HTTP 或 SSE 模式。对于通过 HTTP 连接的客户端，请使用 https://www.taskade.com/mcp 上的托管服务（参见Taskade MCP 服务：快速入门）。

本地包工具（62）

本地包使用自己的一套工具名称，并映射到 Taskade 公共 API v1 和 v2。

工作区

项目

任务

AI Agents

使用自定义知识和工具创建、管理并发布自主 AI Agent。

模板

媒体

个人

Agent 聊天和 Webhook（API v2，测试版）

v1 API 不具备的功能：与 AI Agent 进行实时对话，并接收实时事件。

为什么选择 Taskade MCP？

Taskade MCP 让你的 AI 助手能够访问你的工作区——项目、任务、Agent、知识库、模板和自动化功能（付费方案提供；工作区列表等部分端点对免费账户有限制）。无需编写 API 代码，只需用自然语言描述需求。

┌──────────────────────────────────────────────────────────┐
│                HOW TASKADE MCP WORKS                     │
└──────────────────────────────────────────────────────────┘

  You (in Claude/Cursor/Windsurf):
  "Create a support agent trained on our docs project"
                         ↓
  ┌──────────────────────────────────┐
  │     Taskade MCP Server           │
  │     (62 tools, 8 categories)     │
  └──────────────────────────────────┘
       ↓              ↓            ↓
  folderCreateAgent  agentKnowledge  agentPublicAccess
  (creates agent)    (attaches docs)  (publishes it)
                         ↓
  Result: Live AI chatbot trained on your data

为什么选择 MCP 而不是 REST API？

为什么选择 Taskade MCP，而不是其他 MCP 服务？

Taskade MCP 提供AI Agent 管理（创建、训练、部署 Agent）、知识库训练（附加文档、项目和媒体）以及 OpenAPI 代码生成（根据任何 API 规范生成 MCP 工具）。共 8 个类别、62 个工具。

Agent 配方

You: "Check my Taskade workspace for yesterday's completed tasks,
      summarize them as a standup update, then create today's
      priority tasks based on what's still open."

Claude uses:
  1. meProjectsGet → find your active projects
  2. projectTasksGet → pull tasks from each project
  3. taskCreate → create today's priority tasks

Result: A formatted standup summary + fresh task list in Taskade.

You: "Create an AI support agent called 'Help Bot' in my
      Customer Success folder, train it on our Documentation
      project, and publish it publicly."

Claude uses:
  1. workspaceFoldersGet → find "Customer Success" folder
  2. folderCreateAgent → create "Help Bot" with support instructions
  3. agentKnowledgeProjectCreate → attach Documentation project
  4. agentPublicAccessEnable → publish with shareable link

Result: Live AI chatbot trained on your docs, ready to embed.

You: "Create a new sprint project from our 'Sprint Template',
      name it 'Sprint 2026-W15', move the top 10 backlog
      items into it, and assign them to the engineering team."

Claude uses:
  1. folderProjectTemplatesGet → find "Sprint Template"
  2. projectFromTemplate → create "Sprint 2026-W15"
  3. projectTasksGet → get backlog items
  4. taskMove → move top 10 tasks to new sprint
  5. taskPutAssignees → assign engineering team members

Result: Sprint ready to go, fully populated and assigned.

You: "Generate an AI agent that researches our top 5 competitors.
      Train it on our Competitive Analysis project.
      Name it 'Market Intel Agent'."

Claude uses:
  1. folderAgentGenerate → generate agent from research prompt
  2. agentKnowledgeProjectCreate → connect Competitive Analysis project
  3. agentUpdate → refine instructions for research cadence

Result: AI research agent with domain knowledge, ready for briefings.

You: "For our new client Acme Corp: create a project from
      the 'Client Onboarding' template, add tasks for
      kickoff meeting and SOW review, set due dates for
      the next 2 weeks, then share the project link."

Claude uses:
  1. projectFromTemplate → create "Acme Corp Onboarding"
  2. taskCreate → add kickoff, requirements, SOW tasks
  3. taskPutDate → set dates across next 2 weeks
  4. projectShareLinkEnable → generate share link

Result: Client onboarding project live and shareable in 30 seconds.

使用场景

使用 AI 进行项目管理

让你的 AI 助手管理 Taskade 工作区：

• “显示我的所有项目及其状态”
• “创建一个名为 Q1 Planning 的新项目，并为每个团队添加任务”
• “将所有逾期任务移至 Backlog 项目”
• “为 Sprint 项目中的所有任务设置截止日期”

创建 AI Agent

直接从编辑器中构建并部署 AI Agent：

• “创建一个名为 Customer Support Bot 的 AI Agent，并使用我们文档项目中的知识”
• “使用此提示词生成一个代码审查 Agent：...”
• “公开发布我的 Agent，并提供分享链接”
• “将我们的 API 文档项目添加为该 Agent 的知识”

模板工作流

根据模板自动创建项目：

• “列出我工作区中的所有模板”
• “使用 Client Template 创建 5 个新的客户引导项目”
• “复制本周的 Sprint Retrospective 项目”

OpenAPI 代码生成

使用我们的生成器，根据任何 OpenAPI 规范构建 MCP 工具，不限于 Taskade。

npm install --save-dev @taskade/mcp-openapi-codegen @readme/openapi-parser

import { dereference } from '@readme/openapi-parser';
import { codegen } from '@taskade/mcp-openapi-codegen';

const document = await dereference('your-api-spec.yaml');

await codegen({
  path: 'src/tools.generated.ts',
  document,
});

兼容任何 OpenAPI 3.0+ 规范。几分钟内即可为你自己的 API 生成 MCP 工具。

Taskade 是什么？

Taskade（Y Combinator S19）是一个 AI 原生工作区，只需一个提示词，即可构建应用、部署 Agent 并自动化工作流。已构建 150,000+ 个应用。

• Genesis Apps — 根据提示词构建完整应用。仪表板、CRM、门户、表单等，立即部署。立即试用 →
• AI Agents — 自定义 Agent，内置工具、持久记忆、多 Agent 团队和公开嵌入功能
• 自动化 — 无代码工作流自动化，支持 100+ 种集成、分支、循环和筛选
• 实时协作 — 多人协作工作区，支持聊天、视频和多种项目视图
• 模板：用于项目管理、工程、营销等领域的模板
• API 和 MCP：REST API v2、本 MCP 服务、Agent 插件、Agent API、webhook、OAuth 2.0

链接：

• 应用：taskade.com
• 创建：taskade.com/create
• 应用库：taskade.com/apps
• Agent：taskade.com/agents
• 模板：taskade.com/templates
• 文档：taskade.com/docs · docs.taskade.com
• 工作区 MCP 指南： https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• 托管 MCP 指南： https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• 博客：taskade.com/blog

路线图

请参阅未解决的问题，了解计划中的功能和改进。

**近期发布（v0.1.0）：**Agent 聊天（promptAgent）和 webhook 触发器现已上线，通过 Taskade API v2 工具层提供。

• 自动化工具：托管服务可列出自动化流程、读取其运行记录，并运行“有人询问时”自动化流程（list_automations、get_flow_runs、run_flow）。通过 MCP 创建、启用和管理自动化流程已列入路线图。
• agent.js — 开源自主 Agent 工具包（即将推出）
• TaskOS — 位于 docs.taskade.com 的 Agent 平台

隐私与安全

• **托管服务。**Taskade 在 www.taskade.com 上运行该服务。它只会读取和写入你的 Taskade 账户有权访问且属于付费计划的工作区。该服务不会读取你与 AI 客户端的聊天记录。prompt_agent 会运行 Taskade Agent，该 Agent 可以使用自己的工具，例如网页搜索。
• **Agent 插件。**该插件包含技能（文本文件）和托管服务的地址。它不运行自己的代码。备份技能会将工作区文件写入本地文件夹（除非你指定其他文件夹，否则为 ./taskade-backup/）。
• **本地软件包。**你的 API 令牌授权服务代表你调用 Taskade 公共 API（https://www.taskade.com/api/v1 和 https://www.taskade.com/api/v2）。该软件包不会将你的数据发送到其他服务。请将令牌保存在环境变量中，切勿提交它。
• 隐私政策：taskade.com/privacy。条款：taskade.com/terms。
• **安全问题和漏洞报告：**请参阅 SECURITY.md。

支持

• 帮助中心：help.taskade.com
• 电子邮件：[email protected]
• Bug 和功能请求：GitHub issues

参与贡献

帮助我们改进 MCP 工具、OpenAPI 工作流和 Agent 能力。

• 问题 — 报告 Bug 或请求功能
• 拉取请求 — 欢迎贡献
• 应用 — 浏览和克隆社区应用

更多 Taskade 内容

• Taskade 文档（源代码）— 开发者文档和 API 参考
• 集成套件 — 开源 Zapier/n8n 操作和触发器
• Taskade — 平台主页，包含 Genesis（AI 应用构建器）

许可证

MIT