Includes an embedded Express web server to handle OAuth authentication callbacks
Employs Jest for testing the MCP server functionality
Uses TypeScript SDK for implementing the Model Context Protocol
Uses Zod for runtime type validation of API responses and requests
🚀 설정 가이드
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
:
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 테스트
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that integrates with Swit collaboration tools, allowing LLM clients to interact with Swit workspaces, channels, and messages through OAuth authentication.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to interact with Salesforce data through SOQL queries, SOSL searches, and various API operations including record management.Last updated -1077PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that allows LLMs to interact with web content through standardized tools, currently supporting web scraping functionality.Last updated -PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to interact with Git repositories, providing tools to read, search, and manipulate Git repositories through commands like status, diff, commit, and branch management.Last updated -PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to interact with Git repositories, providing tools to read, search, and manipulate Git repositories through commands like status, diff, commit, and branch operations.Last updated -22PythonMIT License