외부 연동MCPAI통합
MCP — Claude · Cursor · VS Code 연동
PAT(개인 액세스 토큰)을 발급해 Claude Desktop·Cursor·VS Code Codex·Gemini 등에서 바로 TaskFlow 데이터를 다룰 수 있습니다.
약 6분 2026년 5월 5일 업데이트
MCP 토큰 발급
1
설정 → MCP & API 토큰
프로필 아바타 > 설정 > 'MCP & API 토큰' 카드에서 새 토큰을 발급합니다. 토큰은 발급 시점에만 평문으로 표시되며 이후엔 해시만 저장됩니다.
주의토큰은 비밀번호와 동일한 등급의 자격 증명입니다. 외부에 노출되지 않도록 안전하게 보관하세요.
2
토큰 폐기
토큰 카드의 '폐기' 버튼으로 즉시 무효화할 수 있습니다. 폐기 후 같은 토큰으로는 어떤 요청도 통과하지 않습니다.
Claude Desktop / Cursor 설정
1
claude_desktop_config.json 편집
Claude Desktop 설정 파일에 TaskFlow MCP 서버를 추가합니다. macOS 기준 경로: ~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.jsonjson
{
"mcpServers": {
"taskflow": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://taskflow.promstack.com/api/mcp"],
"env": {
"MCP_AUTH_HEADER": "Bearer YOUR_PAT_HERE"
}
}
}
}2
Claude 재시작
Claude Desktop 을 완전히 재시작하면 'taskflow' 서버가 도구 목록에 나타납니다. Cursor·VS Code 도 같은 형식으로 설정합니다.
사용할 수 있는 9개 도구
- list_projects — 내 프로젝트 목록
- get_tasks — 프로젝트 태스크 조회 (status·assignee 필터)
- create_task / update_task — 태스크 생성·수정
- list_pages — 위키 페이지 트리 (parent_id 계층)
- get_page — 페이지 상세 (본문 포함)
- create_page / update_page — 페이지 생성·수정
- get_project_stats — 프로젝트 통계 (태스크 수·진행률)
한도
1
Free 한도
분 10회 / 시 60회 / 일 300회. 가벼운 개인 셋업에 충분합니다.
2
Pro 한도
분 30회 / 시 300회 / 일 5,000회. 헤비 에이전트 워크플로우용.
3
한도 초과 시
429 응답 + Retry-After 헤더가 반환됩니다. AI 에이전트는 자동으로 백오프합니다.
참고MCP 자체는 Free·Pro 모두 사용 가능합니다 — 차등은 호출 수만.