Smilegate Connector

스마일게이트 업무 도구를 Claude Code에 연결하는 설정 스킬. 비개발자도 따라할 수 있도록 단계별로 안내한다.

연결 대상

실행 흐름

이 스킬이 트리거되면 아래 순서로 진행한다.

링크 출력 규칙: 모든 URL은 코드 블록 밖에서 마크다운 링크 형식 [텍스트](URL) 으로 표시한다. 코드 블록 안에 URL을 절대 넣지 않는다. 코드 블록 안의 URL은 클릭이 불가능하고 줄바꿈이 발생할 수 있다. 단, JSON 설정 예시의 URL 값은 설정값이므로 코드 블록 안에 표기한다.

진단 → 서비스 선택 → 서비스별 설정(하나씩) → 재시작(필요 시) → 연결 테스트 → 완료 리포트 → 자동화 제안(첫 실행 시)

진단: 현재 연결 상태 확인

스킬 시작 시 먼저 현재 연결 상태를 진단한다.

확인 방법:

1. ToolSearch로 +slack read 검색 → Slack 도구 존재 여부 확인
2. ToolSearch로 +jira test 검색 → Jira MCP 존재 여부 확인. 도구가 있으면 mcp__jira__test_jira_connection() 호출로 실제 연결 확인
3. ToolSearch로 +confluence test 검색 → Confluence MCP 존재 여부 확인. 도구가 있으면 mcp__confluence__test_confluence_connection() 호출로 실제 연결 확인
4. ToolSearch로 +biskit check_auth 검색 → BISKIT MCP 존재 여부 확인. 도구가 있으면 mcp__biskit-report-mcp__check_auth_status() 호출로 실제 연결 확인
5. ToolSearch로 +apidocs search 검색 → API Docs MCP 존재 여부 확인. 도구가 있으면 연결됨 (인증 불필요이므로 도구 존재 = 연결 성공)
6. Bash로 glab auth status --hostname git.sginfra.net 2>&1 실행 → GitLab CLI 인증 상태 확인. 명령이 없으면 glab 미설치

진단 결과를 테이블로 보여준다:

• ✅ 연결됨: 도구 존재 + 연결 테스트 성공 (GitLab은 glab 설치 + 인증 완료)
• ⚠️ 재연결 필요: 도구는 존재하지만 연결 테스트 실패 (토큰 만료 등). GitLab은 glab 설치됨 + 인증 실패
• ❌ 미연결: 도구 자체가 없음 (MCP 설정 없음). GitLab은 glab 미설치
• Slackê³¼ API Docs는 인증이 불필요하므로 ✅(연결됨)ê³¼ ❌(미연결) 두 가지 상태만 존재한다.

이미 연결된 서비스(✅)는 건너뛴다. ⚠️ 또는 ❌ 상태의 서비스만 설정을 진행한다. 모두 ✅이면 “모든 서비스가 연결되어 있습니다!”를 출력하고 기본 사용법을 안내한 뒤 종료한다.

서비스 선택

설정이 필요한 서비스(⚠️/❌)가 있으면 먼저 추천 안내를 출력한다:

💡 추천: 처음이시라면 Slack, Jira, Confluence, BISKIT 4가지를 먼저 설정하세요! 가장 많이 사용되는 핵심 서비스입니다.

이후 AskUserQuestion으로 설정할 서비스를 선택받는다:

• question: “어떤 서비스를 설정할까요? (⬆⬇ 화살표로 이동, Space로 선택, Enter로 확인)”
• options: ⚠️/❌ 상태의 서비스만 동적으로 표시
  • {label: “Slack”, description: “Slack 채널 읽기/검색 (클릭 몇 번이면 끝)”}
  • {label: “Jira”, description: “Jira 이슈 조회/생성/관리 (토큰 발급 필요)”}
  • {label: “Jira ⚠️ 재연결”, description: “토큰 만료 또는 오류 — 토큰을 다시 발급받아 연결합니다”}
  • {label: “Confluence”, description: “Wiki 페이지 조회/검색 (토큰 발급 필요)”}
  • {label: “Confluence ⚠️ 재연결”, description: “토큰 만료 또는 오류 — 토큰을 다시 발급받아 연결합니다”}
  • {label: “BISKIT”, description: “게임 데이터 리포트 조회 (토큰 발급 필요)”}
  • {label: “BISKIT ⚠️ 재연결”, description: “토큰 만료 또는 오류 — 토큰을 다시 발급받아 연결합니다”}
  • {label: “API Docs”, description: “SGP API 명세 검색 (인증 불필요, 바로 설치)”}
  • {label: “GitLab”, description: “사내 GitLab CLI 설치 및 연결 (토큰 발급 필요)”}
  • {label: “GitLab ⚠️ 재연결”, description: “토큰 만료 또는 오류 — 토큰을 다시 발급받아 연결합니다”}
