Swit MCP Server

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

🟦 Swit MCP( Model Context Protocol ) Server 🟧

🚀 设置指南

1.Swit开发者控制台앱 등록

1. https://developers.swit.io在中创建新应用程序
2. 客户端ID，秘密发放
3. 重定向URI： http://localhost:3000/callback 设置

2.MCP客户端设置

克劳德桌面

~/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桌面上运行第一个Swit工具时，OAuth Web服务器将自动启动
2. swit-oauth-start 运行工具获取验证URL
3. 在浏览器中登录到Swit帐户
4. 令牌将自动保存。 swit-oauth-status可通过确认

🛠️ 可用工具

🔐 OAuth管理

• swit-oauth-status -检查OAuth身份验证状态和查看令牌信息
• swit-oauth-start -启动OAuth身份验证（返回浏览器身份验证URL）

💼 瑞士API연동

• swit-workspace-list -查看可访问的工作空间列表
• swit-channel-list -查看指定工作空间的频道列表（支持过滤）
• swit-message-create -向频道发送新消息（支持文本/HTML）
• swit-message-comment-create -对现有消息进行评论

🎯 使用示例：如果您要求Claude“告诉Swit的开发团队渠道项目进展情况”，您可以自动发送消息。

技术堆栈

• MCP-SDK：模型上下文协议TypeScript SDK
• OAuth：使用@swit-api/oauth包
• 类型安全：使用Zod验证运行时类型
• Web服务器：用于OAuth回调处理的Express嵌入式Web服务器
• 测试：使用Jest+Nock测试HTTP mocking