새소식

300x250
AI/MCP

개발자를 위한 MCP 추천(4) - TaskMaster AI MCP 설치 및 사용방법(claude code 사용 예시)

  • -
728x90

안녕하세요! 갓대희 입니다. :- )

오늘은 개발자를 위한 MCP 시리즈의 새로운 글로 "TaskMaster AI"에 대해 써보려고 한다.

 

프로젝트 시작할 때마다 "이거 어떤 순서로 만들지?" 고민하는 단계에서 도움이 될 도구중의 하나이다.

TaskMaster AI는 초창기 설계 단계에서부터 겪는 개발 워크플로우의 고통을 AI가 대신 해결해주는 MCP 기반 업무 관리 시스템이다.

 

TaskMaster AI란? 

현대 개발에서는 AI 주도 개발(AI-driven development : 인공지능을 파트너로 삼아 코드 작성을 보조받고, 작업 계획을 수립하는 방식)이 새로운 패러다임으로 떠오르고 있다.

 

왜냐하면 TaskMaster는 하기 여러 AI코딩의 초창기 이슈를 해소 가능하도록 설꼐되어있다.

기존 AI 코딩의 문제점
• AI의 "폭주" 현상 : 한 번에 모든 것을 처리하려다가 엉뚱한 결과 생성
• 일관성 부족 : 모델이 이전 컨텍스트를 무시하고 새로운 방향으로 코드 작성
• 범위 제어 어려움 : 개발자가 원하는 만큼만 구현하게 하기 힘듦
• 프로젝트 전체 파악 부족 : 작은 변경이 전체에 미치는 영향을 고려하지 못함


이를 해소 하기위해 TaskMaster AI는 업무를 작은 단위자르고, 작은 단위로 정의된 작업들은 AI가 무시할 수 없을 정도로 명확한 경계와 목표를 가지게 해주며, 이를 통해 에러 발생을 줄이고 개발자가 원하는 방향으로 AI를 유도할 수 있도록 설계 되어있다. 

즉, AI가 작업(Task) 목록을 자동으로 관리하도록 돕는 도구이다.

그리고 Cursor, Windsurf, VS Code 등의 IDE와 연동하여 사용할 수 있으며, 단순한 TODO리스트를 관리하는 앱이 아닌, PRD 문서를 읽고 이해해서 개발 가능한 태스크로 변환해주는 지능형 시스템이다. 개발자의 개인 프로젝트 매니저 역할을 해준다고 볼 수 있다.

 

모든 내용은 공식 문서들을 꼭 별도로 참고 하도록 하자.

https://www.task-master.dev/

https://github.com/eyaltoledano/claude-task-master

 

기존 개발 워크플로우의 한계

대부분의 개발자들이 프로젝트 시작 단계에서 겪는 어려운 점들을 살펴보자.

기존 방식의 한계
• PRD와 실제 개발의 괴리 : 기획서는 있는데 실제 구현 단위로 나누기 어려움
• 태스크 의존성 파악 어려움 : 어떤 작업을 먼저 해야 할지 판단하기 힘듦
• 진행 상황 추적의 번거로움 : 수동으로 상태 업데이트하고 다음 할 일 찾기
• 범위 변경 시 혼란 : 기술 스택이나 요구사항이 바뀌면 전체 계획 재검토 필요

예를 들어, "사용자 인증 시스템 구현"이라는 요구사항이 있을 때 이걸 어떤 순서로 나누어서 개발할지, 어떤 부분이 서로 의존성이 있는지를 파악하는 게 은근히 시간 많이 잡아먹는 일이다.

 

TaskMaster AI의 작동 원리

AI 기반 개발 워크플로우

  1. PRD 분석 : AI가 PRD 문서를 읽고 요구사항을 이해
  2. 태스크 자동 생성 : 구현 가능한 단위로 작업을 자동 분할
  3. 의존성 분석 : 태스크 간 선후 관계와 우선순위 자동 계산
  4. 진행 상황 추적 : 완료된 작업 기반으로 다음 할 일 추천
  5. 동적 업데이트 : 요구사항 변경 시 전체 태스크 자동 재조정
💡 핵심 포인트
TaskMaster AI는 자연어로 상호작용이 가능하다. "다음에 작업할 태스크가 뭐야?", "태스크 4 구현해줘", "MongoDB로 바꿨으니까 관련 태스크들 업데이트해줘" 같은 대화형 명령으로 사용할 수 있다!

 

TaskMaster AI 설치 및 기본설정 

필수 조건

