使用说明
░██████╗░██╗░░░░░░░██╗██╗████████╗ ███╗░░░███╗░█████╗░██████╗░
██╔════╝░██║░░██╗░░██║██║╚══██╔══╝ ████╗░████║██╔══██╗██╔══██╗
╚█████╗░░╚██╗████╗██╔╝██║░░░██║░░░ ██╔████╔██║██║░░╚═╝██████╔╝
░╚═══██╗░░████╔═████║░██║░░░██║░░░ ██║╚██╔╝██║██║░░██╗██╔═══╝░
██████╔╝░░╚██╔╝░╚██╔╝░██║░░░██║░░░ ██║░╚═╝░██║╚█████╔╝██║░░░░░
╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝░░░╚═╝░░░ ╚═╝░░░░░╚═╝░╚════╝░╚═╝░░░░░
🚀 设置指南
1.Swit开发者控制台앱 등록
- https://developers.swit.io在中创建新应用程序
- 客户端ID，秘密发放
- 重定向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.认证过程
- 在Claude桌面上运行第一个Swit工具时，OAuth Web服务器将自动启动
swit-oauth-start运行工具获取验证URL- 在浏览器中登录到Swit帐户
- 令牌将自动保存。
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