GeckoFlag의 Claude 연동은 Claude 데스크톱 앱에 확장 프로그램을 추가해 Claude와의 대화로 GeckoFlag를 조작할 수 있게 하는 기능입니다. “내가 담당이고 이번 주가 마감인 이슈를 알려 줘”, “오늘 회의 메모를 Wiki에 추가해 줘”처럼 평소 말투로 요청하면 Claude가 필요한 작업을 골라 이슈·프로젝트·Wiki·노트를 검색·조회·생성·업데이트합니다. Gantt 차트를 Excel로 내보낼 수도 있습니다.
“AI로 작성”과의 차이
GeckoFlag에는 이미 AI를 활용한 “AI로 작성” 기능이 있습니다. “AI로 작성”은 GeckoFlag 화면 안에서 입력안을 만드는 기능이고, Claude 연동은 Claude와의 대화로 GeckoFlag를 조작하는 기능입니다. 두 기능의 설정은 각각 독립되어 있습니다.
| AI로 작성 | Claude 연동 | |
|---|---|---|
| 사용하는 곳 | GeckoFlag의 각 입력 화면 | Claude 데스크톱 앱의 대화 |
| 할 수 있는 일 | 이슈·댓글·프로젝트·Wiki 입력안 작성(저장은 사람이 함) | 이슈·프로젝트·Wiki·노트의 검색·조회·생성·업데이트, Gantt 차트 Excel 내보내기 등 |
| 필요한 것 | Anthropic API 키(관리자가 설정 화면에서 등록) | Claude 데스크톱 앱과 사용자별 API 토큰 |
| 요금 | API 사용량에 따른 종량 과금(Anthropic에 지불) | GeckoFlag 측 추가 요금 없음(Claude 요금제 필요) |
| 지원 버전 | v1.9.0 이상 | v1.11.0 이상 |
Claude 연동으로 할 수 있는 일
Claude는 대화 내용에 따라 GeckoFlag의 작업을 자동으로 골라 사용합니다. 생성·변경은 관리자와 사용자 모두 쓰기를 허용한 경우에만 할 수 있습니다.
- 이슈 검색·조회 ― 프로젝트·상태·담당자·등록자·우선순위·키워드·마감일·상위 이슈로 좁혀 검색하고, 상세 내용과 댓글을 읽습니다.
- 이슈 생성·업데이트 ― 이슈 생성(상위 이슈·알림 대상 지정 가능), 항목 변경, 댓글 작성, 상태 변경을 할 수 있습니다. 댓글과 함께 담당자·우선순위·날짜를 바꿀 수도 있습니다.
- 프로젝트 ― 목록과 상세 확인, 새로 만들기, 이름·설명·소유자·기간 변경, 완료/미완료 전환, 멤버 추가·제거(제거는 반드시 확인 후)를 할 수 있습니다.
- Wiki ― 프로젝트의 Wiki를 읽고, 본문을 다시 쓰거나 끝에 내용을 추가할 수 있습니다.
- 노트 ― 내 노트의 목록 보기·검색·조회·생성·다시 쓰기·추가 작성을 할 수 있습니다.
- 마스터 설정(관리자) ― 이슈 유형·상태·우선순위·직책(부서)을 추가하고 이름과 색상을 변경할 수 있습니다.
- Gantt 차트 Excel 내보내기 ― 프로젝트의 이슈를 Gantt 차트 형식의 Excel 파일로 만들어 PC에 저장합니다.
- 이슈는 키로 지정 ― “WEB-12” 같은 이슈 키로 지정할 수 있습니다. Claude는 답변에 이슈 키와 화면 URL을 함께 표시합니다.
- 서식도 그대로 ― 설명·댓글·Wiki·노트의 제목, 글머리 기호, 표, 링크, 굵은 글씨 등의 서식을 유지한 채 읽고 씁니다.
- 평소 쓰는 언어로 ― Claude는 사용자가 말을 건 언어로 답합니다.
요청 예시
특별한 명령어를 외울 필요는 없습니다. 평소 말투로 요청하면 Claude가 필요한 작업을 골라 실행합니다.
| 하고 싶은 일 | 요청 예시 |
|---|---|
| 이슈 찾기 | “내가 담당이고 이번 주가 마감인 이슈를 알려 줘” |
| 이슈 만들기 | “WEB 프로젝트에 ‘문의 양식 수정’이라는 이슈를 만들어 줘” |
| 처리 내용 기록 | “WEB-3에 처리 내용을 댓글로 달고 상태를 완료로 바꿔 줘” |
| 프로젝트 만들기 | “키는 SAMPL, 이름은 ‘샘플 프로젝트’로 프로젝트를 만들어 줘” |
| 멤버 추가 | “김민수 님을 SAMPL에 추가해 줘” |
| Wiki에 남기기 | “SAMPL의 Wiki에 오늘 회의 메모를 추가해 줘” |
| 설정 정리 | “상태에 ‘검토 대기’를 보라색으로 추가해 줘” |
| Gantt 차트 | “WEB 프로젝트의 Gantt 차트를 Excel로 내보내 줘” |
| 정리하기 | “SAMPL의 이번 주 보고서를 써 줘” “Wiki에 있는 할 일을 이슈로 만들어 줘” |
Gantt 차트를 Excel로 내보내기
“Gantt 차트를 Excel로 내보내 줘”라고 요청하면 프로젝트의 이슈(최대 5,000건)를 Gantt 차트 형식의 Excel 파일로 만들어 PC에 저장합니다.
- 상하위 관계도 한눈에 ― 이슈 1건을 1행으로 하고, 하위 이슈는 상위 이슈 바로 아래에 들여 써서 배치합니다. 오른쪽은 타임라인입니다.
- 긴 기간에도 대응 ― 기간과 일/주 단위를 지정할 수 있습니다. 기간이 120일을 넘으면 자동으로 1열 = 1주로 바뀝니다(최장 약 5년).
- Excel에서 조정 가능 ― 시작일·종료일을 고치면 막대도 함께 움직입니다(GeckoFlag에는 반영되지 않습니다).
- 날짜가 없는 이슈도 표시 ― 등록일 등으로 대신하고, 회색 기울임꼴과 그 이유를 표시합니다.
- 15개 언어 지원 ― 제목 등의 문구는 GeckoFlag 사용자 설정의 언어로 내보냅니다(아랍어는 오른쪽에서 왼쪽 방향 시트).
- 덮어쓰지 않음 ― 같은 이름의 파일이 있으면 번호를 붙여 다른 이름으로 저장합니다.
이용에 필요한 것
- GeckoFlag v1.11.0 이상 ― Claude 연동은 v1.11.0에서 추가되었습니다. 이전 버전을 사용 중이라면 먼저 업데이트하세요.
- Claude 데스크톱 앱(Windows·macOS) ― GeckoFlag 확장 프로그램(.mcpb 파일)을 추가해 사용합니다. 확장 프로그램 파일은 GeckoFlag 구매 후 받을 수 있는 다운로드 파일에 포함되어 있습니다. 확장 프로그램 실행에 필요한 Node.js는 앱에 포함되어 있으므로 따로 설치할 필요가 없습니다.
- Claude 요금제 ― GeckoFlag 측 추가 요금은 없습니다. Claude를 이용하려면 Anthropic의 Claude 요금제가 필요합니다.
- HTTPS로 공개된 GeckoFlag ― 확장 프로그램에서 GeckoFlag에 연결하려면 HTTPS가 필요합니다.
도입 흐름
- 관리자가 GeckoFlag의 “설정 → Claude 연동”에서 기능을 켜고, 필요에 따라 쓰기를 허용합니다.
- 관리자가 사용할 사람마다 “Claude 연동(API) 이용 허용”을 켭니다.
- 사용자가 프로필 화면에서 API 토큰을 만듭니다.
- 사용자가 Claude 데스크톱 앱에 확장 프로그램을 설치하고 GeckoFlag URL과 API 토큰을 입력합니다.
- Claude에게 “GeckoFlag에 연결되어 있는지 확인해 줘”라고 요청하면 준비가 끝납니다.
권한과 보안
- 세 가지 허가가 모두 갖춰져야 작동 ― “관리자의 기능 활성화”, “사용자별 이용 허가”, “사용자의 API 토큰” 세 가지가 모두 갖춰졌을 때만 사용할 수 있습니다. 기능이 꺼져 있으면 API 자체가 존재하지 않는 상태가 됩니다.
- 화면과 같은 권한 ― 모든 작업은 API 토큰 소유자의 권한으로 이루어집니다. GeckoFlag 화면에서 볼 수 없거나 할 수 없는 일은 Claude에서도 할 수 없습니다. 권한이 없는 프로젝트나 이슈는 “존재하지 않는” 것으로 취급됩니다.
- 쓰기는 이중 허가제 ― 생성·변경에는 사이트의 “쓰기 허용”과 토큰의 “읽기 및 쓰기”가 모두 필요합니다. 읽기 전용으로 사용할 수도 있습니다.
- Claude에서는 삭제 불가 ― 프로젝트·이슈·댓글·Wiki·노트 등은 Claude에서 삭제할 수 없습니다. 삭제를 요청하면 GeckoFlag 화면에서 하도록 안내합니다.
- 안전한 토큰 관리 ― API 토큰은 추측할 수 없는 난수이며, 서버에는 해시만 저장합니다. 만든 직후 한 번만 표시되며, 생성 시 본인에게 알림 메일이 발송됩니다. 비밀번호를 변경하면 해당 사용자의 토큰은 모두 무효가 됩니다.
- 횟수 제한과 접근 제한 ― 토큰 1개당 1분에 60회로 제한하며, 잘못된 토큰이 계속되는 접속 출처는 일시적으로 차단합니다. GeckoFlag의 IP 주소 접근 제한은 API에도 적용됩니다.
- 쓰기 전에 매번 확인 가능 ― Claude 측 설정에서 GeckoFlag의 쓰기 작업을 “매번 확인”으로 해 두면 실행 전에 반드시 확인을 요청합니다(권장 설정).
데이터 취급
- 확장 프로그램은 사용자의 PC에서 실행 ― 확장 프로그램은 고객님의 GeckoFlag와만 직접 통신합니다. GeckoFlag 개발사나 제3자의 서버를 거치지 않습니다.
- Claude가 읽은 내용은 Anthropic으로 전송 ― Claude가 읽은 이슈·Wiki·노트 등의 내용은 대화의 일부로 Anthropic(Claude)에 전송됩니다. 노트는 사용자가 요청했을 때만 읽도록 Claude에 지시하고 있습니다.
- 본문에 적힌 지시는 따르지 않음 ― 이슈 등에 적힌 문장은 “데이터”로 취급하며, 그 안에 적힌 지시는 따르지 않도록 Claude에 지시하고 있습니다.
- 작업 기록 ― Claude를 통한 작업은 API 토큰 소유자의 작업으로 기록됩니다(“Claude 경유” 표시는 없습니다).
- 도입 전 확인 ― 사내 규정이나 거래처와의 계약에서 외부 서비스로의 정보 전송이 제한되어 있지 않은지 도입 전에 확인하세요.
할 수 없는 일·이용 시 주의 사항
- 삭제(프로젝트·이슈·댓글·마스터·Wiki·노트), 댓글 편집, 이미지·파일 첨부 및 조회는 할 수 없습니다.
- 사용자 추가·편집, 사이트 설정 변경, Kanban 보드·북마크·알림 설정 조작, 다른 사람의 노트 조회(관리자도 불가)는 할 수 없습니다.
- 쓰기는 한 번에 1건씩 이루어집니다. 여러 이슈를 한꺼번에 요청하면 Claude가 1건씩 차례로 실행합니다.
- 댓글로 상태 등을 변경하면 화면에서 조작할 때와 마찬가지로 기록이 남고 알림 메일이 발송됩니다.
- 확장 프로그램은 PC에서 실행되므로 Claude 데스크톱 앱이 실행 중인 PC에서만 사용할 수 있습니다.
- AI의 답변은 틀릴 수 있습니다. 생성·변경한 내용은 GeckoFlag 화면에서도 확인하세요.