📋 시스템 요구사항

  • Node.js 18.0.0 이상 (fetch API 지원 필수)
  • MCP 호환 IDE : Cursor, Windsurf, VS Code, Lovable, Roo 등
  • AI 제공업체 API 키 (최소 1개): Anthropic, OpenAI, Google, Perplexity, xAI, OpenRouter, Azure OpenAI 중 하나
  • Claude Code CLI (API 키 없이 사용 가능한 옵션) : 나는 해당 케이스이다.

 

방법 1 : CLI 설치

// 글로벌 설치
npm install -g task-master-ai

# 또는 로컬 프로젝트에 설치
npm install task-master-ai

# 프로젝트 초기화
npx task-master init

 

 

ex) 나의 경우 빈 폴드 생성 하여 로컬 프로젝트에 설치 하여 시작해 보겠다.

 - 새 프로젝트 폴더에서 하기 명령어 입력

npm install task-master-ai

 

 

 - 하기 명령어 입력

npx task-master init

 

 - 이후 단계 모두 y

 

 - 초기 설정 파일이 만들어 진다.

 

 - 이후 설정 관련하여 내용이 보인다.

 

 - 나의 경우는 "Claude Code"를 선택 하도록 하겠다. 다른 환경을 사용 하시는 분들도 각자 개발 환경에 맞게 시작가능하도록 설정 가능하도록 되어 있다.

프로파일 설명
Amp MCP 설정과 통합 가이드 제공 – AI 통합 관련 베이스 설정 제공
Claude Code Task Master의 명령어(slash commands)와 연동 가능한 규칙 설정
Cline 순수 Rule Profile 기능 – 규칙만 간단히 적용
Codex 포괄적인 Task Master 통합 가이드 제공 (모델 포함)
Cursor Cursor IDE 환경에 맞춘 규칙 + MCP 서버 설정 지원
Gemini 구글 Gemini 기반 AI 환경을 위한 통합 및 MCP 설정
Kiro Rule Profile과 MCP 통합 – 특정 AI 환경 대응
OpenCode 통합 가이드 및 MCP 구성 제공
Roo Code 규칙과 MCP뿐 아니라 agent 모드도 함께 지원
Trae 규칙(profile)만 제공, 기타 기능은 제외
VS Code VSCode 환경 대응 규칙 + MCP 설정 포함
Windsurf Windsurf IDE 환경의 규칙 + MCP 설정 포함
Zed Zed 환경 통합 및 MCP 구성 지원

 

 - 클로드에 맞는 파일들이 추가 된다. 

 

 - 그리고 언어 설정을 하라고 되어 있는데, English 가 당연히 더 성능이 뛰어나겠지만, 포스팅을 위해 "ko"를 입력하도록 하겠다.

  

 - 이후 모델 선택이 가능한데 Default는 claude3.7 sonnet 이다. 이 부분은 본인의 판단하 원하는 모델로 진행하자.  

 

 - 모델 선택이 끝나면 설정이 완료 되었다.

 

 - 하기 설정 예시도 혹시나 하여 추가하여 둔다. 

방법 2: 수동 MCP 설정

Cursor MCP 설정 (.cursor/mcp.json)

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE"
      }
    }
  }
}

Windsurf MCP 설정 (.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE"
      }
    }
  }
}

VS Code MCP 설정 (.vscode/mcp.json)

{
  "servers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE"
      },
      "type": "stdio"
    }
  }
}

 

핵심 기능과 실제 사용법 ⭐

1. PRD 기반 자동 태스크 생성

Task Master AI의 가장 큰 강점은 PRD를 기반으로 프로젝트를 체계적으로 관리한다는 점이다.
AI에게 막연하게 "앱 만들어줘"라고 하는 대신, PRD라는 명확한 설계도를 제공하면 AI는 그 문서에 맞춰 개발 작업을 알아서 쪼개준다. PRD는 명확하고 구체적일수록 AI가 좋은 결과를 내놓을 것이다.

 

 

PRD베이스로 돌아가기 때문에 PRD가 필요하다. 사전 작업으로 PRD를 gpt를 통해 생성 요청 해보자.

ex) prd 생성 예시 결과물을 txt파일로 해도 되고, 난 마크 다운 형식으로 생성 요청 하여 저장하도록 하겠다. 

 

ex)  /scripts 폴더를 만들고, 해당 폴더에 생성한 prd 파일을 추가한다.

 

위와 같이 PRD를 작성한 뒤 AI에게 "PRD를 분석해서 초기 작업 목록을 만들어줘"라고 요청하면, AI는 이 문서를 바탕으로 프로젝트를 완성하기 위한 모든 단계를 체계적으로 추출해줄 것이다.