• multiSelect: true
• 해당 상태의 서비스만 옵션에 표시한다 (예: Jira가 ❌이면 “Jira”만, ⚠️이면 “Jira ⚠️ 재연결”만)

서비스별 설정

선택한 서비스를 아래 순서대로 하나씩 설정한다. 각 서비스의 상세 절차는 해당 가이드를 참조한다.

각 서비스는 해당 가이드의 절차에 따라 설정까지만 진행한다. 연결 테스트는 모든 설정이 끝난 뒤 일괄 수행한다.

⚠️ Jira, Confluence, BISKIT, API Docs, GitLab은 사내망 또는 VPN 연결이 필요합니다.

Jira/Confluence 공통 사용자 ID

Jira와 Confluence를 모두 선택한 경우, 사용자 ID는 한 번만 입력받는다:

• question: “사용자 ID를 입력해주세요 (Jira/Confluence 공통, 예: hyuntkim)”
• options: [ {label: “직접 입력하기”, description: “사용자 ID를 입력하세요”}, {label: “잘 모르겠어요”, description: “Jira 또는 Confluence에 로그인할 때 사용하는 ID입니다”} ]
• “잘 모르겠어요” 선택 시: Jira 프로필 페이지 또는 Confluence 프로필 페이지에서 사용자 이름을 확인할 수 있다고 안내한 뒤, 다시 입력을 요청한다.

MCP 설정 파일 일괄 업데이트

MCP 서비스(Jira/Confluence/BISKIT/API Docs)를 1개 이상 선택한 경우:

• 모든 MCP 서비스의 토큰 입력이 끝난 후, Read 도구로 설정 파일을 읽고 mcpServers 객체에 선택한 서비스를 한번에 추가(신규) 또는 덮어쓰기(재연결)한다.
• 각 서비스의 MCP 설정 JSON은 해당 가이드를 참조한다.

중요: 토큰은 민감정보이므로 대화 내용에 그대로 노출하지 않는다. 입력받은 토큰 값의 앞뒤 공백과 줄바꿈을 제거(trim)한 뒤 설정 파일에 저장한다. 대화에서는 마스킹하여 표시한다.

재시작

MCP 서비스를 1개 이상 설정한 경우, 모든 서비스의 설정이 끝난 후 Claude Code를 한 번만 재시작한다.

MCP 서비스를 하나도 선택하지 않은 경우 (예: Slack + GitLab만), 재시작은 필요 없으므로 건너뛴다.

설정 파일의 mcpServers에 {설정한 서비스 목록} 설정이 모두 추가되었습니다!

이제 Claude Code를 한 번 재시작하면 모든 서비스가 동시에 연결됩니다:

• Mac / Linux: Ctrl+D → 터미널에서 claude 실행
• Windows: exit 입력 → 터미널에서 claude 실행

재시작 후 /resume 을 입력하면 직전 대화를 이어서 진행할 수 있습니다.

연결 테스트

사용자가 재시작을 완료했다고 (또는 /resume으로 돌아왔다고) 알려주면, 선택한 서비스를 모두 테스트한다. 각 서비스의 연결 테스트 방법은 해당 가이드를 참조한다.

재시작이 필요 없었던 경우 (Slack/GitLab만 선택), 설정 직후 바로 테스트한다.

연결 실패 시 트러블슈팅 → references/troubleshoot.md

완료 리포트

모든 설정이 끝나면 최종 상태를 요약한다.

실제 설정한 서비스만 표시하고, 연결 테스트 결과에 따라 ✅(성공)/❌(실패)를 표시한다.

