connector
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSmilegate Connector
Smilegate连接器
스마일게이트 업무 도구를 Claude Code에 연결하는 설정 스킬.
비개발자도 따라할 수 있도록 단계별로 안내한다.
这是将Smilegate办公工具连接到Claude Code的设置技能，为方便非开发人员操作，提供了分步指引。
연결 대상
连接对象
| 서비스 | 연결 방식 | 난이도 |
|---|---|---|
| Slack | Connectors (클릭만) | 쉬움 |
| Jira | MCP (토큰 발급 필요) | 보통 |
| Confluence | MCP (토큰 발급 필요) | 보통 |
| BISKIT | MCP (토큰 발급 필요) | 보통 |
| API Docs | MCP (인증 불필요, 클릭만) | 쉬움 |
| 服务 | 连接方式 | 难度 |
|---|---|---|
| Slack | Connectors（仅需点击） | 简单 |
| Jira | MCP（需要获取令牌） | 中等 |
| Confluence | MCP（需要获取令牌） | 中等 |
| BISKIT | MCP（需要获取令牌） | 中等 |
| API Docs | MCP（无需认证，仅需点击） | 简单 |
실행 흐름
执行流程
이 스킬이 트리거되면 아래 순서로 진행한다.
링크 출력 규칙: 모든 URL은 코드 블록 밖에서 마크다운 링크 형식 으로 표시한다. 코드 블록 안에 URL을 절대 넣지 않는다. 코드 블록 안의 URL은 클릭이 불가능하고 줄바꿈이 발생할 수 있다. 단, JSON 설정 예시의 URL 값은 설정값이므로 코드 블록 안에 표기한다.
[텍스트](URL)触发该技能后，将按照以下顺序执行：
链接输出规则：所有URL需在代码块外以Markdown链接格式 显示，绝对不能放在代码块内。代码块内的URL无法点击且可能出现换行问题。但JSON设置示例中的URL属于配置值，可放在代码块内。
[文本](URL)Phase 0: 현재 연결 상태 진단
Phase 0: 当前连接状态诊断
스킬 시작 시 먼저 현재 연결 상태를 진단한다.
확인 방법:
- ToolSearch로 검색 → Slack 도구 존재 여부 확인
+slack read - ToolSearch로 검색 → Jira MCP 존재 여부 확인. 도구가 있으면
+jira test호출로 실제 연결 확인mcp__jira__test_jira_connection() - ToolSearch로 검색 → Confluence MCP 존재 여부 확인. 도구가 있으면
+confluence test호출로 실제 연결 확인mcp__confluence__test_confluence_connection() - ToolSearch로 검색 → BISKIT MCP 존재 여부 확인. 도구가 있으면
+biskit check_auth호출로 실제 연결 확인mcp__biskit-report-mcp__check_auth_status() - ToolSearch로 검색 → API Docs MCP 존재 여부 확인. 도구가 있으면 연결됨 (인증 불필요이므로 도구 존재 = 연결 성공)
+apidocs search
진단 결과를 테이블로 보여준다:
| 서비스 | 상태 |
|---|---|
| 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 ⚠️ 재연결"만)
技能启动时，首先诊断当前连接状态：
检查方法：
- 通过ToolSearch搜索 → 确认是否存在Slack工具
+slack read - 通过ToolSearch搜索 → 确认是否存在Jira MCP。若存在工具，调用
+jira test验证实际连接情况mcp__jira__test_jira_connection() - 通过ToolSearch搜索 → 确认是否存在Confluence MCP。若存在工具，调用
+confluence test验证实际连接情况mcp__confluence__test_confluence_connection() - 通过ToolSearch搜索 → 确认是否存在BISKIT MCP。若存在工具，调用
+biskit check_auth验证实际连接情况mcp__biskit-report-mcp__check_auth_status() - 通过ToolSearch搜索 → 确认是否存在API Docs MCP。若存在工具则视为已连接（无需认证，工具存在即代表连接成功）
+apidocs search
将诊断结果以表格形式展示：
| 服务 | 状态 |
|---|---|
| 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
根据选择结果执行以下流程：
- 仅选择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)
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로 이동한다.
按照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 연결 (인증 불필요)
Phase 2: API Docs连接（无需认证）
API Docs 설정 가이드에 따라 진행한다. → references/apidocs.md
완료 후:
- MCP 서비스(Jira/Confluence/BISKIT)를 선택했으면 Phase 3으로 이동한다 (재시작은 Phase 3 이후에 한 번만).
- MCP 서비스를 선택하지 않았으면 재시작 안내 후 Phase 5로 이동한다.
按照API Docs设置指南操作 → references/apidocs.md
完成后：
- 若已选择MCP服务（Jira/Confluence/BISKIT），进入Phase 3（仅在Phase 3后重启一次）
- 若未选择MCP服务，提示重启后进入Phase 5
Phase 3: MCP 연결 (Jira / Confluence / BISKIT)
Phase 3: MCP连接（Jira / Confluence / BISKIT）
⚠️ Jira, Confluence, BISKIT MCP는 사내망 또는 VPN 연결이 필요합니다. 연결 상태를 먼저 확인해주세요.
핵심 원칙: 선택한 MCP 서비스(Jira/Confluence/BISKIT)를 모두 한 번에 설정하고, 재시작은 딱 한 번만 한다. (API Docs는 Phase 2에서 이미 처리되었으므로 여기서는 다루지 않는다.)
토큰 발급 → 전체 입력 → 설정 파일 일괄 저장 → 재시작 → 연결 테스트 순서로 진행한다.
⚠️ Jira、Confluence、BISKIT MCP 需要内网或VPN连接，请先确认连接状态。
核心原则：一次性设置所有选中的MCP服务（Jira/Confluence/BISKIT），且仅重启一次（API Docs已在Phase 2处理，此处不再涉及）。
按照“获取令牌 → 统一输入 → 批量保存配置文件 → 重启 → 连接测试”的顺序执行。
Step 1: 선택한 서비스의 토큰 발급 안내 (모두 출력)
Step 1: 提示获取选中服务的令牌（一次性输出所有）
선택한 서비스에 해당하는 토큰 발급 안내를 한 번에 모두 출력한다.
사용자가 브라우저에서 여러 탭을 열어 한꺼번에 발급받을 수 있도록 안내한다.
각 서비스의 상세 토큰 발급 절차는 해당 가이드를 참조한다:
- Jira 선택 시 → references/jira.md
- Confluence 선택 시 → references/confluence.md
- BISKIT 선택 시 → references/biskit.md
一次性输出所有选中服务的令牌获取指南，提示用户可在浏览器中打开多个标签页同时获取。
各服务的详细令牌获取流程请参考对应指南：
- 选择Jira时 → references/jira.md
- 选择Confluence时 → references/confluence.md
- 选择BISKIT时 → references/biskit.md
Step 2: 토큰 전체 입력 (선택한 서비스 모두)
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)한 뒤 설정 파일에 저장한다.
대화에서는 마스킹하여 표시한다.
在令牌获取指南后，通过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: 설정 파일 일괄 업데이트
Step 3: 批量更新配置文件
Read 도구로 설정 파일을 읽고, 객체에 선택한 서비스를 한번에 추가(신규) 또는 덮어쓰기(재연결)한다.
각 서비스의 MCP 설정 JSON은 해당 가이드를 참조한다:
mcpServers- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
추가 후 사용자에게 재시작을 안내한다:
설정 파일의 mcpServers에 {설정한 서비스 목록} 설정이 모두 추가되었습니다!
이제 Claude Code를 한 번 재시작하면 모든 서비스가 동시에 연결됩니다:
- Mac / Linux: → 터미널에서
Ctrl+D실행claude - Windows: 입력 → 터미널에서
exit실행claude
재시작 후 을 입력하면 직전 대화를 이어서 진행할 수 있습니다.
/resume通过Read工具读取配置文件，在对象中一次性添加（新增）或覆盖（重新连接）所有选中的服务。
mcpServers各服务的MCP配置JSON请参考对应指南：
- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
添加完成后，提示用户重启：
配置文件的mcpServers中已成功添加所有{已设置的服务列表}配置！
现在只需重启一次Claude Code，所有服务即可同时连接：
- Mac / Linux：按→ 在终端中执行
Ctrl+Dclaude - Windows：输入→ 在终端中执行
exitclaude
重启后输入即可继续之前的对话。
/resumeStep 4: 재시작 후 연결 테스트 (선택한 서비스 모두)
Step 4: 重启后测试所有选中服务的连接
사용자가 재시작을 완료했다고 (또는 으로 돌아왔다고) 알려주면, 선택한 서비스를 모두 테스트한다.
각 서비스의 연결 테스트 방법은 해당 가이드를 참조한다:
/resume- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
- API Docs (Phase 2에서 설치한 경우) → references/apidocs.md
연결 실패 시 트러블슈팅 → references/troubleshoot.md
当用户告知已完成重启（或通过返回），则测试所有选中的服务。
/resume各服务的连接测试方法请参考对应指南：
- Jira → references/jira.md
- Confluence → references/confluence.md
- BISKIT → references/biskit.md
- API Docs（若在Phase 2中已安装） → references/apidocs.md
连接失败时请参考故障排除指南 → references/troubleshoot.md
Phase 4: 미해결 이슈 등록
Phase 4: 未解决问题登记
트러블슈팅이 진전 없이 막혀있을 때 GitHub 이슈 등록을 제안한다. → references/troubleshoot.md
이후 Phase 5로 진행한다. (이슈 등록 여부와 관계없이 완료 리포트는 출력)
若故障排除后仍无进展，建议提交GitHub问题 → references/troubleshoot.md
之后进入Phase 5（无论是否提交问题，均输出完成报告）。
Phase 5: 완료 리포트
Phase 5: 完成报告
모든 설정이 끝나면 최종 상태를 요약한다.
실제 설정한 서비스만 표시하고, 연결 테스트 결과에 따라 ✅(성공)/❌(실패)를 표시한다.
출력 형식 (코드 블록 없이 마크다운으로):
스마일게이트 커넥터 설정 완료!
연결 상태: (설정한 서비스만 표시)
- {서비스명}: ✅ 연결됨 또는 ❌ 연결 실패
기본 사용법: (연결 성공한 서비스만 표시)
서비스별 예시 문구:
- Slack: "Slack에서 #general 채널 최근 메시지 보여줘", "Slack에서 '배포' 관련 메시지 검색해줘"
- Jira: "나한테 할당된 Jira 이슈 보여줘", "PROJ-123 이슈 상태 알려줘"
- Confluence: "최근 업데이트된 Wiki 페이지 보여줘", "'프로젝트 계획' 관련 문서 검색해줘"
- BISKIT: "카제나 어제 DAU 알려줘", "에픽세븐 이번 주 매출은?"
- API Docs: "결제 관련 API 명세 찾아줘", "사용자 인증 API 스펙 알려줘"
연결 실패한 서비스가 있으면 트러블슈팅 안내를 함께 표시한다.
팁: 토큰이 만료되면 "커넥터 설정해줘" 한 마디로 이 스킬을 다시 실행할 수 있습니다.
所有设置完成后，汇总最终状态：
仅显示实际设置的服务，根据连接测试结果标记✅（成功）/❌（失败）。
输出格式（无需代码块，使用Markdown）：
Smilegate连接器设置完成！
连接状态：（仅显示已设置的服务）
- {服务名}: ✅ 已连接 或 ❌ 连接失败
基本使用方法：（仅显示连接成功的服务）
各服务示例语句：
- Slack：“请展示Slack中#general频道的最新消息”、“请搜索Slack中与‘部署’相关的消息”
- Jira：“请展示分配给我的Jira问题”、“请告知PROJ-123问题的状态”
- Confluence：“请展示最近更新的Wiki页面”、“请搜索与‘项目计划’相关的文档”
- BISKIT：“请告知Kakao昨天的DAU”、“Epic Seven本周的销售额是多少？”
- API Docs：“请查找与支付相关的API规格”、“请告知用户认证API的规格”
若存在连接失败的服务，同时显示故障排除指引。
提示：令牌过期时，只需输入“帮我设置连接器”即可重新运行该技能。
MCP 설정 위치
MCP配置位置
MCP는 항상 전역 설정 파일에 추가한다. OS마다 경로가 다르다:
| OS | 설정 파일 경로 |
|---|---|
| Mac / Linux | |
| Windows | |
전역 설정 파일에 저장하면 모든 프로젝트에서 사용할 수 있다. Git 저장소 밖에 있으므로 토큰이 실수로 커밋될 위험이 없다.
MCP始终添加到全局配置文件中，不同操作系统的路径不同：
| 操作系统 | 配置文件路径 |
|---|---|
| Mac / Linux | |
| Windows | |
保存到全局配置文件后，可在所有项目中使用。 由于文件位于Git仓库外，无需担心令牌被意外提交。