PRD 기반 작업 분해 워크플로우

  1. 1단계: PRD 작성 - 개발할 기능과 제약사항을 명확히 문서화합니다.
  2. 2단계: AI에 작업 생성 요청 - "PRD를 파싱하여 초기 작업 목록을 생성해줘"라고 명령합니다.
  3. 3단계: 작업 목록 생성 - AI가 PRD를 분석해 /tasks 디렉터리에 각 작업에 대한 파일과 tasks.json 파일을 생성합니다.
  4. 4단계: 작업 검토 - 생성된 작업 목록이 프로젝트의 실제 요구사항과 일치하는지 확인합니다.

 

ex) 자연어로 말해도 된다고 많은 레퍼에서 되어있지만, 난 클로드 코드를 사용하고 있고, mcp편이니 /tm 슬러시 명령어를 활용하려 한다.

/tm:parse-prd:parse-prd ./scripts/prd.md

 

 

ex) 실수로 오타를 내서 scripts가 아닌 scrips 폴더를 지정했다. 만약 내가 잘못 입력하더라도 ai가 올바른 명령어를 호출해버린다.

/tm:parse-prd ./scripts/prd.md

#위와 같이 잘못 실행해도 하기와 같이 알아서 실행
/tm:parse-prd:prase-prd ./scripts/prd.md

 

ex)  생성 결과 (이미 초기에 한글로 설정 하였지만, 해당 옵션이 먹지 않나 보다. )

 

ex) 다시 한글로 변경 요청하였다. AI가 생성한 태스크 결과 12개의 태스트가 생성 되었다. 

 

ex) 원하는 방향으로 이어 나갈 수 있다.

# 어떤 태스크를 진행할지 AI가 판단하여 추천 해 준다.
  - /project:tm/next - 시작할 첫 번째 태스크 추천받기

# 상기 태스크 중 무거운 태스크가 있으면 또 하위 태스크로 나눠준다.
  - /project:tm/expand <번호> - 복잡한 태스크를 세부 작업으로 나누기

# 해당 태스트의 상세 정보 확인
  - /project:tm/show <번호> - 특정 태스크의 상세 정보 확인

 

 

2. 자연어 기반 태스크 관리

복잡한 명령어를 외울 필요 없이 자연어로 대화하듯 사용할 수도 있다.

 

ex) 고마워 전체 태스크를 다시 한번 보여줘.

// 사용 예시들
# 여러 태스크 동시 조회
Can you show me tasks 1, 3, and 5?

# 태스크 상태 업데이트
Task 3 is now complete. Please update its status.

# 기술 스택 변경 반영
We've decided to use MongoDB instead of PostgreSQL. 
Can you update all future tasks to reflect this change?

# 복잡한 태스크 세분화
Task 5 seems complex. Can you break it down into subtasks?

# 보안 고려사항 포함 확장
Please break down task 5 with a focus on security considerations.

 

 - 나의 경우 api key 설정을 안했더니 tasks폴더에 task-00n.txt파일을 생성하지 않았다. 자연어로 task.json 생성 요청

 

 - 개별 task 파일 생성 진행 완료.

 

 - claude code가 아닌 직접 task mast에서도 생성된 리스트를 정상적으로 확인이 가능 하다. 

npx task-master list

 

 - 1번 작업을 진행 해보자. 그럼 Status가 변경될 것이다.

 ex) 진행 중


 ex) 별도의 cli 창에서 tm list 확인

 - 1번 작업이 완료되면 dependency 1번을 갖고있는 2번작업이 시작될 것이다.

 

 - 첫번째 작업이 끝났다.

 

 - 2번째 태스크(1번째 태스크 의존을 갖고 있는)가 다음 단계이니 시작할지를 물어보고 있다. 현상황에 다시 한번 tm list를 확인해보자.

npx task-master list

 - 첫번째 태스크가 done으로 완료처리되었고, 대시보드에 진척률도 올라갔다. 그리고 다음 작업 2번작업을 진행할것을 권고 하고 있다. 

 - 만약 상기 태스크중 헤비 태스크, 무거운 태스크가 있으면 나누어 주면 계속 쭉 이어서 개발작업을 진행할수도 있을 것 이다.

 

3. 복잡한 작업의 하위 작업 분리 쪼개기

때로는 PRD에서 나온 작업들이 여전히 AI에게는 너무 복잡할 수 있다.

예를 들어 "할 일 목록 UI 컴포넌트 구현"은 사실 UI 렌더링, 상태 관리, 이벤트 처리 등 여러 하위 작업으로 구성될 것이다.

이런 경우, 작업을 더 잘게 쪼개는 것이 AI의 코드 품질을 높일 수 있다.

