MCP로 태스크 처리하기

태스크 관련 MCP를 이용하면 채널에서 태스크를 만들고, 조회하고, 수정하고, 답변을 등록하는 작업을 자동화할 수 있습니다.

매뉴얼웍스에서 MCP를 설정하는 방법은 다음 가이드를 참고합니다.

태스크에서 자주 쓰는 MCP 기능

기능

용도

get_channels

접근 가능한 채널 목록을 조회합니다. 태스크를 만들 채널을 먼저 확인할 때 사용합니다. 단 업무 채널만 반환합니다.

create_task

채널에 새 태스크를 만듭니다. 만들면서 마일스톤을 함께 연결할 수 있습니다.

get_task

태스크 상세 정보를 조회합니다. 필요하면 답변 목록도 함께 조회합니다. 태스크에 붙어 있는 카테고리와 마일스톤, 관련 태스크, 자신이 작성한 메모도 함께 반환합니다.

update_task

태스크 제목이나 설명을 수정합니다. 태스크를 작성한 사용자만 수정할 수 있고, 메일로 받은 태스크는 수정할 수 없습니다.

move_task

태스크를 다른 채널로 옮깁니다. 태스크 유형은 옮긴 채널에 맞춰 바뀝니다.

get_filters

접근 가능한 필터 목록을 조회합니다.

get_tasks_by_filter

필터 조건에 맞는 태스크 목록(아이디와 제목)을 조회합니다.

create_answer

태스크에 답변을 추가합니다. 유형을 NOTE로 지정하면 자신만 보는 메모를 남깁니다.

get_answer

답변 하나를 조회합니다.

update_answer

등록한 답변 내용을 수정합니다. 답변을 작성한 사용자만 수정할 수 있고, 메일로 받은 답변과 메일로 보낸 답변은 수정할 수 없습니다.

update_related_tasks

태스크 사이의 관계(관련, 선행, 후행)를 추가하거나 제거합니다.

get_milestones

접근 가능한 마일스톤 목록을 조회합니다. 태스크에 연결할 대상을 확인할 때 사용합니다.

update_milestones

태스크에 마일스톤을 추가하거나 제거합니다.

get_categories

접근 가능한 태스크 카테고리 목록을 조회합니다. 부모와 자식 관계를 그대로 반환합니다.

update_categories

태스크에 카테고리를 추가하거나 제거합니다. 태스크를 작성한 사용자나 채널 소유자만 바꿀 수 있습니다. 여러 개를 한 번에 처리하며, 이미 붙어 있는 것을 다시 붙이거나 붙지 않은 것을 떼면 그대로 둡니다.

MCP로 작업할 때는 다음을 참고합니다.

처음에는 채널 지정 → 태스크 읽기(필요하면 답변까지) → 태스크 수정 또는 답변 추가 순서로 진행하면 됩니다.

상황별 요청 예시

태스크와 답변 아이디 확인하기

태스크와 답변 아이디를 확인하고 클립보드에 복사할 수 있습니다.

기본 작업 흐름

혼동을 줄이는 요청 방법

채널 지정하기

MCP로 태스크를 만들려면 채널 아이디를 지정해야 합니다. 다음처럼 명시적으로 지정할 수 있습니다.

다음 채널에서 작업하게 설정해줘. 71119da8c299e169

하지만 채널 아이디를 직접 지정하기보다 먼저 채널 목록을 읽은 뒤, 채널 이름으로 작업하는 방식을 권장합니다.

채널 목록을 읽어줘. 앞으로 매뉴얼웍스 6.0 채널에서 작업하게 해줘.

태스크

태스크 읽기

태스크를 읽을 때는 태스크 아이디를 명시해야 합니다.

다음 태스크를 읽어줘. 7a81162c9432d394

그리고 해당 내용을 구현해줘.

태스크의 답변까지 읽으려면 요청에 그 내용을 함께 적습니다.

다음 태스크를 답변까지 읽어줘. 7a81162c9432d394

태스크 만들기

태스크를 만들 때는 먼저 채널을 지정해야 합니다.

지금까지 내용을 정리해서 새로운 태스크를 만들어줘.

