GDC MCP 플러그인 사용 안내서

사용하는 앱을 먼저 고르세요. 설치 절차·명령·화면 등 안내 전체가 선택한 환경에 맞춰 바뀝니다.

항목	Claude Code	Claude Desktop
무엇인가	터미널에서 실행하는 CLI, 또는 VS Code 확장	단독 실행하는 Claude 데스크탑 앱
설치 방식	마켓플레이스 — 대화창에 커맨드 3줄	설정 파일에 MCP 서버 직접 등록
MCP 도구 31종	○	○
슬래시 커맨드 13종	○	× — 프롬프트 12종으로 대체
진행률 자동 동기화 훅	○	× — `gdc_sync` 프롬프트로 수동
레포 파일 접근	있음 — 열어둔 폴더 안에서 동작	제한적 — 작업 요청 문서 연동은 어려움

바로 시작하기

설치부터 연결 확인까지 네 단계입니다. 커맨드를 클릭하면 복사됩니다.

1 uv 확인 uv --version
2 설치 /plugin marketplace add seonmikii/gdc-claude-plugin /plugin install gdc-claude-plugin@gdc-marketplace /reload-plugins
3 인증
/gdc-login 브라우저에서 로그인 → 워크스페이스·프로젝트 선택 → 「연결 허용」
4 연결 확인
/mcp plugin:gdc-claude-plugin:gdc-local 이 ✓ Connected 로 뜨면 완료

이후로는 GDC에서 하던 태스크 작업을 그대로 요청하면 됩니다 — “이번주에 해야 하는 태스크 조회”, “315번 태스크 완료로 변경”.

바로 시작하기

Claude Desktop에는 플러그인 마켓플레이스가 없어서 MCP 서버를 직접 등록합니다. 설정 파일에 한 번만 넣으면 됩니다.

1 uv 확인 uv --version
2 레포 클론 git clone https://github.com/seonmikii/gdc-claude-plugin
3 서버 등록
Claude 데스크탑 앱 설정에서 「Developer」 → 「Edit Config」 로 설정 파일을 열고 gdc-local 항목을 추가합니다. 전체 JSON은 1-2에 있습니다. 넣은 뒤 앱을 재시작합니다.
4 인증
입력창 "+" 메뉴에서 gdc_login 프롬프트를 실행하고 브라우저에서 로그인합니다.

이후로는 GDC에서 하던 태스크 작업을 그대로 요청하면 됩니다 — “이번주에 해야 하는 태스크 조회”, “315번 태스크 완료로 변경”.

구성	내용
MCP 서버	`gdc-local` (stdio) · 도구 31종 · Code·Desktop 공통
슬래시 커맨드	13종 · Claude Code 전용
프롬프트	12종 · 입력창 "+" 메뉴에서 실행
훅	작업 요청 문서 저장 시 진행률 동기화 · Claude Code 전용
연결 대상	`https://gdc.gemiso.com` (운영)
버전	0.8.1

설치 및 설정

사전 준비 → 플러그인 설치 → 인증 → 연결 확인 순으로 진행합니다.

사전 준비 → MCP 서버 등록 → 인증 → 연결 확인 순으로 진행합니다.

1 설치 및 설정 · 1-1 사전 준비

사전 준비

uv 하나만 있으면 됩니다. MCP 서버를 기동하는 데 사용합니다. Python은 uv가 자동으로 관리하므로 별도 설치가 필요 없습니다.

1

터미널에서 설치 여부를 확인합니다.uv --version
2

설치되어 있지 않으면 uv 공식 설치 안내를 따릅니다. docs.astral.sh/uv — 설치 안내 ↗

연결 대상은 운영 서버 https://gdc.gemiso.com 으로 고정되어 있습니다. 별도 설정은 필요하지 않습니다.

재현 화면

터미널

$ uv --version

uv 0.9.2

버전이 출력되면 정상입니다.

1 설치 및 설정 · 1-2 플러그인 설치

플러그인 설치

