░██████╗░██╗░░░░░░░██╗██╗████████╗  ███╗░░░███╗░█████╗░██████╗░
  ██╔════╝░██║░░██╗░░██║██║╚══██╔══╝  ████╗░████║██╔══██╗██╔══██╗
  ╚█████╗░░╚██╗████╗██╔╝██║░░░██║░░░  ██╔████╔██║██║░░╚═╝██████╔╝
  ░╚═══██╗░░████╔═████║░██║░░░██║░░░  ██║╚██╔╝██║██║░░██╗██╔═══╝░
  ██████╔╝░░╚██╔╝░╚██╔╝░██║░░░██║░░░  ██║░╚═╝░██║╚█████╔╝██║░░░░░
  ╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝░░░╚═╝░░░  ╚═╝░░░░░╚═╝░╚════╝░╚═╝░░░░░

🚀 설정 가이드

1. Swit Developer Console 앱 등록

1. https://developers.swit.io 에서 새 앱 생성

2. 클라이언트 ID, 시크릿 발급

3. 리다이렉트 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. 인증 과정

1. Claude Desktop에서 첫 Swit 도구 실행 시 OAuth 웹서버가 자동 시작

2. swit-oauth-start 도구 실행하여 인증 URL 획득

3. 브라우저에서 Swit 계정으로 로그인

4. 토큰이 자동으로 저장되며 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 테스트