░██████╗░██╗░░░░░░░██╗██╗████████╗ ███╗░░░███╗░█████╗░██████╗░
██╔════╝░██║░░██╗░░██║██║╚══██╔══╝ ████╗░████║██╔══██╗██╔══██╗
╚█████╗░░╚██╗████╗██╔╝██║░░░██║░░░ ██╔████╔██║██║░░╚═╝██████╔╝
░╚═══██╗░░████╔═████║░██║░░░██║░░░ ██║╚██╔╝██║██║░░██╗██╔═══╝░
██████╔╝░░╚██╔╝░╚██╔╝░██║░░░██║░░░ ██║░╚═╝░██║╚█████╔╝██║░░░░░
╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝░░░╚═╝░░░ ╚═╝░░░░░╚═╝░╚════╝░╚═╝░░░░░
🟦 Swit MCP( Model Context Protocol ) Server 🟧
🚀 설정 가이드
1. Swit Developer Console 앱 등록
- https://developers.swit.io 에서 새 앱 생성
- 클라이언트 ID, 시크릿 발급
- 리다이렉트 URI:
http://localhost:3000/callback설정
2. MCP 클라이언트 설정
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"swit": {
"command": "npx",
"args": ["-y", "swit-mcp"],
"env": {
"SWIT_CLIENT_ID": "your-client-id",
"SWIT_CLIENT_SECRET": "your-client-secret"
}
}
}
}
3. 인증 과정
- Claude Desktop에서 첫 Swit 도구 실행 시 OAuth 웹서버가 자동 시작
swit-oauth-start도구 실행하여 인증 URL 획득- 브라우저에서 Swit 계정으로 로그인
- 토큰이 자동으로 저장되며
swit-oauth-status로 확인 가능
🛠️ 사용 가능한 도구
🔐 OAuth 관리
swit-oauth-status- OAuth 인증 상태 확인 및 토큰 정보 조회swit-oauth-start- OAuth 인증 시작 (브라우저 인증 URL 반환)
💼 Swit API 연동
swit-workspace-list- 접근 가능한 워크스페이스 목록 조회swit-channel-list- 지정된 워크스페이스의 채널 목록 조회 (필터링 지원)swit-message-create- 채널에 새 메시지 전송 (텍스트/HTML 지원)swit-message-comment-create- 기존 메시지에 댓글 작성
🎯 활용 예시: Claude에게 "Swit의 개발팀 채널에 프로젝트 진행 상황을 알려줘"라고 요청하면 자동으로 메시지를 전송할 수 있습니다.
기술 스택
- MCP SDK: Model Context Protocol TypeScript SDK
- OAuth: @swit-api/oauth 패키지 사용
- Type Safety: Zod를 활용한 런타임 타입 검증
- Web Server: OAuth 콜백 처리를 위한 Express 내장 웹서버
- Testing: Jest + Nock을 활용한 HTTP mocking 테스트