Taskade

此儲存庫包含 Taskade 代理程式外掛程式 和兩個套件：

• MCP 伺服器（@taskade/mcp-server）：本機 stdio 伺服器，適用於無法連線至遠端伺服器的用戶端。
• OpenAPI Codegen：從任何 OpenAPI 規格產生 MCP 工具，不限於 Taskade。

適用於 Claude Code、Codex、Copilot、Gemini CLI 和 Cursor 的代理程式外掛程式

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。

目錄

• 代理程式外掛程式
• Taskade MCP 伺服器：快速入門（Claude、Claude Code、ChatGPT、Cursor、VS Code、Windsurf）
• 託管工具
• 提示範例
• 疑難排解
• 本機套件（stdio）
• 本機套件工具（62 項）
• 為什麼選擇 Taskade MCP？
• 代理程式配方
• OpenAPI Codegen
• Taskade 是什麼？
• 隱私權與安全性
• 支援
• 貢獻
• 授權

示範

由 Anthropic 的 Claude Desktop 執行、以 MCP 驅動的 Taskade 代理程式：

透過 MCP 建置代理程式	執行自動化	管理專案
從 Claude/Cursor 建立、訓練及部署 AI 代理程式	列出自動化、執行一項並讀取其執行記錄	透過 AI 助理全面管理工作空間 (付費方案)

Taskade MCP 伺服器：快速入門

不帶權杖的 initialize 請求會刻意傳回 401。401 會告訴用戶端從何處開始 OAuth 登入。

Claude（網頁版、Desktop 和行動版）

1. 在 Claude 中，前往Customize > Connectors，然後選取 Add custom connector。若使用 Team 或 Enterprise 方案，Owner 必須先在 Organization settings > Connectors 中新增連接器（選取 Add，再選 Custom）。
2. 輸入名稱 Taskade 和 URL https://www.taskade.com/mcp，然後選取 Add。
3. 選取 Connect，登入 Taskade 並核准存取權。
4. 在聊天中，選取 + > Connectors，然後開啟 Taskade。

如果對話方塊詢問 OAuth client，請選取 Register automatically。同一個帳戶也可在 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 Settings > 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：啟動一項狀態為 On 且觸發條件為 "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 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 代理

使用自訂知識和工具建立、管理及發布自主 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 工具層提供。

• 自動化工具：託管伺服器可列出自動化、讀取其執行記錄，並執行「When asked」自動化（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
• 錯誤回報與功能需求：GitHub issues

參與貢獻

協助我們改進 MCP 工具、OpenAPI 工作流程和代理功能。

• 問題 — 回報錯誤或提出功能需求
• 提取要求 — 歡迎貢獻
• 應用程式 — 瀏覽並複製社群應用程式 · 類別

更多 Taskade 資訊

• 代理技能（SKILL.md） · llms.txt 索引 · 開發者文件
• Awesome Vibe Coding — 精選的 vibe coding 工具、MCP 伺服器和代理技能
• Taskade 文件（原始碼）— 開發者文件和 API 參考資料
• Integration Kit — 開放原始碼 Zapier/n8n 動作與觸發器
• Taskade on GitHub — 組織首頁和開放原始碼儲存庫
• Taskade — 平台首頁，包含 Genesis 和 AI 應用程式建置工具

授權條款

MIT