Claude Code 안에서 마켓플레이스를 등록한 뒤 설치합니다. 설치 정보는 각 PC의 Claude Code 설정(~/.claude)에 저장되므로 PC마다 1회 수행합니다.

1

대화창에 마켓플레이스를 등록합니다. /plugin marketplace add seonmikii/gdc-claude-plugin
2

이어서 플러그인을 설치합니다. /plugin install gdc-claude-plugin@gdc-marketplace
3

/reload-plugins 를 실행하거나 Claude Code를 다시 시작합니다.

여러 명이 공용 GDC 계정을 쓰더라도 플러그인 설치는 각 PC에서 따로 해야 합니다. 이미 설치한 뒤 새 버전을 받으려면 /gdc-update 를 실행하고 Claude Code를 재시작합니다. 설치가 EBUSY 로 실패하는 경우는 「05 자주 묻는 문제」에 있습니다.

1 설치 및 설정 · 1-2 MCP 서버 등록

MCP 서버 등록

레포를 클론하고 Claude 데스크탑 앱의 설정에 서버를 추가한 뒤 앱을 재시작합니다. PC마다 1회 수행합니다.

1

레포를 클론합니다.git clone https://github.com/seonmikii/gdc-claude-plugin
2

Claude 데스크탑 앱의 설정을 엽니다.
3

왼쪽 「Developer」 탭에서 「Edit Config」 를 누릅니다. 설정 파일이 없으면 새로 만들어 열어 주므로 경로를 직접 찾을 필요가 없습니다.

Windows %APPDATA%\Claude\claude_desktop_config.json

macOS ~/Library/Application Support/Claude/claude_desktop_config.json

파일을 직접 열어도 됩니다. 경로는 OS마다 다르니 해당하는 줄만 복사하세요.
4

열린 파일에 오른쪽 내용을 넣고 <클론 경로> 를 실제로 클론한 폴더 경로로 바꿉니다.
5

Claude 데스크탑 앱을 완전히 종료했다가 다시 엽니다. 창만 닫아서는 반영되지 않습니다.

메뉴 이름은 공식 MCP 안내를 따랐습니다. Connect to local MCP servers ↗
새 버전을 받으려면 클론한 폴더에서 git pull 하고 앱을 재시작합니다. Claude 데스크탑 앱에는 플러그인 개념이 없어 /gdc-update 에 해당하는 기능이 없습니다.

재현 화면

{
  "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"
      }
    }
  }
}

1 설치 및 설정 · 1-3 인증

인증

브라우저 핸드오프 방식입니다. 브라우저 창이 열리면 평소와 동일하게 로그인합니다. 아이디·비밀번호를 대화창에 입력하지 않습니다.

1

/gdc-login 을 입력합니다.

입력창 "+" 메뉴에서 gdc_login 프롬프트를 실행합니다.

커맨드 대신 채팅으로도 가능합니다 프롬프트 대신 채팅으로도 가능합니다 “GDC 로그인해줘”
2

열린 브라우저에서 로그인합니다. Google 계정과 로컬 계정 모두 사용할 수 있습니다.
3

사용할 워크스페이스와 프로젝트를 선택하고 「연결 허용」을 누릅니다.
4

대화창으로 돌아오면 인증이 완료된 상태입니다.

선택한 워크스페이스·프로젝트는 현재 폴더에만 적용됩니다. 레포마다 다른 프로젝트를 지정할 수 있습니다. 토큰은 ~/.gdc-mcp/credentials.json 에 저장되며 대화·로그에 노출되지 않습니다.

토큰은 ~/.gdc-mcp/credentials.json 에 저장되며 대화·로그에 노출되지 않습니다. 프로젝트를 바꾸려면 gdc_switch 프롬프트를 실행합니다.

실제 화면

브라우저에 열린 GDC ↔ Claude Code 연결 화면. 워크스페이스와 프로젝트를 고른 뒤 연결 허용 버튼이 활성화된 상태.

1 설치 및 설정 · 1-4 연결 확인