💡 팁
사람이 한 번에 해결하기 벅찬 큰 작업이라면, AI에게도 어렵습니다. AI에게 "이 작업 좀 더 세분화해줘"라고 요청하거나, 직접 하위 작업(subtask)을 만들어 보자. 작은 단위의 작업일수록 AI가 맥락을 잃지 않고 정확하게 코드를 생성한다.

"UI 컴포넌트 구현" 작업을 세분화하면 다음과 같은 하위 작업들로 나눌 수 있습니다.

  • Task 2.1: 할 일 목록을 보여줄 TodoList 컴포넌트 생성
  • Task 2.2: 개별 할 일 항목을 표현하는 TodoItem 컴포넌트 생성 (체크박스와 삭제 버튼 포함)
  • Task 2.3: 기본 스타일링 적용 (완료된 항목에 취소선 표시)

이렇게 작은 단위로 나누면 AI가 훨씬 더 효율적으로 코드를 작성할 수 있다.

 

ex) 정말 마구잡이로 나눠달라고 요청해보겠다.

> 2번 태스크가 front-end, backend 처럼 큰 덩어리들이 있을텐데 하위 태스크로 나눌 수 있을까? 태스크 마스터를 통해서

 

ex) 결과 전문 (시간없으신 분들은 빠르게 하기 내용으로 패스)

> 2번 태스크가 front-end, backend 처럼 큰 덩어리들이 있을텐데 하위 태스크로 나눌 수 있을까? 태스크 마스터를 통해서

⏺ 네! 태스크를 하위 태스크로 나누는 것이 좋은 아이디어입니다. Task Master의 expand 기능을 사용해서 2번 태스크를 세부 작업으로
  나누어보겠습니다.


