Taskade

이 저장소에는 Taskade 에이전트 플러그인과 두 개의 패키지가 있습니다.

• MCP 서버 (@taskade/mcp-server): 원격 서버에 연결할 수 없는 클라이언트를 위한 로컬 stdio 서버입니다.
• OpenAPI Codegen: Taskade뿐 아니라 모든 OpenAPI 사양에서 MCP 도구를 생성합니다.

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 요금제에서는 먼저 소유자가 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을, 서버 URL로 https://www.taskade.com/mcp를 입력합니다.
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: 켜져 있고 "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.

문제 해결

문제가 계속되면 이슈를 등록하거나 support@taskade.com으로 이메일을 보내세요.

로컬 패키지 (stdio)

클라이언트가 stdio 서버만 지원하거나 웹훅 도구(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 에이전트를 만들고, 관리하고, 게시하세요.

템플릿

미디어

개인

에이전트 채팅 및 웹훅(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

REST API 대신 MCP를 사용하는 이유

다른 MCP 서버보다 Taskade 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 코드 생성

Taskade뿐 아니라 모든 OpenAPI 사양에서 MCP 도구를 만들 수 있는 생성기를 사용하세요.

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개 이상의 통합, 분기, 반복, 필터링을 지원하는 노코드 워크플로 자동화
• 실시간 협업 — 채팅, 영상, 여러 프로젝트 보기를 지원하는 멀티플레이어 워크스페이스
• 템플릿: 프로젝트 관리, 엔지니어링, 마케팅 등을 위한 템플릿
• API 및 MCP: REST API v2, 이 MCP 서버, 에이전트 플러그인, Agent API, 웹훅, OAuth 2.0

링크:

• 앱: taskade.com
• 만들기: taskade.com/create
• 앱 갤러리: taskade.com/apps · 모든 카테고리
• 에이전트: taskade.com/agents
• 템플릿: taskade.com/templates
• 문서: taskade.com/docs · docs.taskade.com
• Workspace MCP 가이드: https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• Hosted MCP 가이드: https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• 블로그: taskade.com/blog

로드맵

계획된 기능과 개선 사항은 열린 이슈를 참조하세요.

최근 출시됨(v0.1.0): 에이전트 채팅(promptAgent)과 웹훅 트리거를 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 이슈

기여하기

MCP 도구, OpenAPI 워크플로, 에이전트 기능을 개선하는 데 도움을 주세요.

• 이슈 — 버그를 신고하거나 기능을 요청하세요
• Pull Request — 기여를 환영합니다
• 앱 — 커뮤니티 앱을 둘러보고 복제하세요 · 카테고리

Taskade의 다른 자료

• 에이전트 스킬(SKILL.md) · llms.txt 색인 · 개발자 문서
• Awesome Vibe Coding — 엄선된 바이브 코딩 도구, MCP 서버, 에이전트 스킬
• Taskade 문서 (소스) — 개발자 문서 및 API 참조
• Integration Kit — 오픈 소스 Zapier/n8n 작업 및 트리거
• GitHub의 Taskade — 조직 홈 및 오픈 소스 저장소
• Taskade — Genesis를 비롯한 플랫폼 홈, AI 앱 빌더

라이선스

MIT