연결 확인

MCP 서버가 정상적으로 붙었는지 한 번 확인하고 넘어갑니다.

1

/mcp 를 입력합니다.
2

목록에서 plugin:gdc-claude-plugin:gdc-local 이 ✓ Connected 로 뜨는지 봅니다.
3

표시되지 않으면 /reload-plugins 를 실행하거나 Claude Code를 완전히 재시작합니다.

1

입력창 왼쪽 아래 "+" 를 눌러 Connectors → 「Manage connectors」 로 들어가면 gdc-local 과 도구 목록이 보입니다.
2

또는 “지금 GDC 프로젝트 뭐야?” 라고 물어봅니다. get_context 도구로 답이 오면 정상입니다.
3

아무것도 보이지 않으면 설정 파일의 JSON 문법을 다시 확인하고 앱을 완전히 종료했다가 다시 엽니다.

현재 적용된 워크스페이스·프로젝트는 get_context 도구로 확인할 수 있습니다. 변경하려면 /gdc-switch 를 사용합니다.

현재 적용된 워크스페이스·프로젝트는 get_context 도구로 확인할 수 있습니다. 변경하려면 gdc_switch 프롬프트를 사용합니다.

재현 화면

Claude Code

> /mcp

plugin:gdc-claude-plugin:gdc-local ✓ Connected

도구 31 · 프롬프트 12

재현 화면

Claude Desktop

> 지금 GDC 프로젝트 뭐야?

get_context 도구 호출

✓ 워크스페이스 6 GDC
　프로젝트 31 GDC 개발

작업 흐름

정해진 절차는 아닙니다. 일반적인 작업 흐름을 예시로 잡고 각 단계에서 주로 쓰는 기능을 소개합니다.

예시 단계 1

할 일 정리

태스크를 생성하고 담당 태스크를 조회합니다.

/gdc-task-new · /gdc-my-tasks · /gdc-tasks <담당자> · /gdc-task <id>

gdc_task_new · gdc_my_tasks · gdc_tasks · gdc_task

예시 단계 2

작업 요청 문서를 쓰는 경우만

문서를 연결하면 진행률이 따라온다

문서와 태스크를 한 번 연결해두면, 문서의 체크박스가 태스크 진행률을 움직입니다.

/gdc-doc-from-task · /gdc-task-from-doc · /gdc-link-task · /gdc-sync

gdc_doc_from_task · gdc_task_from_doc · gdc_link_task · gdc_sync

예시 단계 3

작업 요청 문서를 쓰는 경우만

태스크에 작업 변경사항 반영

작업하며 달라진 내용을 태스크 본문·댓글·하위 태스크로 반영합니다.

/gdc-apply

gdc_apply

태스크와 관련된 기능은 대부분 지원합니다. 아래 순서를 그대로 따를 필요 없이 필요한 것만 자유롭게 사용하세요. 개선이 필요한 부분은 의견 주시면 반영하겠습니다.

GDC 프로젝트 태스크 목록. 번호·제목·유형·상태·우선순위·담당자·진행률·예상 종료일 열이 표로 나열되어 있다. — 아래 절차는 이 화면을 열지 않고 대화창에서 처리합니다.

2 작업 흐름 · 2-1 태스크 생성

태스크 생성

대화창에서 GDC 태스크를 생성합니다. 제목·내용은 자유 입력이고, 상태·우선순위·업무유형은 선택 목록으로 지정합니다.

1

/gdc-task-new 를 입력합니다.

gdc_task_new 프롬프트를 "+" 메뉴에서 실행합니다.

“로그인 기능 구현 태스크 만들어줘”
2

제목과 내용을 한글로 입력합니다. 별도의 형식을 맞출 필요는 없습니다.
3

상태·우선순위·업무유형을 목록에서 선택합니다. 담당자는 본인으로 등록됩니다 — 다른 사용자를 지정하려면 따로 명시해 주세요.
4

만들어진 태스크의 번호와 링크를 알려줍니다.

