Taskade

此仓库包含 Taskade agent plugin 和两个软件包：

• MCP Server (@taskade/mcp-server)：本地 stdio 服务器，供无法连接远程服务器的客户端使用。
• OpenAPI Codegen：从任意 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)。这些技能会告诉智能体要调用哪些工具、按什么顺序调用，以及汇报结果前需要检查什么。

• 套餐： MCP 访问权限包含在所有付费 Taskade 套餐中（Starter 及以上）。使用你的 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 Recipes
• OpenAPI Codegen
• 什么是 Taskade？
• 隐私与安全
• 支持
• 参与贡献
• 许可证

演示

由 MCP 驱动的 Taskade 智能体在 Anthropic 的 Claude Desktop 中运行：

通过 MCP 构建智能体	运行自动化	管理项目
在 Claude/Cursor 中创建、训练和部署 AI 智能体	列出自动化、运行一项并查看其运行记录	通过 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 设为名称，将 https://www.taskade.com/mcp 设为服务器 URL。
3. 选择 OAuth 作为身份验证方式。登录 Taskade 并允许访问。

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

Cursor

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

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

VS Code

选择本页顶部的 Install in 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 Roadmap 项目，并按负责人分组列出未完成任务。” 工具：list_spaces、list_projects、read_project。
2. 规划发布。“在我的 Marketing 工作空间中创建一个名为 Website Launch 的项目，添加文案、设计、QA 和发布日相关任务，并将发布任务设为 11 月 3 日。” 工具：list_spaces、create_project、create_task、set_task_date。
3. 构建支持智能体。“在我的 Support 工作空间中创建一个名为 Help Bot 的智能体，将 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 或发送邮件至 support@taskade.com。

本地软件包（stdio）

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

1. 获取 API 密钥

前往 Taskade 设置 > 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 智能体

创建、管理和发布具有自定义知识与工具的自主 AI 智能体。

模板

媒体

个人

智能体聊天与 Webhook（API v2，测试版）

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

为什么选择 Taskade MCP？

Taskade MCP 让你的 AI 助手能够访问你的工作区——包括项目、任务、智能体、知识库、模板和自动化（适用于付费方案；某些端点，例如工作区列表，对免费账户有限制）。无需编写 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 智能体管理（创建、训练、部署智能体）、知识库训练（附加文档、项目、媒体）和 OpenAPI 代码生成（根据任何 API 规范生成 MCP 工具）。涵盖 8 个类别的 62 种工具。

智能体配方

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 智能体

直接在编辑器中构建并部署 AI 智能体：

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

模板工作流

根据模板自动创建项目：

• “列出我工作区中的所有模板”
• “根据 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 原生工作区，可通过单个提示构建应用、部署智能体并自动化工作流。已构建超过 150,000 个应用。

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

链接：

• 应用：taskade.com
• 创建：taskade.com/create
• 应用库：taskade.com/apps · 所有类别
• 智能体：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）： 智能体聊天（promptAgent）和 Webhook 触发器现已通过 Taskade API v2 工具层上线。

• 自动化工具：托管服务器可列出自动化、读取其运行记录并运行“按需触发”自动化（list_automations、get_flow_runs、run_flow）。通过 MCP 创建、启用和管理自动化已列入路线图。
• agent.js — 开源自主智能体工具包（即将推出）
• TaskOS — 位于 docs.taskade.com 的智能体平台

隐私与安全

• 托管服务器。 Taskade 在 www.taskade.com 上运行该服务器。它只会读取和写入你的 Taskade 账户有权访问且属于付费方案的工作区。服务器不会读取你与 AI 客户端的聊天记录。prompt_agent 会运行一个 Taskade 智能体，该智能体可以使用自己的工具，例如网页搜索。
• 智能体插件。 插件包含技能（文本文件）和托管服务器的地址。它不会运行自己的代码。备份技能会将工作区文件写入本地文件夹（./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
• 电子邮件：support@taskade.com
• Bug 和功能请求：GitHub issues

参与贡献

帮助我们改进 MCP 工具、OpenAPI 工作流和智能体功能。

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

更多 Taskade 资源

• 智能体技能（SKILL.md） · llms.txt 索引 · 开发者文档
• Awesome Vibe Coding — 精选的氛围编程工具、MCP 服务器和智能体技能
• Taskade 文档（源代码）— 开发者文档和 API 参考
• 集成工具包 — 开源 Zapier/n8n 操作与触发器
• GitHub 上的 Taskade — 组织主页和开源仓库
• Taskade — 平台主页，包含 Genesis AI 应用构建器

许可证

MIT