⏺ task-master-ai - expand_task (MCP)(projectRoot: "/Users/dedur/work/todolist", id: "2", num: "5", prompt: "개발 환경 구축 태스크를 다음과 같이
                                    세분화해주세요:\n1. Tailwind CSS 설치 및 기본 설정\n2. ESLint 설정 및 규칙 구성\n3. Prettier 설정 및 포맷팅 규칙\n4.
                                    ESLint + Prettier 통합 설정\n5. Vite 빌드 최적화 및 개발 스크립트 정리\n\n각 하위 태스크는 독립적으로 실행 가능하고
                                    테스트할 수 있도록 구성해주세요.")
  ⎿  Error: Claude Code API error during text generation: Claude Code process exited with code 1
     Version: 0.24.0
     Name: task-master-ai
     Current Tag: master

⏺ API 키 문제로 자동 확장이 안 되는 것 같네요. 수동으로 2번 태스크를 하위 태스크로 나누어보겠습니다.

⏺ Read(.taskmaster/tasks/tasks.json)
  ⎿  Read 50 lines (ctrl+r to expand)

⏺ 수동으로 2번 태스크에 하위 태스크를 추가하겠습니다. JSON을 직접 수정해서 세분화된 작업으로 나누어보겠습니다:

⏺ Update(.taskmaster/tasks/tasks.json)
  ⎿  Updated .taskmaster/tasks/tasks.json with 62 additions and 1 removal                                                                                    
       26            "testStrategy": "린트 실행 및 빌드 테스트",
       27            "createdAt": "2025-08-18T13:40:00.000Z",
       28            "updatedAt": "2025-08-18T13:40:00.000Z",
       29 -          "subtasks": []
       29 +          "subtasks": [
       30 +            {
       31 +              "id": "2.1",
       32 +              "title": "Tailwind CSS 설치 및 기본 설정",
       33 +              "description": "Tailwind CSS 패키지 설치 및 기본 구성 파일 설정",
       34 +              "status": "pending",
       35 +              "priority": "high",
       36 +              "dependencies": [],
       37 +              "details": "- Tailwind CSS, PostCSS, Autoprefixer 설치\n- tailwind.config.js 생성 및 설정\n- PostCSS 설정\n- CSS 파일에 Tailwind 
          + 디렉티브 추가\n- 기본 테스트 클래스 적용",
       38 +              "testStrategy": "Tailwind 클래스가 정상적으로 적용되는지 확인",
       39 +              "createdAt": "2025-08-18T13:40:00.000Z",
       40 +              "updatedAt": "2025-08-18T13:40:00.000Z"
       41 +            },
       42 +            {
       43 +              "id": "2.2",
       44 +              "title": "ESLint 설정 및 규칙 구성",
       45 +              "description": "React TypeScript 프로젝트용 ESLint 규칙 설정",
       46 +              "status": "pending",
       47 +              "priority": "high",
       48 +              "dependencies": ["2.1"],
       49 +              "details": "- @typescript-eslint 패키지 설치\n- React Hook 규칙 추가\n- eslint.config.js 구성\n- TypeScript 관련 규칙 설정\n- 기본 
          + 코드 스타일 규칙 추가",
       50 +              "testStrategy": "eslint 명령어 실행으로 규칙 작동 확인",
       51 +              "createdAt": "2025-08-18T13:40:00.000Z",
       52 +              "updatedAt": "2025-08-18T13:40:00.000Z"
       53 +            },
       54 +            {
       55 +              "id": "2.3",
       56 +              "title": "Prettier 설정 및 포맷팅 규칙",
       57 +              "description": "코드 포맷팅을 위한 Prettier 설정",
       58 +              "status": "pending",
       59 +              "priority": "medium",
       60 +              "dependencies": ["2.2"],
       61 +              "details": "- Prettier 패키지 설치\n- .prettierrc 설정 파일 생성\n- .prettierignore 파일 생성\n- 포맷팅 규칙 정의 (세미콜론, 따옴표, 
          + 들여쓰기 등)\n- VS Code 설정 추가",
       62 +              "testStrategy": "코드 포맷팅이 자동으로 적용되는지 확인",
       63 +              "createdAt": "2025-08-18T13:40:00.000Z",
       64 +              "updatedAt": "2025-08-18T13:40:00.000Z"
       65 +            },
       66 +            {
       67 +              "id": "2.4",
       68 +              "title": "ESLint + Prettier 통합 설정",
       69 +              "description": "ESLint와 Prettier가 충돌없이 함께 동작하도록 설정",
       70 +              "status": "pending",
       71 +              "priority": "medium",
       72 +              "dependencies": ["2.3"],
       73 +              "details": "- eslint-config-prettier 설치\n- eslint-plugin-prettier 설치\n- ESLint 설정에 Prettier 규칙 통합\n- 충돌하는 규칙 
     해결\n-
          +  자동 포맷팅 설정",
       74 +              "testStrategy": "ESLint와 Prettier가 충돌없이 동작하는지 확인",
       75 +              "createdAt": "2025-08-18T13:40:00.000Z",
       76 +              "updatedAt": "2025-08-18T13:40:00.000Z"
       77 +            },
       78 +            {
       79 +              "id": "2.5",
       80 +              "title": "개발 스크립트 및 빌드 최적화",
       81 +              "description": "package.json 스크립트 정리 및 Vite 빌드 최적화",
       82 +              "status": "pending",
       83 +              "priority": "low",
       84 +              "dependencies": ["2.4"],
       85 +              "details": "- package.json 스크립트 추가 (lint, format, type-check)\n- Vite 설정 최적화 (별칭, 플러그인)\n- 빌드 성능 개선 설정\n- 
          + 개발 서버 설정 최적화\n- Git hooks 설정 (husky, lint-staged)",
       86 +              "testStrategy": "모든 스크립트가 정상 동작하고 빌드가 성공하는지 확인",
       87 +              "createdAt": "2025-08-18T13:40:00.000Z",
       88 +              "updatedAt": "2025-08-18T13:40:00.000Z"
       89 +            }
       90 +          ]
       91          },
       92          {
       93            "id": 3,

⏺ 이제 Task Master 파일을 재생성해서 하위 태스크들이 반영되도록 하겠습니다:

⏺ task-master-ai - generate (MCP)(projectRoot: "/Users/lf/work/todolist")
  ⎿  {                                                  
       "data": {
         "message": "Successfully generated task files",
     … +15 lines (ctrl+r to expand)

⏺ 완벽합니다! 이제 2번 태스크에 하위 태스크들이 추가되었습니다. 확인해보겠습니다:

⏺ task-master-ai - get_task (MCP)(projectRoot: "/Users/lf/work/todolist", id: "2")
  ⎿  {                             
       "data": {
         "id": 2,
     … +94 lines (ctrl+r to expand)

⏺ 🎉 완벽! 2번 태스크가 5개의 하위 태스크로 성공적으로 분리되었습니다!

  📋 태스크 2 "개발 환경 구축" 하위 태스크 목록

  🔥 높은 우선순위

  2.1 Tailwind CSS 설치 및 기본 설정
  - Tailwind CSS, PostCSS, Autoprefixer 설치
  - tailwind.config.js 생성 및 설정
  - PostCSS 설정
  - CSS 파일에 Tailwind 디렉티브 추가
  - 기본 테스트 클래스 적용

  2.2 ESLint 설정 및 규칙 구성
  - @typescript-eslint 패키지 설치
  - React Hook 규칙 추가
  - eslint.config.js 구성
  - TypeScript 관련 규칙 설정
  - 기본 코드 스타일 규칙 추가

  🟡 중간 우선순위

  2.3 Prettier 설정 및 포맷팅 규칙
  - Prettier 패키지 설치
  - .prettierrc 설정 파일 생성
  - .prettierignore 파일 생성
  - 포맷팅 규칙 정의
  - VS Code 설정 추가

  2.4 ESLint + Prettier 통합 설정
  - eslint-config-prettier 설치
  - eslint-plugin-prettier 설치
  - ESLint 설정에 Prettier 규칙 통합
  - 충돌하는 규칙 해결
  - 자동 포맷팅 설정

  🟢 낮은 우선순위

  2.5 개발 스크립트 및 빌드 최적화
  - package.json 스크립트 추가 (lint, format, type-check)
  - Vite 설정 최적화 (별칭, 플러그인)
  - 빌드 성능 개선 설정
  - 개발 서버 설정 최적화
  - Git hooks 설정 (husky, lint-staged)

  ---
  🚀 다음 단계

  2.1번 하위 태스크부터 순차적으로 진행할 수 있습니다:

  실행 가능한 명령어:
  - /project:tm/set-status/to-in-progress 2 - 2번 메인 태스크 시작
  - 또는 하위 태스크 직접 실행 (하위 태스크 ID를 확인 후)

  **2.1 "Tailwind CSS 설치 및 기본 설정"**부터 시작해보시겠어요? 🎨

 

 - txt파일 생성이 되지 않아 이 부분을 자연어로 지적하였다. 

> tasks_00n.txt  파일에 변경사항이적용 안된거같아. tasks.json 파일은 변경사항 확인했어.

⏺ 맞습니다! tasks.json 파일은 업데이트되었지만 개별 태스크 파일들(task-001.txt,
  task-002.txt 등)에는 하위 태스크가 반영되지 않았네요.

  Task Master의 generate 명령을 다시 실행해서 개별 파일들을 업데이트하겠습니다:

⏺ task-master-ai - generate (MCP)(projectRoot: "/Users/dedur/work/todolist")
  ⎿  {                                                  
       "data": {
         "message": "Successfully generated task files",
     … +15 lines (ctrl+r to expand)

⏺ 이제 생성된 파일들을 확인해보겠습니다:

⏺ List(.taskmaster/tasks)
  ⎿  Listed 17 paths (ctrl+r to expand)

⏺ 2번 태스크 파일을 확인해서 하위 태스크가 제대로 반영되었는지 보겠습니다:

⏺ Read(.taskmaster/tasks/task_002.txt)
  ⎿  Read 67 lines (ctrl+r to expand)

⏺ 🎉 완벽! 이제 task_002.txt 파일에도 하위 태스크들이 제대로 반영되었습니다!

  ✅ 업데이트 확인 완료

  📄 task_002.txt 파일 내용:
  - ✅ 5개 하위 태스크 모두 표시됨
  - ✅ 각 하위 태스크별 세부 사항 포함
  - ✅ 의존성 관계 명시 (2.1 → 2.2 → 2.3 → 2.4 → 2.5)
  - ✅ 상태, 설명, 상세 내용 모두 포함

  📋 2번 태스크 하위 구조 (최종 확인)

  2.1 Tailwind CSS 설치 및 기본 설정 [pending]
  2.2 ESLint 설정 및 규칙 구성 [pending] ← depends on 2.1
  2.3 Prettier 설정 및 포맷팅 규칙 [pending] ← depends on 2.22.4 ESLint + Prettier 통합
  설정 [pending] ← depends on 2.3
  2.5 개발 스크립트 및 빌드 최적화 [pending] ← depends on 2.4

  ---
  🚀 다음 단계

  이제 **2.1번 "Tailwind CSS 설치 및 기본 설정"**부터 차례대로 진행할 수 있습니다!

  시작 명령어:
  - /project:tm/set-status/to-in-progress 2 - 2번 메인 태스크 시작
  - 개별 하위 태스크는 수동으로 진행

  2.1번 하위 태스크부터 시작해보시겠어요? 🎨

 

 

 

 -  tm list를 통해 잘 나누어 졌는지 확인해보자.

npx task-master list

 

ex) 서브 태스크 5개가 생성되어 있는것이 보인다. 

 

ex) 자연어로 요청하거나, 하기 명령어를 통해 그 다음을 계속 이어 나갈 수 있다.

│   Suggested Next Steps:                                                              │
│                                                                                      │
│   1. Run task-master next to see what to work on next                                │
│   2. Run task-master expand --id=<id> to break down a task into subtasks             │
│   3. Run task-master set-status --id=<id> --status=done to mark a task as complete   │

 

 

4. 리서치 기능 활용

최신 기술 동향이나 베스트 프랙티스를 실시간으로 검색해서 태스크에 반영할 수 있기도 하다.

// 리서치 기능 사용 예시
# 최신 정보 리서치
Research the latest best practices for implementing JWT authentication with Node.js

# 프로젝트 컨텍스트 기반 리서치
Research React Query v5 migration strategies for our current API implementation

# 리서치 결과 기반 태스크 생성
Please break down task 5 using research-backed generation
💡 리서치 팁
퍼플렉시티를 이용해서 리서치 기능을 사용하려면 Perplexity API 키를 설정할수도 있지만,
이미 클로드 코드의 내장 기능, context7등의 기능을 활용하는것을 추천 한다. 

 

5. 다양한 AI 모델 지원

TaskMaster AI는 여러 AI 제공업체를 지원하며, 역할별로 다른 모델을 사용할 수 있다.

다만, 내가 작성한 예시처럼 클로드 코드 같은 CLI 환경에서도 가능하기때문에, 이젠 API key발급하여 추가 과금 필요 없이도 진행 가능하여 해당 mcp 사용 예시를 작성하게 되었다. 

모델 설정 예시

# AI 모델 설정 (Cursor 채팅창에서)
Change the main, research and fallback models to claude-3-5-sonnet, perplexity-llama-3.1-sonar, and gpt-4o respectively

# Claude Code 사용 (API 키 불필요)
Change the main model to claude-code/sonnet

# 모델별 역할
# Main Model: 일반적인 태스크 생성 및 관리
# Research Model: 최신 정보 검색 및 분석  
# Fallback Model: 메인/리서치 모델 실패 시 대체

 

6. ETC

 - 이외에 필요한 클로드 코드기반의 task-manager 고급설정, 상세 설정은 하기 문서를 보고 참고하자.

https://github.com/eyaltoledano/claude-task-master/blob/main/docs/examples/claude-code-usage.md

 

트러블슈팅 및 자주 겪는 문제들

💀 문제 1: "0 tools enabled" 에러
MCP 설정에서 TaskMaster AI가 활성화되지 않는 경우가 가장 흔한 문제입니다. 특히 Cursor에서 자주 발생해요.
✅ 해결 방법
1. args 배열에서 --package=task-master-ai 플래그를 제거해보세요
2. IDE를 완전히 재시작한 후 MCP 설정에서 taskmaster-ai 토글을 다시 활성화
3. 그래도 안 되면 npx task-master-ai를 터미널에서 직접 실행해서 오류 메시지 확인
💀 문제 2: API 키 관련 에러
"Configuration missing" 또는 "Invalid API key" 에러가 발생하는 경우입니다.
✅ 해결 방법
1. API 키가 올바른 위치에 설정되어 있는지 확인 (MCP 설정 파일의 env 섹션)
2. task-master models --setup 명령으로 설정 파일 재생성
3. 최소 1개의 유효한 API 키가 있는지 확인 (Claude Code 사용 시 API 키 불필요)

 

이외 활용방식들

1. 태스크 일괄 관리

요구사항이 변경되었을 때 관련된 모든 태스크를 한 번에 업데이트할 수 있어요.

// 일괄 업데이트 예시
# 특정 태스크 이후 모든 태스크 업데이트
We've decided to use MongoDB instead of PostgreSQL. 
Can you update all future tasks (from ID 4) to reflect this change?

# CLI에서 일괄 업데이트
task-master update --from=4 --prompt="Now we are using MongoDB instead of PostgreSQL."

# 리서치 기반 업데이트
task-master update --from=4 --prompt="Update to use MongoDB, researching best practices" --research

 

2. 태스크 이동 및 재정렬

프로젝트 진행 중 태스크 순서를 변경해야 할 때 유용한 기능입니다.

// 태스크 재정렬
# 태스크 위치 이동
task-master move --from=10 --to=16
task-master move --from=11 --to=17

# 서브태스크 이동
I think subtask 5.2 would fit better as part of task 7 instead. 
Can you move it there?

 

3. Claude Code 연동 (API 키 불필요)

Claude Code CLI가 설치되어 있다면 API 키 없이도 TaskMaster AI를 사용할 수 있습니다.

📄 Claude Code 설정

{
  "models": {
    "main": {
      "provider": "claude-code",
      "modelId": "sonnet",
      "maxTokens": 64000,
      "temperature": 0.2
    },
    "research": {
      "provider": "claude-code", 
      "modelId": "opus",
      "maxTokens": 32000,
      "temperature": 0.1
    }
  }
}
💡 Claude Code 장점
• API 키 불필요 (로컬 Claude 인스턴스 사용)
• 프로젝트 구조 분석 후 더 정확한 태스크 생성
• 기존 코드베이스 패턴을 고려한 구현 가이드 제공

 

실무 적용 시나리오 

시나리오 1: 신규 프로젝트 시작 > 항상 프롬프트는 영어로 작성하는게 퀄리티는 높다. ( 예시는 한글이었지만.. )

완전한 프로젝트 워크플로우

  1. PRD 작성: .taskmaster/docs/prd.txt에 상세한 요구사항 작성
  2. 프로젝트 초기화: "Initialize taskmaster-ai in my project"
  3. 태스크 생성: "Can you parse my PRD and generate tasks?"
  4. 개발 시작: "What's the next task I should work on?"
  5. 진행 관리: "Task X is complete. Update status and show next task."

 

시나리오 2: 기존 프로젝트 마이그레이션

// 기존 프로젝트에 TaskMaster 도입
# 마이그레이션 도구 사용
task-master migrate

# 또는 기존 PRD가 scripts/prd.txt에 있는 경우
Can you help me migrate my existing project structure to TaskMaster?

# 현재 상태 기반으로 남은 작업 계획
Based on my current codebase, can you generate remaining tasks to complete the project?

 

정리

  • 상세한 PRD가 핵심: 추상적인 요구사항보다는 구체적인 기능 명세와 제외 사항까지 명시
  • 자연어 인터페이스의 편리함: 복잡한 CLI 명령어 대신 대화하듯 사용 가능
  • 리서치 기능 적극 활용: 최신 기술 동향을 반영한 더 정확한 태스크 생성
  • 여러 AI 모델 조합의 효과: 역할별로 다른 모델 사용 시 더 나은 결과
  • Cursor 연동의 강력함: IDE 내에서 바로 태스크 관리하며 개발하는 워크플로우

 

자주 묻는 질문 ❓

Q: TaskMaster AI를 사용하려면 어떤 API 키가 필요한가요?
A: 최소 1개의 AI 제공업체 API 키가 필요합니다. Anthropic, OpenAI, Google, Perplexity, xAI, OpenRouter, Azure OpenAI 중 선택하세요. Claude Code CLI가 있다면 API 키 없이도 사용 가능합니다.
Q: Cursor 외에 다른 IDE에서도 사용할 수 있나요?
A: 네! Windsurf, VS Code, Lovable, Roo 등 MCP를 지원하는 모든 IDE에서 사용 가능합니다. 각 IDE별로 설정 파일 위치만 다를 뿐 기능은 동일합니다.
Q: 기존 프로젝트에도 적용할 수 있나요?
A: 물론입니다! task-master migrate 명령으로 기존 프로젝트를 TaskMaster 구조로 마이그레이션할 수 있고, 현재 코드베이스를 분석해서 남은 작업을 자동으로 계획해줍니다.
Q: 리서치 기능은 어떻게 작동하나요?
A: Perplexity API를 통해 최신 기술 동향과 베스트 프랙티스를 실시간으로 검색해서 태스크 생성에 반영합니다. "Research the latest Node.js security practices" 같은 명령으로 사용할 수 있어요.
Q: 태스크가 너무 많이 생성되면 어떻게 하나요?
A: PRD를 더 구체적으로 작성하고 제외할 기능을 명시하거나, --num-tasks=10 옵션으로 생성할 태스크 수를 제한할 수 있습니다. 복잡한 태스크는 나중에 서브태스크로 세분화하는 것을 추천합니다.

참고 자료

300x250
저작자표시 비영리 변경금지 (새창열림)

'AI > MCP' 카테고리의 다른 글

개발자를 위한 MCP 추천(6) - Magic MCP 설치 및 사용방법  (6) 2025.10.15
개발자를 위한 MCP 추천(5) - Shrimp Task Manager MCP 설치 및 사용방법(claude code 사용 예시)  (4) 2025.08.20
개발자를 위한 MCP 추천(3) - Playwright MCP 설치 및 사용방법(claude desktop, claude code, gemini cli)  (13) 2025.08.17
개발자를 위한 MCP 추천(2) - Context7 MCP 설치 및 사용방법(with claude code, gemini cli)  (6) 2025.08.16
개발자를 위한 MCP 추천(1) - Sequential Thinking MCP 설치 및 사용방법(claude desktop, claude code, gemini cli)  (8) 2025.08.15
Contents

당신이 좋아할만한 콘텐츠

댓글 9

포스팅 주소를 복사했습니다

이 글이 도움이 되었다면 공감 부탁드립니다.

SHARE

DARK

MENU

💡 AI 관련 질문이 있나요? 눌러보세요!

티스토리툴바