예상 시작일·종료일은 YYYY-MM-DD 형식으로 입력하거나 생략할 수 있습니다. 모든 선택 질문에는 「건너뛰기」 항목이 포함됩니다. 완료 계열 상태로 생성하면 진행률 100%와 실제 종료일이 자동 입력됩니다.

재현 화면

Claude — gdc-claude-plugin

> /gdc-task-new

어떤 태스크인가요? 제목과 내용을 적어주세요.

> WBS 간트 차트에 확대·축소 버튼 추가

상태를 골라주세요

등록 진행 검토 건너뛰기

우선순위

긴급 보통 낮음 건너뛰기

✓ 태스크를 만들었습니다.
　 #1284 · WBS 간트 차트에 확대·축소 버튼 추가
　 담당자 나 · 상태 등록
　 https://gdc.gemiso.com/tasks/1284

2 작업 흐름 · 2-2 내 태스크 조회

내 태스크 조회

현재 프로젝트에서 본인이 담당·작성·참여 중인 미해결 태스크를 마감일 순으로 조회합니다.

1

/gdc-my-tasks 를 입력합니다. 내가 담당자·작성자·관련자 중 하나이면서 아직 끝나지 않은 태스크를 예상 종료일이 빠른 순으로 최대 20건 조회합니다.

gdc_my_tasks 프롬프트를 실행합니다. 내가 담당자·작성자·관련자 중 하나이면서 아직 끝나지 않은 태스크를 예상 종료일이 빠른 순으로 최대 20건 조회합니다.

“내 태스크 보여줘”
2

범위를 좁히려면 옵션을 붙입니다.
# 마감 지난 것만 /gdc-my-tasks --overdue # 날짜 미정 /gdc-my-tasks --undated # 완료 포함 전부 /gdc-my-tasks --all
범위를 좁히려면 말로 덧붙이면 됩니다 — “마감 지난 것만”, “날짜 미정인 것”, “완료된 것도 포함해서”.
3

다른 사용자의 태스크는 /gdc-tasks <이름> 으로 조회합니다.

다른 사용자의 태스크는 gdc_tasks 프롬프트를 쓰거나 이름을 말하면 됩니다.

조회 범위는 현재 폴더에 지정된 프로젝트 1개입니다. 다른 프로젝트는 섞이지 않습니다. 특정 태스크의 상세는 /gdc-task 1284 로 조회하며, 번호 대신 제목 일부를 입력해도 됩니다. 여러 조건을 조합한 검색은 search_tasks 도구가 처리합니다.

조회 범위는 인증할 때 선택한 프로젝트 1개입니다. 다른 프로젝트는 섞이지 않습니다. 특정 태스크의 상세는 gdc_task 프롬프트로 조회하며, 번호 대신 제목 일부를 입력해도 됩니다. 여러 조건을 조합한 검색은 search_tasks 도구가 처리합니다.

재현 화면

Claude

> /gdc-my-tasks --overdue

> 마감 지난 내 태스크 보여줘

GDC 개발 · 마감 지난 미해결 3건

! #1187 WBS 저장 시 순서 뒤집힘
　 진행 · 긴급 · 08-05 마감 · 40%

! #1203 간트 열 너비 초기화 안 됨
　 진행 · 보통 · 08-07 마감 · 70%

! #1240 알림 뱃지 카운트 오차
　 검토 · 보통 · 08-08 마감 · 90%

선택 · 작업 요청 문서로 일하는 경우

작업 요청 문서로 일하기

작업 요청 문서와 태스크를 연결하여, 작업의 진행 상황과 내용에 맞게 GDC의 태스크를 간편하게 업데이트합니다.

아래 세 단계는 하나의 흐름입니다. 문서와 태스크를 한 번 짝지어두면, 그 뒤로는 체크박스를 채우는 것만으로 태스크 진행률이 움직이고, 작업하며 달라진 내용이 태스크로 돌아갑니다.

2-3

한 번 연결

문서 frontmatter에 태스크 번호가 기록됩니다.