출력 형식 (코드 블록 없이 마크다운으로):

스마일게이트 커넥터 설정 완료!

연결 상태: (설정한 서비스만 표시)

• {서비스명}: ✅ 연결됨 또는 ❌ 연결 실패

기본 사용법: (연결 성공한 서비스만 표시)

서비스별 예시 문구:

• Slack: “Slack에서 #general 채널 최근 메시지 보여줘”, “Slack에서 ‘배포’ 관련 메시지 검색해줘”
• Jira: “나한테 할당된 Jira 이슈 보여줘”, “PROJ-123 이슈 상태 알려줘”
• Confluence: “최근 업데이트된 Wiki 페이지 보여줘”, “‘프로젝트 계획’ 관련 문서 검색해줘”
• BISKIT: “카제나 어제 DAU 알려줘”, “에픽세븐 이번 주 매출은?”
• API Docs: “결제 관련 API 명세 찾아줘”, “사용자 인증 API 스펙 알려줘”
• GitLab: “내 MR 목록 보여줘”, “feature 브랜치에서 MR 만들어줘”

연결 실패한 서비스가 있으면 트러블슈팅 안내를 함께 표시한다.

팁: 토큰이 만료되면 “커넥터 설정해줘” 한 마디로 이 스킬을 다시 실행할 수 있습니다.

⚠️ 완료 리포트를 출력한 후 여기서 멈추지 않는다. 반드시 아래 “자동화 스킬 제안” 섹션을 이어서 실행한다.

자동화 스킬 제안 (첫 실행 시만)

완료 리포트를 출력한 후, 사용자의 첫 실행 여부를 확인한다.

확인 방법: Read 도구로 ~/.claude/skills/smilegate-ai-tools/state.json 파일을 읽는다.

• 파일이 없거나, connector.completed가 false이면 → 첫 실행
• connector.completed가 true이면 → 재실행

케이스 1: 첫 실행 + 연결 성공 서비스 1개 이상

1. ~/.claude/skills/smilegate-ai-tools/state.json 파일을 생성/업데이트한다:

   {
     "connector": {
       "completed": true,
       "first_completed_at": "{현재 날짜}",
       "connected_services": ["{연결된 서비스 목록}"]
     }
   }
   

   파일이 이미 존재하면 기존 내용을 보존하고 connector 키만 추가/업데이트한다.

2. 출력 스타일 전환을 안내한다:

   🎓 자동화를 시작하기 전에, 더 자세한 설명과 함께 진행할 수 있도록
   출력 스타일을 변경해볼까요?
   
   👉 /output-style 을 입력하고 Explanatory를 선택하세요!
   

3. 자동화 스킬을 제안한다:

   💡 연결된 도구로 바로 업무 자동화를 만들어볼까요?
   
   반복되는 업무(주간보고, 회의록, 발표자료 등)를
   대화만으로 자동화 스킬로 만들 수 있어요.
   
   ① 좋아요, 만들어볼래요 → automation 스킬의 Phase 1부터 시작
   ② 나중에 할게요 → 종료 (나중에 "자동화 만들기"로 실행 가능)
   

   AskUserQuestion으로 선택을 받는다.

   • ① 선택 시: automation 스킬의 Phase 1부터 실행 (Phase 0 건너뜀, 연결 상태를 이미 알고 있으므로)
   • ② 선택 시: “나중에 만들고 싶으면 ‘자동화 만들기’라고 말하면 돼요!” 안내 후 종료

케이스 2: 첫 실행 + 연결 성공 서비스 0개

플래그를 생성하지 않는다. 다음 성공적 실행 시 automation 제안을 받을 수 있도록 한다. 완료 리포트만 출력하고 종료.

케이스 3: 재실행 (completed가 true)

자동화 제안을 건너뛴다. 완료 리포트만 출력하고 종료한다.

MCP 설정 위치

MCP는 항상 전역 설정 파일에 추가한다. OS마다 경로가 다르다:

전역 설정 파일에 저장하면 모든 프로젝트에서 사용할 수 있다. Git 저장소 밖에 있으므로 토큰이 실수로 커밋될 위험이 없다.