Smilegate Connector
스마일게이트 업무 도구를 Claude Code에 연결하는 설정 스킬.
비개발자도 따라할 수 있도록 단계별로 안내한다.
연결 대상
| 서비스 | 연결 방식 | 난이도 |
|---|
| Slack | Connectors (클릭만) | 쉬움 |
| Jira | MCP (토큰 발급 필요) | 보통 |
| Confluence | MCP (토큰 발급 필요) | 보통 |
| BISKIT | MCP (토큰 발급 필요) | 보통 |
| API Docs | MCP (인증 불필요, 클릭만) | 쉬움 |
실행 흐름
이 스킬이 트리거되면 아래 순서로 진행한다.
링크 출력 규칙: 모든 URL은 코드 블록 밖에서 마크다운 링크 형식
으로 표시한다. 코드 블록 안에 URL을 절대 넣지 않는다. 코드 블록 안의 URL은 클릭이 불가능하고 줄바꿈이 발생할 수 있다. 단, JSON 설정 예시의 URL 값은 설정값이므로 코드 블록 안에 표기한다.
Phase 0: 현재 연결 상태 진단
스킬 시작 시 먼저 현재 연결 상태를 진단한다.
확인 방법:
- ToolSearch로 검색 → Slack 도구 존재 여부 확인
- ToolSearch로 검색 → Jira MCP 존재 여부 확인. 도구가 있으면
mcp__jira__test_jira_connection()
- ToolSearch로 검색 → Confluence MCP 존재 여부 확인. 도구가 있으면
mcp__confluence__test_confluence_connection()
- ToolSearch로 검색 → BISKIT MCP 존재 여부 확인. 도구가 있으면
mcp__biskit-report-mcp__check_auth_status()
- ToolSearch로 검색 → API Docs MCP 존재 여부 확인. 도구가 있으면 연결됨 (인증 불필요이므로 도구 존재 = 연결 성공)
진단 결과를 테이블로 보여준다:
| 서비스 | 상태 |
|---|
| Slack | ✅ 연결됨 / ❌ 미연결 |
| Jira | ✅ 연결됨 / ⚠️ 재연결 필요 (토큰 만료 등) / ❌ 미연결 |
| Confluence | ✅ 연결됨 / ⚠️ 재연결 필요 / ❌ 미연결 |
| BISKIT | ✅ 연결됨 / ⚠️ 재연결 필요 / ❌ 미연결 |
| API Docs | ✅ 연결됨 / ❌ 미연결 |
- ✅ 연결됨: 도구 존재 + 연결 테스트 성공
- ⚠️ 재연결 필요: 도구는 존재하지만 연결 테스트 실패 (토큰 만료, 토큰 오류 등)
- ❌ 미연결: 도구 자체가 없음 (MCP 설정 없음)
- API Docs는 인증이 불필요하므로 ✅(연결됨)과 ❌(미연결) 두 가지 상태만 존재한다.
이미 연결된 서비스(✅)는 건너뛴다. ⚠️ 또는 ❌ 상태의 서비스만 설정을 진행한다.
모두 ✅이면 "모든 서비스가 연결되어 있습니다!"를 출력하고 기본 사용법을 안내한 뒤 종료한다.
설정이 필요한 서비스(⚠️/❌)가 있으면 AskUserQuestion으로 설정할 서비스를 선택받는다:
- question: "어떤 서비스를 설정할까요? (여러 개 선택 가능)"
- 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 명세 검색 (인증 불필요, 바로 설치)"}
- multiSelect: true
- 해당 상태의 서비스만 옵션에 표시한다 (예: Jira가 ❌이면 "Jira"만, ⚠️이면 "Jira ⚠️ 재연결"만)
분기 흐름
선택 결과에 따라 아래와 같이 진행한다:
- Slack만 선택 → Phase 1 → Phase 5
- API Docs만 선택 → Phase 2 → Phase 5
- MCP 서비스만 선택 (Jira/Confluence/BISKIT) → Phase 3 → Phase 5
- API Docs + MCP 서비스 선택 → Phase 2 → Phase 3 → Phase 5
- Slack + API Docs 선택 → Phase 1 → Phase 2 → Phase 5
- Slack + MCP 서비스 선택 → Phase 1 → Phase 3 → Phase 5
- Slack + API Docs + MCP 서비스 선택 → Phase 1 → Phase 2 → Phase 3 → Phase 5
Phase 1: Slack 연결 (Connectors)
Slack 설정 가이드에 따라 진행한다. → references/slack.md
완료 확인 후:
- 연결 성공 시:
- API Docs를 선택했으면 Phase 2로 이동한다.
- MCP 서비스(Jira/Confluence/BISKIT)를 선택했으면 Phase 3으로 이동한다.
- API Docs도 MCP 서비스도 선택하지 않았으면 Phase 5로 이동한다.
- 연결 실패 시: Slack 가이드의 트러블슈팅 진행 → 진전 없으면 Phase 4(이슈 등록) → Phase 5로 이동한다.
Phase 2: API Docs 연결 (인증 불필요)
API Docs 설정 가이드에 따라 진행한다. → references/apidocs.md
완료 후:
- MCP 서비스(Jira/Confluence/BISKIT)를 선택했으면 Phase 3으로 이동한다 (재시작은 Phase 3 이후에 한 번만).
- MCP 서비스를 선택하지 않았으면 재시작 안내 후 Phase 5로 이동한다.
Phase 3: MCP 연결 (Jira / Confluence / BISKIT)
⚠️ Jira, Confluence, BISKIT MCP는 사내망 또는 VPN 연결이 필요합니다. 연결 상태를 먼저 확인해주세요.
핵심 원칙: 선택한 MCP 서비스(Jira/Confluence/BISKIT)를 모두 한 번에 설정하고, 재시작은 딱 한 번만 한다. (API Docs는 Phase 2에서 이미 처리되었으므로 여기서는 다루지 않는다.)
토큰 발급 → 전체 입력 → 설정 파일 일괄 저장 → 재시작 → 연결 테스트 순서로 진행한다.
Step 1: 선택한 서비스의 토큰 발급 안내 (모두 출력)
선택한 서비스에 해당하는 토큰 발급 안내를 한 번에 모두 출력한다.
사용자가 브라우저에서 여러 탭을 열어 한꺼번에 발급받을 수 있도록 안내한다.
각 서비스의 상세 토큰 발급 절차는 해당 가이드를 참조한다:
- Jira 선택 시 → references/jira.md
- Confluence 선택 시 → references/confluence.md
- BISKIT 선택 시 → references/biskit.md
Step 2: 토큰 전체 입력 (선택한 서비스 모두)
토큰 발급 안내 직후, AskUserQuestion으로 필요한 정보를 순서대로 입력받는다.
재시작 전에 선택한 모든 서비스의 토큰을 한 번에 입력받는다.
각 서비스의 토큰 입력 AskUserQuestion 스펙은 해당 가이드를 참조한다:
- 사용자 ID 질문 (Jira/Confluence 중 하나라도 선택한 경우):
- question: "사용자 ID를 입력해주세요 (Jira/Confluence 공통, 예: hyuntkim)"
- options: [
{label: "직접 입력하기", description: "사용자 ID를 입력하세요"},
{label: "잘 모르겠어요", description: "Jira 또는 Confluence에 로그인할 때 사용하는 ID입니다"}
]
- "잘 모르겠어요" 선택 시: Jira 프로필 페이지 또는 Confluence 프로필 페이지에서 사용자 이름을 확인할 수 있다고 안내한 뒤, 다시 입력을 요청한다.
- Jira 토큰 입력 → references/jira.md
- Confluence 토큰 입력 → references/confluence.md
- BISKIT 토큰 입력 → references/biskit.md
중요: 토큰은 민감정보이므로 대화 내용에 그대로 노출하지 않는다.
입력받은 토큰 값의 앞뒤 공백과 줄바꿈을 제거(trim)한 뒤 설정 파일에 저장한다.
대화에서는 마스킹하여 표시한다.
Step 3: 설정 파일 일괄 업데이트
Read 도구로 설정 파일을 읽고,
객체에
선택한 서비스를 한번에 추가(신규) 또는 덮어쓰기(재연결)한다.
각 서비스의 MCP 설정 JSON은 해당 가이드를 참조한다:
- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
추가 후 사용자에게 재시작을 안내한다:
설정 파일의 mcpServers에 {설정한 서비스 목록} 설정이 모두 추가되었습니다!
이제 Claude Code를 한 번 재시작하면 모든 서비스가 동시에 연결됩니다:
- Mac / Linux: → 터미널에서 실행
- Windows: 입력 → 터미널에서 실행
재시작 후
을 입력하면
직전 대화를 이어서 진행할 수 있습니다.
Step 4: 재시작 후 연결 테스트 (선택한 서비스 모두)
사용자가 재시작을 완료했다고 (또는
으로 돌아왔다고) 알려주면, 선택한 서비스를
모두 테스트한다.
각 서비스의 연결 테스트 방법은 해당 가이드를 참조한다:
- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
- API Docs (Phase 2에서 설치한 경우) → references/apidocs.md
연결 실패 시 트러블슈팅 → references/troubleshoot.md
Phase 4: 미해결 이슈 등록
트러블슈팅이 진전 없이 막혀있을 때 GitHub 이슈 등록을 제안한다. → references/troubleshoot.md
이후 Phase 5로 진행한다. (이슈 등록 여부와 관계없이 완료 리포트는 출력)
Phase 5: 완료 리포트
모든 설정이 끝나면 최종 상태를 요약한다.
실제 설정한 서비스만 표시하고, 연결 테스트 결과에 따라 ✅(성공)/❌(실패)를 표시한다.
출력 형식 (코드 블록 없이 마크다운으로):
스마일게이트 커넥터 설정 완료!
연결 상태: (설정한 서비스만 표시)
기본 사용법: (연결 성공한 서비스만 표시)
서비스별 예시 문구:
- Slack: "Slack에서 #general 채널 최근 메시지 보여줘", "Slack에서 '배포' 관련 메시지 검색해줘"
- Jira: "나한테 할당된 Jira 이슈 보여줘", "PROJ-123 이슈 상태 알려줘"
- Confluence: "최근 업데이트된 Wiki 페이지 보여줘", "'프로젝트 계획' 관련 문서 검색해줘"
- BISKIT: "카제나 어제 DAU 알려줘", "에픽세븐 이번 주 매출은?"
- API Docs: "결제 관련 API 명세 찾아줘", "사용자 인증 API 스펙 알려줘"
연결 실패한 서비스가 있으면 트러블슈팅 안내를 함께 표시한다.
팁: 토큰이 만료되면 "커넥터 설정해줘" 한 마디로 이 스킬을 다시 실행할 수 있습니다.
MCP 설정 위치
MCP는 항상 전역 설정 파일에 추가한다. OS마다 경로가 다르다:
| OS | 설정 파일 경로 |
|---|
| Mac / Linux | |
| Windows | %USERPROFILE%\.claude.json
C:\Users\hyuntkim\.claude.json
|
전역 설정 파일에 저장하면 모든 프로젝트에서 사용할 수 있다.
Git 저장소 밖에 있으므로 토큰이 실수로 커밋될 위험이 없다.