2-4

진행률은 저절로

문서 체크박스가 태스크 진행률·상태를 움직입니다.

2-5

변경사항은 태스크로

계획에 없던 내용이 본문·댓글·하위 태스크로 반영됩니다.

작업 요청 문서를 쓰지 않는다면 이 구간은 통째로 건너뛰어도 됩니다.

Claude Desktop 사용 시 참고. 이 구간은 Claude가 레포의 파일을 읽을 수 있다고 전제합니다. Claude Code에서는 되지만 Claude Desktop은 다릅니다. 진행률 자동 반영 훅이 없어 2-4를 gdc_sync 프롬프트로 직접 실행해야 하고, 환경에 따라 로컬 문서 읽기 자체가 안 될 수 있습니다.

2 작업 흐름 · 2-3 문서와 태스크 연결

문서와 태스크 연결

작업 요청 문서와 태스크를 1:1로 연결합니다. 문서 frontmatter에 태스크 번호가 기록되고, 이후 단계는 전부 이 기록을 기준으로 동작합니다.

1

태스크가 먼저 있는 경우 — 태스크 번호로 문서를 생성합니다./gdc-doc-from-task 1284

태스크가 먼저 있는 경우 — gdc_doc_from_task 프롬프트로 태스크 번호에서 문서를 생성합니다.

“1284번으로 작업 문서 만들어줘”
2

문서가 먼저 있는 경우 — 문서로 태스크를 생성합니다./gdc-task-from-doc docs/requests/...md

문서가 먼저 있는 경우 — gdc_task_from_doc 프롬프트로 문서에서 태스크를 생성합니다.

“이 문서로 태스크 만들어줘”
3

둘 다 이미 있는 경우 — 연결만 수행합니다./gdc-link-task 1284

둘 다 이미 있는 경우 — gdc_link_task 프롬프트로 연결만 수행합니다.

“이 문서를 1284번이랑 연결해줘”

어느 방향으로 시작하든 결과는 동일합니다 — 문서와 태스크가 한 쌍으로 묶입니다. 이 연결이 있어야 2-4와 2-5가 동작합니다.

재현 화면

Claude

> /gdc-doc-from-task 1284

> 1284번으로 작업 문서 만들어줘

#1284 조회 — WBS 간트 차트에 확대·축소 버튼 추가

✓ 문서를 만들었습니다.
　 docs/requests/2026-08/20260810-...-gantt-zoom.md

---
task_id: 1284
task_url: https://gdc.gemiso.com/tasks/1284
---

2 작업 흐름 · 2-4 진행률 동기화

진행률 동기화

2-3에서 연결해두면 따라오는 결과입니다. 문서의 단계별 체크박스를 채우면 연결된 태스크의 진행률과 상태가 알아서 갱신됩니다.

1

문서 「수행 계획」의 단계를 완료할 때마다 체크합니다.
2

저장하는 순간 훅이 완료 단계 비율을 계산해 태스크에 반영합니다. 따로 실행할 것은 없습니다.

Claude Desktop에는 훅이 없으므로, 반영이 필요할 때 gdc_sync 프롬프트를 실행합니다.
3

원하는 시점에 강제로 맞추려면 /gdc-sync 를 실행합니다.

또는 “이 문서 진행률 동기화해줘” 라고 말해도 됩니다.

처음 진행률이 올라가면 상태가 진행으로, 100%가 되면 완료로 자동 전이되고 실제 시작일·종료일이 함께 기록됩니다.

재현 화면

작업 요청 문서

- [x] 1단계 버튼 UI

- [x] 2단계 배율 계산

- [ ] 3단계 상태 저장

- [ ] 4단계 단축키

→

GDC 태스크 #1284

진행률 50%

상태 · 진행

4단계 중 2단계 완료 → 50%. GDC는 진행률을 10% 단위로 저장하므로 계산값은 10% 단위에 맞춰 기록됩니다.

2 작업 흐름 · 2-5 태스크에 작업 변경사항 반영

