gdc-claude-plugin
This server provides a comprehensive integration with the GDC project management platform, enabling Claude to manage tasks, documents, notifications, and suggestions via MCP tools. Capabilities include:
Authentication & Context: Browser-based OAuth login, workspace/project context switching, and browsing available workspaces, projects, customers, and project enums.
Task Management: Query tasks (my tasks, listing, searching with filters), view details (subtasks, related, metadata), create, update (partial edits, minimal description edits), lifecycle operations (archive, soft-delete, restore, trashed list), and open tasks in browser.
Document Integration: Create or link tasks to documents, and synchronize document phase/checkbox progress to task status/dates.
Collaboration: Comments on tasks with @mentions, notifications across workspaces, and browsing mentions.
Suggestions: Submit and track feature requests/bugs.
Validation & Automation: Enforces constraints, auto-completes done tasks, and converts plain text to rich HTML.
Provides authentication via browser handoff using Google login for the GDC service.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gdc-claude-plugin Show my open tasks."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gdc-claude-plugin
Claude Code(및 Claude Desktop)에서 GDC(gdc-service) 를 쓰기 위한 플러그인이다. MCP 도구 + 슬래시 커맨드 + 진행률 자동 동기화 훅을 한 번에 설치한다. 기본 연결 대상은 운영 서버 https://gdc.gemiso.com.
📘 사용 안내서 — https://seonmikii.github.io/gdc-claude-plugin/ 설치부터 일상적인 사용까지 화면과 예시로 안내한다. Claude Code / Claude Desktop 탭 전환, 한국어·English 지원. 처음 쓴다면 여기부터.
구성 요소
MCP 서버(
gdc-local, stdio) — 태스크 조회/생성/수정, 태스크 숨기기·삭제·복구, 태스크 댓글, 작업 요청 문서 연동, 진행률 동기화, GitHub PR 연결, 건의사항 제출 등 도구 34종. (Claude Code·Desktop 공통)슬래시 커맨드 13종 —
/gdc-login/gdc-switch/gdc-my-tasks/gdc-tasks/gdc-task/gdc-task-new/gdc-task-from-doc/gdc-doc-from-task/gdc-link-task/gdc-apply/gdc-sync/gdc-suggest/gdc-update. (Claude Code 전용)PostToolUse 훅 —
docs/requests/**/*.md편집 시 연결된 태스크 진행률 자동 동기화. (Claude Code 전용)
Related MCP server: claude-code-mcp
전제조건
uv설치 (MCP 서버를uv run으로 기동). https://docs.astral.sh/uv/Python 3.13+ (uv가 자동 관리).
Claude Code에서 사용
설치 (각 사용자가 자기 PC에서 1회)
마켓플레이스 추가와 설치는 사용자별 설정(~/.claude)이라, 팀원 모두 각자 한 번씩 실행해야 한다.
# 1) 마켓플레이스 추가 (사용자당 1회)
/plugin marketplace add seonmikii/gdc-claude-plugin
# 2) 플러그인 설치
/plugin install gdc-claude-plugin@gdc-marketplace
# 3) 적용
/reload-plugins # 또는 Claude Code 재시작적용 후 /mcp 또는 /plugin에서 gdc-local이 ✓ Connected로 뜨면 정상.
업데이트 (새 버전 반영)
/gdc-update터미널 CLI·VSCode 확장 모두 동작한다(환경을 감지해 알아서 분기한다). 실행 후 Claude Code를 재시작해야 반영된다.
설치/업데이트가
EBUSY: resource busy or locked로 막히면, 실행 중인 MCP 서버가 캐시 폴더를 점유한 것이다. 플러그인을 Disable 후 재설치하거나, Claude Code를 완전 재시작한 뒤 다시 실행한다.
인증 (브라우저 핸드오프)
/gdc-login브라우저 창이 열리면 평소처럼 로그인(Google·로컬 모두 가능)하고 워크스페이스/프로젝트를 선택한 뒤 "연결 허용"을 누른다.
인증 토큰은
~/.gdc-mcp/credentials.json에 저장된다(사용자 단위 공유, 커밋 금지).선택한 워크스페이스/프로젝트는 현재 레포(폴더)에만 적용된다 → 레포마다 한 번씩
/gdc-login하면 레포별로 다른 프로젝트를 쓴다.콜백은
127.0.0.1loopback + 1회용 state로 한정된다.
슬래시 커맨드
커맨드 | 설명 |
| 브라우저 핸드오프 인증/재인증 (워크스페이스·프로젝트 선택) |
| 현재 레포의 워크스페이스/프로젝트 전환(재인증 없이) |
| 내 미해결 태스크 조회(선택 프로젝트 기준) |
| 특정 담당자(이름 또는 id)의 태스크 조회 |
| 태스크 상세 조회(하위·연관·상위 태스크 포함) |
| 새 태스크 생성(선택 목록·한글·담당자 자동) |
| 작업 요청 문서로 태스크 생성 |
| 태스크로 작업 요청 문서 생성·연동 |
| 기존 태스크를 기존 문서와 연동 + 문서 내용 반영(선택) |
| 문서 변경을 태스크 본문/댓글/하위 태스크에 반영(분류→라우팅) |
| 문서 진행률을 연결된 태스크에 강제 동기화 |
| 건의사항 제출 / 내 건의 목록 / 답변 확인 |
| gdc-marketplace 갱신 후 플러그인 최신 버전으로 승격 |
Claude Desktop에서 사용
Claude Desktop은 플러그인/마켓플레이스/슬래시 커맨드/훅을 지원하지 않는다. 대신 MCP 서버를 직접 등록하면 아래 도구와 프롬프트(슬래시 커맨드 대응)를 모두 쓸 수 있다.
레포를 로컬에 클론한다.
git clone https://github.com/seonmikii/gdc-claude-pluginClaude Desktop 설정 파일에 MCP 서버를 추가한다.
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "gdc-local": { "command": "uv", "args": ["run", "--directory", "<클론 경로>/gdc-claude-plugin", "python", "-m", "gdc_mcp.server"], "env": { "GDC_BASE_URL": "https://gdc.gemiso.com", "GDC_WEB_URL": "https://gdc.gemiso.com" } } } }Claude Desktop을 재시작한다. 인증은 대화창에서
gdc_login프롬프트(입력창 "+" 메뉴)를 실행하거나 "gdc 로그인"이라고 요청한다.
Desktop에서는 진행률 자동 동기화 훅과
/gdc-*슬래시 커맨드는 동작하지 않는다. 동일 기능을 MCP 프롬프트 12종(gdc_login/gdc_switch/gdc_my_tasks/gdc_tasks/gdc_task/gdc_task_new/gdc_task_from_doc/gdc_doc_from_task/gdc_link_task/gdc_apply/gdc_sync/gdc_suggest)으로 "+" 메뉴에서 호출할 수 있고, 진행률 동기화는sync_doc_progress(또는gdc_sync프롬프트)로 수동 실행한다.※
/gdc-update는 플러그인 CLI(마켓플레이스) 관리 커맨드라 대응 MCP 프롬프트가 없다. Desktop은 플러그인 개념이 없어(MCP 서버를 직접 등록)git pull로 최신 코드를 받아 Desktop을 재시작하면 반영된다.
MCP 도구 (Code·Desktop 공통)
자연어로 요청하면 Claude가 아래 도구를 호출한다("내 태스크 보여줘", "김철수 담당 태스크 조회해줘" 등).
도구 | 설명 |
| 브라우저 핸드오프로 MCP 전용 토큰 발급, 워크스페이스/프로젝트를 레포별 저장 |
| 현재 레포에 적용되는 워크스페이스/프로젝트 확인 |
| 현재 레포의 워크스페이스/프로젝트 전환(재인증 없이) |
| 접근 가능한 워크스페이스 목록 |
| 지정 워크스페이스의 프로젝트 목록 (종료된 프로젝트 제외) |
| 프로젝트에 지정 가능한 고객사 목록 |
| 프로젝트별 status/priority/task_type/members(담당자·관련자 후보) |
| 내(담당/작성/참여) 미해결 태스크 — |
| 특정 담당자(이름 또는 id)의 태스크 — 동일 필터 |
| 현재 프로젝트 키워드·다중 필터 검색(상태/우선순위/유형/담당자/관련자/고객사/종료일 범위). 완료 태스크도 기본 포함, 결과는 번호 내림차순(관련도순 아님) |
| 태스크 생성(담당자 기본=본인, 날짜·멤버 입력 검증, 완료 상태면 진행률·실제 종료일 자동 보정). 상태/우선순위/유형은 생략 시 프로젝트 enum 기준 기본값(WBS형은 |
| 태스크 부분 수정(날짜 순서·미래·멤버 검증, 상태/우선순위/유형은 프로젝트 enum 대조 후 차단). 본문은 같은 라벨 섹션 템플릿 — 통째 교체이므로 부분 수정은 |
| 태스크 본문 최소 편집 — |
| 태스크 상세 조회(하위·연관·상위 태스크 + 실제 날짜·고객사·비중·관련자·태그·댓글 수 등 수정 가능 필드 포함). 저장값이 프로젝트 enum에 없으면 |
| 태스크 웹 화면을 Chrome 새 탭으로 열기 |
| 태스크에 붙일 수 있는 GitHub PR 후보 조회(GitHub 실시간) + 연결 가능 레포 목록. 조회 실패 레포는 사유와 함께 |
| GitHub PR을 태스크에 연결 — |
| 태스크의 PR 연결 해제 — 자동 연결( |
| 작업 요청 문서로 태스크 생성 + 문서 frontmatter에 연동 기록(완료 상태면 진행률·실제 종료일 자동 보정) |
| 기존 태스크를 기존 문서와 연동(새로 만들지 않음) |
| 문서의 Phase/체크박스 진척을 연결된 태스크 진행률·상태·날짜에 동기화( |
| 태스크 댓글(Mention) 목록 조회 |
| 태스크 댓글 작성(멘션 지원 — 본문 선두에 하이라이트 멘션 삽입, 알림 발송) |
| 태스크 댓글 수정( |
| 태스크 댓글 삭제 |
| 태스크 숨기기/해제 토글(하위 일괄 처리, WBS 불가, |
| 태스크 삭제 — 소프트 삭제(휴지통 이동, 복구 가능, 관리자 이상, |
| 휴지통 태스크 복구(관리자 이상, |
| 현재 프로젝트 휴지통(삭제된 태스크) 목록 — 복구 대상 식별 |
| 내 알림 목록(멘션·댓글·담당자 변경 등) + 미읽음 수 — 조회 전용, 전 워크스페이스 혼재 |
| 나와 관련된 댓글 멘션 목록( |
| GDC·플러그인 건의사항 제출(버그/기능 요청/개선 제안/기타) — 워크스페이스·프로젝트 무관, 컨텍스트 불필요 |
| 내가 제출한 건의사항 목록(상태·분류 필터) — 답변 여부( |
| 건의사항 상세 — 본문 + 관리자 답변 + 답변자·답변 시각 |
본문·댓글 자동 링크(v0.6.x): 평문으로 넘긴 태스크 본문·댓글은 HTML로 변환될 때 ① http(s):// URL과 ② 같은 프로젝트의 태스크 언급 #번호가 자동으로 링크된다(#409 → 해당 태스크 페이지 + 뒤에 (제목) 표시). 현재 프로젝트에 없는 번호·숨김 태스크는 평문 그대로 두고, 색상 코드(#fff)나 URL 프래그먼트는 링크하지 않는다. 이미 HTML로 넘긴 본문은 변환 없이 통과하므로 자동 링크도 적용되지 않는다.
입력 규칙(참고): 담당자/관련자는 user id 또는 멤버 이름(자동 id 해석, 비멤버면 멤버 목록 안내). 날짜는 YYYY-MM-DD이며 예상/실제 시작일 ≤ 종료일, 실제 종료일은 미래 불가(미충족 시 안내·차단). 완료 계열 상태(category=='done')로 태스크를 생성하면 진행률 100%·실제 종료일=오늘이 자동 주입된다.
로컬 개발 override
기본 연결은 운영 서버다. 로컬 gdc-service로 붙이려면 환경변수로 덮어쓴다(.env.example 참고). Code는 플러그인 .mcp.json의 env, Desktop은 위 설정의 env를 바꾸면 된다.
GDC_BASE_URL=http://localhost:8000
GDC_WEB_URL=http://localhost:5173주의
인증은 브라우저 핸드오프 전용이다(username/password 자동 로그인 없음).
토큰·시크릿은 저장 파일·메모리로만 다루며 커밋·로그에 노출하지 않는다.
기본 연결(운영)은 HTTPS다. dev 서버(
http://se.gemiso.com:11521)로 override 시 HTTP(평문) — 토큰 평문 전송 위험은 인지된 상태이며 별도 보완(후속) 대상이다.
Available Tools
28 toolsadd_task_commentA
태스크에 댓글(멘션)을 작성한다. 필수: task_id, content(본문).
content는 평문으로 넘기면 GDC 리치텍스트(HTML)로 변환해 저장한다(이미 HTML이면 통과). mentions에 멤버 이름 또는 user id 리스트를 주면 각 멤버를 해석해 본문 맨 앞에 하이라이트 멘션 한 줄(GDC 에디터와 동일한 멘션 노드 — 화면에 볼드+강조색으로 표시)을 붙인다 → 서버가 이를 파싱해 멘션 알림을 발송한다. (멘션은 본문 선두에만 배치되며, 본문 중간 커서 위치 삽입은 지원하지 않는다.) 비멤버를 멘션하면 가능한 멤버 목록과 함께 오류로 안내한다.
Inputs: content (required), task_id (required), mentions. Returns: object
archive_taskA
태스크를 숨기거나(archived=True) 숨김 해제한다(archived=False). 토글 API를 멱등 래핑한다.
task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다. 숨기면 모든 하위 태스크가 함께 숨김되고 고정(pin)은 자동 해제된다. WBS 프로젝트는 숨김 기능을 지원하지 않는다(안내). 숨김 해제는 상위가 숨김 상태면 막힌다(먼저 상위 숨김 해제).
확인 게이트: confirm=False(기본)면 대상과 현재/목표 상태만 미리보기로 반환하고 실행하지 않는다. confirm=True로 다시 호출해야 실제로 토글한다. 이미 원하는 상태면 호출 없이 그대로 둔다(멱등).
Inputs: task_id (required), confirm, archived. Returns: object
create_taskA
태스크를 생성한다. 필수: project(프로젝트 ID), title.
[입력 수집 권장 흐름 — Desktop·Code 공통] 호출 전에 사용자에게 컬럼을 선택지로 하나씩 물어보고 고른 값을 넘긴다:
get_context로 현재 프로젝트 확인 → get_project_enums로 status/priority/task_type/members 조회.
제목·내용(description)·예상 시작/종료일만 자유 입력으로 받는다.
status/priority/task_type/관련자는 **선택 질문(AskUserQuestion)**으로 제시 — 보기는 한글 label, 각 질문에 반드시 "건너뛰기" 포함(실제 값 최대 3개, 나머지는 "기타"로). 고른 값의 name(관련자는 user id)을 넘긴다.
담당자(assignee)는 묻지 않는다(생략 시 로그인 사용자로 자동 등록 = 작성자와 동일).
[description — 라벨 섹션 템플릿(평문)]
본문은 평문 한 문단으로 넣지 말고 아래 템플릿으로 작성해 넘긴다. 도구가 GDC 리치텍스트(HTML)로
변환한다(라벨→볼드 문단, -→목록, 섹션 사이 빈 문단).
[요약]
요청 내용 한두 줄 요약
[AS-IS] ← 선택(TO-BE와 짝): 구현 전 상황이 실제로 드러날 때만
구현 전 상황
[TO-BE] ← 선택(AS-IS와 짝)
구현 후 상황
[작업 내용]
- 실제 산출물 단계를 블렛(`-`)으로 한 줄씩
※ [요약]·[작업 내용]=필수, [AS-IS]/[TO-BE]=선택(짝) — 전/후 상황이 불명확하면 생략(추측·빈말 금지).
※ 체크박스 표시([ ]/[x])는 넣지 않는다(진행 상태는 progress 필드가 담당).
※ 빌드·타입체크·검증·테스트·lint·커밋·배포·버전 범프·'INDEX.md 이력 추가' 같은
프로세스 메타 단계는 넣지 않는다(실제 산출물 단계만).
※ 이미 HTML(태그로 시작)을 넘기면 변환 없이 그대로 저장된다.
값 형식: status/priority/task_type은 해당 프로젝트 enum의 'name', 날짜는 'YYYY-MM-DD'. assignee·participant_ids는 user id 또는 멤버 이름(full_name/username)을 넘기면 자동으로 id로 해석한다.
확장 필드(사용자가 명시할 때만 전달 — 질문으로 강요하지 않음): parent(상위 태스크 id), customer(고객사 id 또는 이름 — 이름은 현재 워크스페이스에서 자동 해석, 모호하면 후보 안내), actual_start_date/actual_end_date, progress(0~100), weight(비중 % — WBS 프로젝트 전용, 비WBS는 호출 전 차단. 형제 그룹 비중 합 100 초과는 서버가 검증).
태그는 지정할 수 없다 — 서버가 태스크의 태그를 본문·댓글의 tagMention에서만 동기화하므로 태그 id를 보내도 무시된다(읽기는 get_task의 tags로 가능).
제약(미충족 시 호출 전 ValueError로 안내·차단): 예상/실제 시작일 ≤ 종료일, 실제 종료일 미래 불가, 담당자/관련자는 해당 프로젝트 멤버만 지정 가능.
완료 보정: status가 완료 계열(category=='done')이면 progress=100·실제 종료일=오늘을 자동 주입한다 (progress/actual_end_date를 직접 전달한 경우 그 값이 우선).
Inputs: title (required), project (required), parent, status, +12 more. Returns: object
delete_taskA
태스크를 삭제한다(소프트 삭제 → 휴지통 이동, 복구 가능). 관리자 이상 권한 필요.
task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다. 하위 태스크 처리: WBS 프로젝트는 하위 전체 연쇄 삭제, 비WBS는 직속 하위를 최상위로 승격 후 본체만 삭제한다(손자는 승격된 부모 밑 유지). 복구는 restore_task, 목록은 list_trashed_tasks.
확인 게이트: confirm=False(기본)면 삭제 대상과 하위 영향만 미리보기로 반환하고 삭제하지 않는다. confirm=True로 다시 호출해야 실제 삭제한다.
Inputs: task_id (required), confirm. Returns: object
delete_task_commentA
댓글(멘션)을 삭제한다. 본인이 작성한 댓글만 삭제 가능(아니면 오류).
Inputs: comment_id (required). Returns: object
edit_task_descriptionA
태스크 본문(description)을 통째 덮어쓰지 않고 최소 편집한다(인라인 이미지 보존).
본문을 재구성해 통째로 PATCH하면 <img data-attachment-id> 인라인 이미지가 유실된다.
이 도구는 현재 본문 HTML을 받아 필요한 부분만 편집해 PATCH하므로 편집 대상 밖 이미지가
자동 보존된다. 반영(문서→태스크) 흐름에서 추가 작업/내용 변경을 본문에 적용할 때 쓴다.
mode:
"append_work":
[label](기본 '작업 내용') 섹션 목록에 bullets를<li>로 추가한다 (섹션/목록이 없으면 신설). 기존 내용·이미지 100% 보존. bullets 필수."replace_section":
[label]섹션 본문만 new_body_html로 교체한다(라벨 문단·타 섹션 보존). 섹션에 인라인 이미지가 있으면 keep_media=True(기본)는 이미지를 섹션 끝으로 옮겨 보존, keep_media=False는 함께 삭제. new_body_html 필수(라벨 문단 제외한 본문 HTML).
task_id는 id(정수) 또는 제목(문자열). 편집 결과가 현재와 같으면 PATCH하지 않고 그대로 반환.
Inputs: mode (required), task_id (required), label, bullets, +2 more. Returns: object
gdc_loginA
브라우저 핸드오프(A안)로 MCP 전용 토큰을 발급받고, 선택한 워크스페이스/프로젝트를 현재 레포(루트)별로 저장한다.
브라우저 창이 열리면 평소처럼 로그인(Google·로컬 모두 가능)한 뒤 '연결 허용'을 누른다. 인증 토큰은 사용자 단위로 공유되고, 워크스페이스/프로젝트는 이 레포에만 적용된다. → 레포마다 한 번씩 gdc_login하면 레포별로 다른 프로젝트를 자동으로 쓴다.
Inputs: no named parameters. Returns: object
get_contextA
현재 레포(루트)에 적용되는 워크스페이스/프로젝트 컨텍스트를 반환한다.
create_task/list 등에서 어떤 프로젝트가 쓰일지 확인하는 용도. roots 미지원 환경에서는 글로벌 fallback 값을 반환한다.
Inputs: no named parameters. Returns: object
get_project_enumsA
프로젝트별 커스텀 status/priority/task_type enum을 조회한다.
status는 category(planned/in_progress/done)를 포함한다. 완료 상태 = category=='done', 미완료 상태 = 그 보집합. 태스크 생성/수정/필터 전에 유효한 값과 '미완료 집합'을 확인하는 용도.
Inputs: project_id (required). Returns: object
get_taskA
태스크 상세를 조회한다(작업 요청 문서 생성·연동용).
task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다(정확 1건이면 채택, 다수면 후보 안내, 0건이면 오류).
제목/내용/상태/우선순위/유형/날짜/진행률/담당자 등 문서 작성에 필요한 필드와 함께 상위 태스크(parent)·하위 태스크(sub_tasks)·연관 태스크(related_tasks) 를 반환한다.
sub_tasks: 이 태스크의 하위 태스크 요약 목록(휴지통 제외, 서버 가시성 필터 적용).
related_tasks: outgoing/incoming 링크를 방향 유지로 통합({direction, link_type, task}).
parent: 직속 상위 태스크 요약(없으면 null).
update_task로 쓸 수 있는 값도 함께 읽는다 — actual_start_date/actual_end_date(실제 날짜), customer/customer_name(고객사), weight(비중, WBS 전용), is_pinned(고정), participants(관련자). 수정 전 현재 값 확인과 수정 후 반영 확인에 쓴다.
그 밖에 creator_name(작성자)·tags(태그 이름)·mention_count(댓글 수)·is_archived(숨김)· created_at/updated_at을 함께 반환한다. 상세 API 1회 호출로 모두 받으므로 추가 왕복이 없다(제목 해석 시 검색 1회 추가).
Inputs: task_id (required). Returns: object
link_task_to_docA
기존 태스크를 기존 작업 요청 문서와 연동한다.
문서 frontmatter에 task_id/task_url을 기록(upsert)하므로, 이후 sync_doc_progress·훅이 이 문서의 Phase/체크박스 진행률을 해당 태스크에 동기화한다. (새 태스크를 만들지 않음)
Inputs: task_id (required), doc_path (required). Returns: object
list_customersA
현재 레포 컨텍스트 워크스페이스의 고객사 목록을 조회한다.
create_task/update_task의 customer를 이름으로 지정하기 전에 후보를 확인하는 용도. search를 주면 이름·대표자·담당자 이름으로 부분 검색한다(생략 시 전체). 반환된 id 또는 name을 customer 인자로 넘기면 된다.
권한(고객사 열람) 없는 워크스페이스는 서버가 빈 목록을 주므로 count=0이면 고객사가 없거나 열람 권한이 없는 것이다.
Inputs: search. Returns: object
list_my_mentionsA
나와 관련된 댓글 멘션 목록을 최신순으로 조회한다(조회 전용).
알림(list_my_notifications)과 달리 댓글 본문을 훑는 용도다 — 어떤 태스크에서 무슨 이야기가 오갔는지 확인할 때 쓴다.
mention_type: 'mentioned'(나를 언급한 것)/'authored'(내가 쓴 것)/'both'(기본).
스코프: 현재 레포 컨텍스트의 워크스페이스 + 프로젝트를 기본 적용한다. project_id를 직접 주면 그 프로젝트로 바꿔 조회한다.
date_from/date_to: 작성일 범위(YYYY-MM-DD). search: 댓글 본문 부분 일치.
preview는 서버가 100자로 자른 조각을 평문화한 값이라 문장이 중간에서 끊길 수 있다. 전체 내용은 url이나 list_task_comments(task_id)로 확인한다.
Inputs: limit, search, date_to, date_from, +2 more. Returns: object
list_my_notificationsA
내 알림 목록을 조회한다(조회 전용 — 읽음 처리는 하지 않는다).
멘션·담당자 변경·댓글·상태 변경 등 나를 수신자로 하는 알림을 최신순으로 반환하고, 미읽음 총 개수(unread_count)를 함께 준다.
unread_only=True면 읽지 않은 알림만 조회한다.
limit은 최대 99(서버 상한). 그보다 많이 요청해도 99로 자른다.
워크스페이스/프로젝트 스코프가 없다 — 서버가 수신자 기준으로만 거르므로 다른 워크스페이스의 알림이 섞여 온다. 항목의 project_name으로 구분한다.
각 항목의 url로 get_task/open_task를 이어서 호출할 수 있다.
Inputs: limit, unread_only. Returns: object
list_my_tasksA
현재 사용자(assignee/creator/participant)의 태스크 목록을 조회한다.
조회 대상 프로젝트는 현재 레포에서 gdc_login으로 선택한 프로젝트(레포별 컨텍스트)로 고정된다. 그 프로젝트의 미완료 집합으로 서버측 필터링하므로 정확하다. 저장된 프로젝트가 없으면 부득이 mine 전체에서 클라이언트 필터링한다(첫 페이지만 보므로 누락 가능).
not_finished=True: 완료(category=='done')가 아닌 상태만
overdue=True: 계획 종료일이 지난 것만
undated=True: 계획 종료일이 없는(날짜 미정) 것만 (주간 싱크의 '날짜 미정'과 동일)
Inputs: limit, overdue, undated, not_finished. Returns: object
list_projectsB
지정 워크스페이스의 프로젝트 목록(전환용).
Inputs: workspace_id (required). Returns: object
list_task_commentsA
태스크의 댓글(멘션) 목록을 조회한다. 최신순 상위 limit개를 시간순(오래된→최신)으로 반환.
서버 페이지네이션(PAGE_SIZE=20, page_size 미지원)상 한 요청으로 최대 20개만 받는다 — limit>20을 줘도 20개까지만 반환된다(가장 최근 댓글 우선). count는 태스크의 전체 댓글 수.
각 댓글: id, author_name(작성자 실명), text(HTML을 벗긴 평문), is_edited(수정됨 여부), created_at.
Inputs: task_id (required), limit. Returns: object
list_tasksA
특정 담당자의 태스크를 현재 레포 프로젝트에서 조회한다.
assignee는 user id 또는 멤버 이름(full_name/username) — 자동으로 id로 해석한다. 조회 프로젝트는 현재 레포에서 gdc_login으로 저장한 프로젝트로 고정한다(미설정 시 오류). 필터는 list_my_tasks와 동일: not_finished(미완료만)/overdue(마감 지남)/undated(날짜 미정). "내" 태스크는 list_my_tasks를, 특정 담당자는 이 도구를 쓴다.
Inputs: assignee (required), limit, overdue, undated, +1 more. Returns: object
list_trashed_tasksA
현재 프로젝트 휴지통(삭제된 태스크) 목록을 조회한다. 복구(restore_task) 대상 식별용.
삭제된 태스크는 일반 조회(list_my_tasks/get_task)에서 빠지므로, 복구하려면 이 목록에서 id/제목을 확인한다. 각 항목에 삭제 시각(deleted_at)·삭제자(deleted_by)를 포함한다. 현재 레포 프로젝트로 스코프되며(project 명시 전송), 관리자 이상만 유효한 결과를 받는다. 한 요청으로 최대 100개까지 받아 최신 삭제순 상위 limit개를 반환한다(count는 전체 삭제 수).
Inputs: limit. Returns: object
list_workspacesA
현재 사용자가 접근 가능한 워크스페이스 목록(전환용).
Inputs: no named parameters. Returns: object
open_taskA
태스크 웹 화면을 Chrome 새 탭으로 연다.
목록에 표시되는 URL을 클릭하면 VSCode 내장 브라우저로 열릴 수 있으므로, 이 도구는 chrome.exe를 직접 실행해 항상 Chrome으로 연다(미설치 시 기본 브라우저).
Inputs: task_id (required). Returns: object
restore_taskA
휴지통의 삭제된 태스크를 복구한다. 관리자 이상 권한 필요.
task_id는 태스크 id(정수) 또는 제목(문자열) — 삭제 태스크는 일반 검색에서 빠지므로 현재 프로젝트 휴지통에서 제목을 매칭한다. 존재하지 않거나 삭제되지 않은 태스크는 안내한다.
주의: 첨부 파일은 함께 복구되지만 연쇄 삭제된 하위 태스크는 복구되지 않고 휴지통에 남는다 (단건 + 자기 첨부만 복구). WBS 태스크는 원래 부모 밑이 아니라 최상위로 분리되고 비중(weight)이 해제된 상태로 복구된다.
확인 게이트: confirm=False(기본)면 대상·부작용만 미리보기로 반환하고 복구하지 않는다. confirm=True로 다시 호출해야 실제 복구한다.
Inputs: task_id (required), confirm. Returns: object
search_tasksA
현재 레포 프로젝트에서 키워드·필터로 태스크를 검색한다.
조회 범위는 현재 레포에서 gdc_login/set_context로 선택한 프로젝트로 고정된다(미설정 시 오류). "내 태스크"는 list_my_tasks, "특정 담당자 태스크"는 list_tasks가 더 간단하다 — 이 도구는 키워드나 여러 조건을 조합할 때 쓴다.
query: 제목·본문·댓글(멘션) 통합 검색어. 생략 가능(필터만으로도 조회된다). 주의: 서버가 결과를 번호 내림차순(고정 태스크 우선)으로 재정렬하므로 관련도순이 아니다 — 매칭이 많으면 "가장 관련 있는 N건"이 아니라 "매칭 중 최신 N건"이 온다. 응답의 total_matched로 전체 매칭 수를 확인하고, 필요하면 필터를 좁히거나 limit을 올린다.
query는 root_only와 함께 쓸 수 없다(검색이 매칭한 하위 태스크가 통째로 걸러진다).
status/priority/task_type: 상태·우선순위·유형 이름 목록(합집합). 값은 get_project_enums 참고.
assignee/participant/customer: user id 또는 멤버 이름, 고객사 id 또는 고객사 이름 허용.
planned_end_from/planned_end_to: 계획 종료일 범위(YYYY-MM-DD).
not_finished: 완료(category=='done')가 아닌 상태만. status를 직접 주면 그 값이 우선한다. 기본값은 False라 완료된 태스크도 함께 나온다(끝난 태스크를 찾는 것도 검색의 목적이다). list_my_tasks/list_tasks는 반대로 미해결만 보는 도구라 기본값이 True다 — "미완료만" 검색하려면 not_finished=True를 명시해야 한다.
overdue: 계획 종료일이 지난 것만(서버 필터). not_finished와 독립이다.
undated: 계획 종료일이 없는 것만. 서버 필터가 없어 200건을 받아 거르므로, 200건을 넘는 프로젝트에서는 누락될 수 있다.
ordering: number/title/status/priority/progress/created_at/updated_at/planned_*/actual_* 중 하나 (내림차순은 '-' 접두, 예: '-planned_end_date'). 생략 시 서버 기본(번호 내림차순).
응답: count(반환 건수)·total_matched(서버 전체 매칭 수)·tasks(요약 목록).
Inputs: limit, query, status, overdue, +11 more. Returns: object
set_contextA
현재 레포의 워크스페이스/프로젝트를 전환한다(재인증 없이, 토큰 유지).
이미 로그인된 상태에서 작업 대상 프로젝트만 바꿀 때 사용한다.
Inputs: project_id (required), workspace_id (required). Returns: object
sync_doc_progressA
작업 요청 문서의 Phase 진척을 읽어 연결된 태스크 진행률·상태·실제 날짜를 동기화한다.
progress = 완료 Phase 수 / 전체 Phase 수 × 100 (한 Phase는 하위 체크박스가
전부 [x]일 때 완료). task_id 생략 시 문서 frontmatter의 task_id를 사용한다.
최초 진행 시 '진행'+실제 시작일, 100% 시 '완료'+실제 종료일로 자동 전이된다.
description 전달 시 진행률 PATCH에 태스크 본문(description)도 함께 반영한다 —
문서 본문이 수정됐을 때 호출 에이전트가 '[작업 내용]' 요약을 재생성해 넘기는 용도(자동 훅은 진행률 전용).
이때 본문은 create_task와 동일한 라벨 섹션 템플릿(평문) 으로 넘긴다 — [요약](필수) →
선택·짝인 [AS-IS]/[TO-BE] → [작업 내용](필수, - 블렛). 도구가 GDC 리치텍스트(HTML)로
변환하며(태그로 시작하는 HTML은 그대로 통과), 체크박스·프로세스 메타 단계는 넣지 않는다.
Inputs: doc_path (required), task_id, description. Returns: object
task_from_docA
작업 요청 문서로 태스크를 생성하고, 문서 frontmatter에 task_id/task_url을 기록한다.
제목: 문서의 첫 '# ' 헤딩에서 추출.
description(필수): 호출하는 에이전트가 아래 라벨 섹션 템플릿(평문)으로 작성해 전달한다. 도구가 GDC 리치텍스트(HTML)로 변환해 저장한다(라벨→문단, 블렛→목록, 섹션 사이 빈 문단). [요약] 문서 "요청 내용" 한두 줄 요약
[AS-IS] ← 선택(TO-BE와 짝): '요청 내용'·'배경'에서 구현 전 상황이 실제로 드러날 때만 구현 전 상황
[TO-BE] ← 선택(AS-IS와 짝) 구현 후 상황
[작업 내용]
작업 결과 단계를 블렛(
-)으로 간단히 요약 (각 단계 한 줄) ※ [요약]·[작업 내용]=필수, [AS-IS]/[TO-BE]=선택(짝). 전/후 상황이 불명확하면 생략(추측·빈말 금지) — 신규 기능·문서 작업엔 보통 빠진다. ※ 체크박스 표시([ ]/[x])는 넣지 않는다. 진행 상태는 태스크 progress 필드가 담당한다. ※ 빌드·타입체크·검증·테스트·lint·커밋·배포/동작 확인·'INDEX.md 이력 추가' 같은 프로세스 메타 단계는 넣지 않는다(실제 산출물 단계만). 넣더라도 도구가 자동 제거한다.
status: 생략 시 문서 메타데이터 표의
상태를 보고 매핑한다 — done → '완료'(완료/closed 계열), partial → '진행'(in_progress). 그 외 값은 자동 매핑하지 않고 기본 상태로 둔다. status 인자를 주면 그 값이 우선한다.완료 보정: 최종 status가 완료 계열(category=='done')이면 progress=100·실제 종료일=오늘을 자동 주입한다.
task_type: 호출하는 에이전트가 문서 유형/본문을 근거로 프로젝트 enum에 맞춰 매칭해 전달한다(get_project_enums 참고).
project: 생략 시 현재 레포에서 gdc_login으로 저장한 프로젝트(레포별 컨텍스트)를 사용.
담당자(assignee): 항상 로그인 사용자로 자동 등록(create_task와 동일).
Inputs: doc_path (required), description (required), status, project, +2 more. Returns: object
update_taskA
태스크를 부분 수정(PATCH)한다. 전달한 필드만 갱신된다.
[description — 라벨 섹션 템플릿(평문)]
본문을 교체할 때는 평문 한 문단이 아니라 create_task와 동일한 라벨 섹션 템플릿으로 넘긴다:
[요약](필수) → 선택·짝인 [AS-IS]/[TO-BE] → [작업 내용](필수, - 블렛 한 줄씩).
도구가 GDC 리치텍스트(HTML)로 변환한다(이미 태그로 시작하는 HTML이면 그대로 통과).
체크박스([ ]/[x])와 빌드·검증·테스트·커밋·배포·버전 범프 같은 프로세스 메타 단계는 넣지 않는다.
※ 이 도구는 본문을 통째로 교체한다 — 일부 섹션만 고치거나 블렛만 덧붙일 때는
edit_task_description(replace_section/append_work)을 써서 인라인 이미지 유실을 막는다.
사용자가 수정 권한을 가진 모든 편집 필드를 노출한다(읽기전용 id/number/creator 제외). status/priority/task_type은 해당 프로젝트 enum 'name'(get_project_enums로 확인), 날짜는 'YYYY-MM-DD', parent는 ID. 태그는 수정할 수 없다 — 서버가 본문·댓글의 tagMention에서만 태그를 동기화한다(읽기는 get_task). assignee·participant_ids는 user id 또는 멤버 이름(full_name/username)을 넘기면 자동으로 id로 해석한다. customer는 고객사 id 또는 이름 — 이름은 현재 워크스페이스에서 검색해 정확 일치를 자동 채택, 모호하면 후보 목록으로 안내한다. weight(비중 %)는 WBS 프로젝트 전용 — 비WBS 태스크에 전달하면 호출 전 차단. parent 변경 시 서버가 weight를 자동 초기화한다(weight를 함께 전달하면 그 값 적용). 완료 상태(category=='done')로 전환하면 백엔드가 progress=100·actual_end_date를 자동 보정할 수 있다.
필드 해제(비우기): clear_fields에 필드명 리스트를 전달 — 가능: parent, assignee, customer, planned_start_date, planned_end_date, actual_start_date, actual_end_date, weight. 예) 실제 종료일 비우기 → clear_fields=["actual_end_date"], 고객사 해제 → clear_fields=["customer"]. 같은 필드에 값과 해제를 동시에 전달하면 오류. 관련자 전체 해제는 participant_ids=[].
제약(미충족 시 ValueError로 안내·차단): 예상/실제 시작일 ≤ 종료일, 실제 종료일은 미래 불가, 담당자/관련자는 해당 프로젝트 멤버만 지정 가능.
Inputs: task_id (required), title, parent, status, +14 more. Returns: object
update_task_commentA
댓글(멘션) 본문을 수정한다. 본인이 작성한 댓글만 수정 가능(아니면 오류).
주의: 서버가 새 content로 멘션을 다시 파싱해 덮어쓴다. 기존 멘션을 유지하려면 mentions 인자로 함께 넘겨야 하며, mentions 없이 수정하면 이전 멘션 알림 대상이 사라진다. mentions는 add_task_comment와 동일하게 본문 선두 하이라이트 멘션 한 줄로 삽입된다 (이미 멘션된 사용자에게 중복 알림은 가지 않는다 — 서버가 신규 멘션 델타만 발송). content는 평문→HTML 자동 변환(이미 HTML이면 통과).
Inputs: content (required), comment_id (required), mentions. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Each tool has a clear primary purpose, and potentially overlapping tools like list_my_tasks, list_tasks, and search_tasks are explicitly differentiated in their descriptions. Some pairs (list_my_notifications vs list_my_mentions) are similar but serve distinct use cases.
Most tool names follow a verb_noun pattern (list_*, get_*, update_*, delete_*), but there are inconsistencies such as 'task_from_doc' (noun-first), 'gdc_login' (prefix + verb), and 'link_task_to_doc' (verb + object + preposition). This breaks a fully predictable naming scheme.
With 28 tools, the count exceeds the 'heavy' threshold of 25, making selection more difficult. Although the scope is broad (workspaces, projects, tasks, comments, notifications, docs), several tools are close variants of task listing/filtering and could be consolidated.
The tool set covers the full task lifecycle (create, read, update, delete, restore, archive), comments (list, add, update, delete), notifications (read-only), and document integration (link, create, sync). No critical operations are missing for the domain.
Maintenance
Related MCP Connectors
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Share one project context across ChatGPT, Claude, Telegram and any MCP client.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Share context and questions between Claude instances — VS Code, claude.ai web, and mobile.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThe self-hosted MCP bridge between Claude Chat and Claude Code.46AGPL 3.0
- AlicenseAqualityDmaintenanceWraps Claude Code as tools for MCP clients, enabling autonomous coding tasks via a 4-tool lifecycle with session management, async polling, and permission controls.493 npm21MIT
- AlicenseAqualityCmaintenanceAn MCP server that bridges Claude Desktop with Claude Code, allowing users to delegate tasks to Claude Code directly from Claude Desktop conversations, supporting both synchronous and background execution with session reuse.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables voice assistants to start, monitor, message, and approve local Claude Code sessions on your computer, including sessions already open in a terminal. It exposes session management, recaps, approvals, and history search as MCP tools.8GPL 3.0