프로젝트 관리 MCP: Task-Master 설치 및 설정 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

AI 기반 작업 관리 도구(Task-Master)를 사용하는 개발자, 프로젝트 관리자

난이도: 중간 (API 키 설정 및 명령줄 사용 필요)

핵심 요약

• 필수 API 키 (Anthropic, OpenAI, Google Gemini 등 중 최소 1개 이상 필요)
• Node.js 20.18 이상 버전이 필수이며, npm 또는 yarn 패키지 매니저 사용
• MCP 방식 또는 명령줄 방식으로 설치 가능 (MCP 권장)

섹션별 세부 요약

1. 소개

• Task-Master는 Claude AI와 Cursor AI 통합된 AI 기반 작업 관리 시스템
• 여러 AI 모델(Anthropic, OpenAI, Google Gemini 등) 사용 가능

2. 사전 요구사항

• Node.js 20.18 이상 설치
• npm 또는 yarn 패키지 매니저 사용
• Cursor IDE 권장 (또는 일반 텍스트 에디터)

3. 설치 방법

• MCP 방식:

- Cursor Setting > MCP > Add new global MCP server에서 설정

- mcpServers JSON 구성에 API 키 입력 (예: ANTHROPIC_API_KEY, OPENAI_API_KEY)

• 명령줄 방식:

- npm install -g task-master-ai 또는 npx task-master init 사용

4. 프로젝트 초기화

• 전역 설치: task-master init 실행 후 설정 질문에 답변
• 프로젝트별 설치: .env 파일 생성 후 API 키 입력
• scripts/[your-project-name]_prd.txt 파일 생성 후 task-master parse-prd 실행

5. Task 생성 및 관리

• task-master list로 Task 목록 확인
• task-master set-status --id=1 --status=in-progress로 Task 상태 변경
• Task-Master는 자동 완료 기능 없음 (사용자가 직접 상태 관리)

6. 기본 명령어

• task-master init: 프로젝트 초기화
• task-master parse-prd: PRD 파일 파싱
• task-master list: Task 목록 확인
• task-master next: 다음 Task 실행

7. 문제 해결

• task-master init이 응답하지 않을 경우:

- Node.js 버전 확인

- .env 파일에서 API 키 누락 여부 확인

- Cursor IDE 설정 재확인

8. 라이선스

• MIT 라이선스 및 Commons Clause 적용
• 허용: 개인/상업/학술 사용, 코드 수정, 복사본 배포
• 금지: Task-Master 자체 판매, 호스팅 서비스 제공, 경쟁 제품 제작

결론

• MCP 방식을 권장하며, .env 파일에 API 키를 정확히 입력해야 함
• Task-Master는 AI 기반 작업 생성 도구이지만, Task 완료는 사용자 직접 관리해야 함
• MIT 라이선스는 Task-Master 자체 판매 금지라는 점 주의 필요