태스크에 작업 변경사항 반영

계획대로만 끝나는 작업은 드뭅니다. 없던 항목이 추가되고 결정이 뒤집히죠. 문서와 연결된 태스크를 비교해 달라진 부분을 찾아, 태스크가 계획이 아니라 실제로 한 작업을 담게 만듭니다.

1

/gdc-apply 를 입력합니다.

gdc_apply 프롬프트를 실행합니다.

“이 문서 변경사항 태스크에 반영해줘”
2

수정·추가된 내용을 검토하여 아래 세 가지 옵션을 제시합니다.
3

확인하면 반영합니다. 승인 전에는 GDC에 아무것도 쓰지 않습니다.

본문·댓글에 입력한 http(s):// 주소와 #번호 형태의 태스크 언급은 자동으로 링크 처리됩니다.

실제 화면

반영이 끝난 GDC 태스크 상세 화면. 본문 「작업 내용」에 블렛이 덧붙어 있고, 아래에 변경 사유를 적은 댓글이, 우측에는 변경 이력의 수정 전후 비교가 보인다.

반영 옵션	상황 예시
태스크 본문에 작업 내용 추가	계획에 없었지만 실제로 한 작업. 「작업 내용」 섹션에 블렛으로 덧붙입니다. 해당 섹션만 교체하므로 첨부 이미지는 그대로 남습니다.
댓글에 히스토리 남기기	결정 사항, 계획이 바뀐 이유, 남겨둘 만한 발견. 관련자를 멘션하면 알림이 갑니다.
하위 태스크 생성	계획에 없던 새 작업 항목 중 담당자·일정·진행률을 따로 관리해야 하는 것.

커맨드

프롬프트

슬래시 커맨드 13종입니다. 대화창에 직접 입력합니다. Claude Code 전용이고, Claude Desktop을 쓴다면 위 탭을 바꿔 프롬프트 12종을 보세요.

프롬프트 12종입니다. 입력창 "+" 메뉴에서 골라 실행합니다. 꼭 프롬프트를 거칠 필요는 없고, 평소 말투로 요청해도 됩니다.

커맨드가 뭔가요?프롬프트가 뭔가요? 직접 입력메뉴에서 선택

대화창에 / 로 시작해 직접 입력하는 단축 명령입니다 — /gdc-task-new 같은 것들이죠. 무엇을 할지 이미 정해졌을 때 쓰면 나머지는 알아서 물어봐 줍니다.

입력창 "+" 메뉴에서 골라 쓰는, 미리 만들어 둔 요청입니다 — gdc_task_new 같은 것들이죠. Claude Code의 슬래시 커맨드에 해당합니다.

커맨드	하는 일
`/gdc-login`	브라우저 핸드오프 인증·재인증 (워크스페이스·프로젝트 선택)
`/gdc-switch`	현재 레포의 워크스페이스·프로젝트 전환 (재인증 없이)
`/gdc-my-tasks`	내 미해결 태스크 — `--overdue` `--undated` `--all`
`/gdc-tasks <담당자>`	특정 담당자의 태스크 (이름 또는 user id)
`/gdc-task <id\|제목>`	태스크 상세 — 하위·연관·상위 태스크 포함
`/gdc-task-new`	새 태스크 생성 (선택 목록·한글·담당자 자동)
`/gdc-task-from-doc <path>`	작업 요청 문서로 태스크 생성
`/gdc-doc-from-task <id>`	태스크로 작업 요청 문서 생성·연동
`/gdc-link-task <id> [doc]`	기존 태스크와 기존 문서를 연결
`/gdc-apply [path]`	문서 변경을 태스크 본문·댓글·하위 태스크에 반영
`/gdc-sync [path]`	문서 진행률을 연결된 태스크에 강제 동기화
`/gdc-suggest [내용\|list\|번호]`	건의사항 제출 / 내 건의 목록 / 답변 확인
`/gdc-update`	마켓플레이스 갱신 후 플러그인 최신 버전으로 승격