태스크 수정하기

태스크를 수정하려면 태스크 아이디를 명시합니다. 대화 중에 방금 만든 태스크가 있으면 태스크 아이디를 따로 적지 않고 진행할 수도 있습니다.

답변

답변 만들기

답변을 추가할 태스크 아이디를 명시합니다.

다음 태스크(604caa9f5100766f)에 답변을 추가해줘.

이 태스크와 관련해서 지금 진행한 내용을 간략하게 정리해줘.

답변 수정하기

답변을 수정할 때는 답변 아이디를 명시합니다.

예) 다음 답변(f7eed753fd4e96f8)을 정리해줘.

마일스톤 설정

먼저 마일스톤 목록을 조회합니다.

마일스톤을 읽어줘.

그리고 태스크 아이디를 명시한 후 마일스톤을 추가하거나 삭제합니다. 마일스톤 추가와 삭제를 동시에 진행할 수도 있습니다.

다음 태스크(7a81162c9432d394)에 오늘 할 일 마일스톤을 추가하고 이번 달에 할 일 마일스톤을 제거해줘.

카테고리 설정

먼저 카테고리 목록을 조회합니다.

카테고리를 읽어줘.

그리고 태스크 아이디를 명시한 후 카테고리를 추가하거나 제거합니다. 추가와 제거를 동시에 진행할 수도 있습니다.

다음 태스크(7a81162c9432d394)에 버그 카테고리를 붙이고 열림 카테고리를 떼줘.

관련 태스크 연결

태스크 사이의 관계를 설정합니다. 관계는 다음 세 가지입니다.

관계

관련

두 태스크가 서로 관련이 있습니다.

선행

기준 태스크를 상대 태스크보다 먼저 처리합니다.

후행

기준 태스크를 상대 태스크 다음에 처리합니다.

태스크 아이디를 명시하고 어느 태스크를 기준으로 어떤 관계인지 함께 요청합니다. 연결과 해제를 동시에 진행할 수도 있습니다.

다음 태스크(7a81162c9432d394)를 먼저 처리하고 604caa9f5100766f 태스크를 그다음에 처리하도록 연결해줘.

다음을 참고합니다.

필터로 태스크 목록 읽기

태스크 화면에서 만든 필터로 태스크 목록을 읽습니다. 필터 이름으로 요청하면 필터 목록을 조회해 찾습니다.

"내가 담당자인 태스크" 필터의 태스크를 보여줘.

목록에는 태스크 아이디와 제목만 담깁니다. 내용이 필요하면 이어서 태스크를 읽어 달라고 요청합니다.

다른 채널로 옮기기

태스크를 다른 채널로 옮깁니다. 화면에서 옮길 때와 같은 규칙을 따릅니다.

다음 태스크(7a81162c9432d394)를 매뉴얼웍스 7.0 채널로 옮겨줘.

메일 채널의 태스크에 답하기

메일 채널로 들어온 태스크도 다른 태스크처럼 읽고 답변을 등록할 수 있습니다. MCP로는 메일을 보내지 않습니다. AI가 등록한 답변을 확인한 뒤 태스크 화면에서 “메일로 보내기”를 눌러 고객에게 보냅니다.

다음 태스크(7a81162c9432d394)를 읽고 사용자 가이드에서 근거를 찾아 답변 초안을 남겨줘.

메일로 받은 태스크의 제목과 설명, 메일로 받거나 보낸 답변은 MCP로도 고칠 수 없습니다. 태스크와 답변은 작성한 사용자만 고칠 수 있습니다.

작업한 AI 도구 이름 남기기

MCP로 만들거나 고친 태스크와 답변은 작성자 뒤에 @mcp가 붙습니다. AI 도구 설정에 X-MCP-Client 헤더를 넣으면 @claude-code처럼 도구 이름이 붙습니다. 자세한 사항은 작업한 AI 도구 이름 남기기를 참고합니다.

메모 남기기

답변 대신 자신만 보는 메모를 남기려면 메모라고 요청합니다.

다음 태스크(7a81162c9432d394)에 지금까지 살펴본 내용을 메모로 남겨줘.