프롬프트	하는 일
`gdc_login`	브라우저 핸드오프 인증·재인증 (워크스페이스·프로젝트 선택)
`gdc_switch`	워크스페이스·프로젝트 전환 (재인증 없이)
`gdc_my_tasks`	내 미해결 태스크 — “마감 지난 것만” “완료 포함” 처럼 덧붙여 좁힘
`gdc_tasks`	특정 담당자의 태스크 (이름 또는 user id)
`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 Desktop에는 플러그인 개념이 없기 때문입니다. 클론한 폴더에서 git pull 하고 Claude Desktop을 재시작하면 됩니다.

도구

MCP 도구 31종이고 Code·Desktop 동일합니다.

도구가 뭔가요? Claude가 알아서 호출

플러그인이 실제로 할 수 있는 일입니다 — 태스크 조회, 생성, 댓글 작성 같은 것들입니다. 도구 이름을 외우거나 입력할 필요는 없습니다. “내 태스크 보여줘” 처럼 평소 말투로 요청하면 Claude가 알맞은 도구를 골라 씁니다. 아래 목록은 지원 범위를 확인하는 용도입니다.

컨텍스트 · 인증 7

`gdc_login`	브라우저 핸드오프로 토큰 발급, 워크스페이스·프로젝트를 레포별 저장
`get_context`	현재 레포에 적용되는 워크스페이스·프로젝트 확인
`set_context`	현재 레포의 워크스페이스·프로젝트 전환 (재인증 없이)
`list_workspaces`	접근 가능한 워크스페이스 목록
`list_projects`	지정 워크스페이스의 프로젝트 목록 (종료된 프로젝트 제외)
`list_customers`	프로젝트에 지정 가능한 고객사 목록
`get_project_enums`	프로젝트별 상태·우선순위·업무유형·멤버 목록

`list_my_tasks`	내(담당·작성·참여) 미해결 태스크 — 마감 지남·날짜 미정 필터
`list_tasks`	특정 담당자의 태스크 — 이름 또는 user id
`search_tasks`	키워드·다중 필터 검색 (상태·우선순위·유형·담당자·고객사·종료일 범위). 완료 포함
`get_task`	태스크 상세 — 하위·연관·상위 + 실제 날짜·고객사·비중·관련자·댓글 수
`open_task`	태스크 웹 화면을 브라우저 새 탭으로 열기

생성 · 수정 3

`create_task`	태스크 생성. 담당자 기본은 본인, 날짜·멤버 검증, 완료 상태면 진행률·실제 종료일 자동 보정
`update_task`	부분 수정. 날짜 순서·미래 종료일·멤버 소속을 검증하고 어긋나면 차단
`edit_task_description`	본문 최소 편집 — 블렛 추가 또는 특정 섹션만 교체 (첨부 이미지 보존)

문서 연동 3

`task_from_doc`	작업 요청 문서로 태스크 생성 + 문서에 연동 기록
`link_task_to_doc`	기존 태스크를 기존 문서와 연결 (새로 만들지 않음)
`sync_doc_progress`	문서 체크박스 진척을 태스크 진행률·상태·날짜에 동기화

`list_task_comments`	태스크 댓글 목록
`add_task_comment`	댓글 작성 — 멘션 시 하이라이트 표시와 알림 발송
`update_task_comment`	댓글 수정 (멘션 유지)
`delete_task_comment`	댓글 삭제

정리 · 복구 4

`archive_task`	숨기기·해제 토글 (하위 일괄, WBS 불가, 확인 절차 있음)
`delete_task`	삭제 — 휴지통으로 이동해 복구 가능. 관리자 이상, 확인 절차 있음
`restore_task`	휴지통 태스크 복구. 관리자 이상, 확인 절차 있음
`list_trashed_tasks`	현재 프로젝트 휴지통 목록 — 복구 대상 확인

알림 2

`list_my_notifications`	내 알림 목록 + 미읽음 수. 조회 전용이며 전 워크스페이스가 혼재
`list_my_mentions`	나와 관련된 댓글 멘션 — 받은 것·작성한 것·전체, 기간·검색 지원. 현재 프로젝트 기준

건의사항 3

`submit_suggestion`	GDC·플러그인 건의사항 제출 (버그·기능 요청·개선 제안·기타). 워크스페이스·프로젝트와 무관해 컨텍스트 없이도 동작
`list_my_suggestions`	내가 제출한 건의사항 목록 (상태·분류 필터) — 답변이 달렸는지까지
`get_suggestion`	건의사항 상세 — 본문 + 관리자 답변 + 답변자·답변 시각

공통 입력 규칙

담당자·관련자는 user id 대신 이름으로 입력할 수 있습니다. 자동으로 계정을 해석하며, 프로젝트 멤버가 아니면 처리하지 않고 후보 목록을 안내합니다. 날짜는 YYYY-MM-DD 형식이며 시작일이 종료일보다 늦거나 실제 종료일이 미래인 경우 차단됩니다. 본문·댓글에 입력한 주소와 #번호는 자동으로 링크 처리됩니다.

자주 묻는 문제

막혔을 때 먼저 확인할 것들입니다.

설치가 EBUSY: resource busy or locked 로 실패하는 경우

실행 중인 MCP 서버가 캐시 폴더를 점유한 상태입니다.

플러그인을 Disable 후 재설치하거나, Claude Code를 완전히 종료한 뒤 재시작하고 다시 실행합니다.

gdc-local이 Connected로 표시되지 않는 경우

먼저 uv --version 이 정상 동작하는지 확인합니다. MCP 서버를 uv 로 기동하므로 uv가 없으면 연결되지 않습니다.

uv가 정상인데도 연결되지 않으면 /reload-plugins 를 실행하고, 그래도 해결되지 않으면 Claude Code를 완전히 재시작합니다.

gdc_* 프롬프트가 "+" 메뉴에 보이지 않는 경우

거의 항상 설정 파일 문제입니다. claude_desktop_config.json 이 올바른 JSON인지 확인하세요. 마지막 쉼표 하나, Windows 경로의 이스케이프되지 않은 역슬래시 하나로도 Claude Desktop이 파일 전체를 조용히 무시합니다.

그리고 uv --version 이 동작하는지, --directory 경로가 실제 클론한 폴더를 가리키는지 확인합니다. 고칠 때마다 Claude Desktop을 재시작해야 반영됩니다.

로컬 문서를 못 읽는 경우

Claude Desktop에는 작업 중인 레포라는 개념이 없어서, 문서 연동 기능(2-3~2-5)은 파일 접근 설정에 따라 달라지고 아예 안 될 수도 있습니다.

작업 요청 문서로 일한다면 그 단계는 Claude Code에서 하시는 편이 낫습니다. 나머지 기능은 양쪽이 동일합니다.

「프로젝트가 설정되지 않았습니다」 오류가 나오는 경우

현재 폴더에 워크스페이스·프로젝트 컨텍스트가 지정되지 않은 상태입니다. 컨텍스트는 폴더 단위로 저장되므로 새 레포에서는 다시 지정해야 합니다.

인증 전이면 /gdc-login, 이미 인증된 상태면 /gdc-switch 로 프로젝트만 변경합니다.

워크스페이스·프로젝트가 선택되지 않은 상태입니다. 인증 전이면 gdc_login 프롬프트를, 이미 인증된 상태면 gdc_switch 프롬프트로 프로젝트만 변경합니다.

그 밖의 문의

기타 문의나 개선사항 요청은 개인 설정 - 건의함 혹은 /gdc-suggest 를 통해 피드백해주시면 감사하겠습니다.

기타 문의나 개선사항 요청은 개인 설정 - 건의함 혹은 gdc_suggest 프롬프트를 통해 피드백해주시면 감사하겠습니다.

GDC MCP 플러그인 사용 안내서 · v0.8.1 github.com/seonmikii/gdc-claude-plugin