Brand Cast Signage

ZoomShift MCP服务器

](https://www.npmjs.com/package/@brandcast_app/zoomshift-mcp-server) 

用于ZoomShift员工调度的模型上下文协议服务器。使Claude Desktop和其他MCP客户端能够通过自然语言与ZoomShift计划进行交互。

特性

• 📅 查看日程表 -获取任何日期范围内的员工轮班
• 👥 员工管理 -列出员工及其职位
• 📍 位置跟踪 -查看日程表中的所有位置
• 🔍 智能搜索 -按员工、角色或位置搜索班次
• 🤖 AI驱动 -通过Claude Desktop的自然语言界面
• 🔒 安全 -基于环境的凭证管理

安装

npx快速入门（推荐）

无需安装！配置Claude Desktop以通过npx使用服务器：

{
  "mcpServers": {
    "zoomshift": {
      "command": "npx",
      "args": ["-y", "@brandcast_app/zoomshift-mcp-server"],
      "env": {
        "ZOOMSHIFT_EMAIL": "your@email.com",
        "ZOOMSHIFT_PASSWORD": "your-password",
        "ZOOMSHIFT_SCHEDULE_ID": "your-schedule-id"
      }
    }
  }
}

全球安装

npm install -g @brandcast_app/zoomshift-mcp-server

配置

查找您的日程ID

当您登录ZoomShift时，您的ZoomShift日程ID可以在URL中找到：

https://app.zoomshift.com/58369/dashboard
                          ^^^^^
                    This is your schedule ID

Claude桌面设置

1. 打开您的Claude Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加ZoomShift MCP服务器配置：

{
  "mcpServers": {
    "zoomshift": {
      "command": "npx",
      "args": ["-y", "@brandcast_app/zoomshift-mcp-server"],
      "env": {
        "ZOOMSHIFT_EMAIL": "your@email.com",
        "ZOOMSHIFT_PASSWORD": "your-password",
        "ZOOMSHIFT_SCHEDULE_ID": "58369"
      }
    }
  }
}

1. 重新启动克劳德桌面

用法

配置后，您可以在Claude Desktop中使用自然语言与ZoomShift进行交互：

示例提示

"Show me all shifts for next week"
"Who is working tomorrow?"
"Find all shifts for John Smith this month"
"List all employees in the schedule"
"What locations do we have?"
"Search for server shifts this week"

可用工具

服务器提供了6个Claude可以使用的MCP工具：

1. zoomshift_get_shifts

获取某一日期范围内的所有班次。

参数：

• start_date （字符串）：YYYY-MM-DD格式的开始日期
• end_date （字符串）：YYYY-MM-DD格式的结束日期

2. zoomshift_get_employee_shifts

为特定员工安排轮班。

参数：

• employee_id （string）：员工ID
• start_date （字符串）：YYYY-MM-DD格式的开始日期
• end_date （字符串）：YYYY-MM-DD格式的结束日期

3. zoomshift_get_locations

获取日程表中的所有位置。

4. zoomshift_get_employees

让所有员工都在日程表中。

5. zoomshift_get_positions

获取日程表中的所有职位/角色。

6. zoomshift_search_shifts

按员工姓名、角色或位置搜索班次。

参数：

• query （string）：搜索查询
• start_date （字符串）：YYYY-MM-DD格式的开始日期
• end_date （字符串）：YYYY-MM-DD格式的结束日期

发展

从源头构建

git clone https://github.com/BrandCast-Signage/zoomshift-mcp-server.git
cd zoomshift-mcp-server
npm install
npm run build

本地运行

ZOOMSHIFT_EMAIL="your@email.com" \
ZOOMSHIFT_PASSWORD="your-password" \
ZOOMSHIFT_SCHEDULE_ID="58369" \
node dist/index.js

建筑

此MCP服务器使用：

• 运输：stdio（标准输入/输出）
• 协议：模型上下文协议（MCP）
• API客户端: @brandcast_app/zoomshift api客户端
• 运行时：Node.js 18+

故障排除

“缺少必需的环境变量”

确保在Claude Desktop配置中设置了所有三个环境变量：

• ZOOMSHIFT_EMAIL
• ZOOMSHIFT_PASSWORD
• ZOOMSHIFT_SCHEDULE_ID

“身份验证失败”

验证您的ZoomShift凭据是否正确。尝试手动登录ZoomShift进行确认。

“找不到计划ID”

仔细检查ZoomShift URL中的日程ID。它应该是一个数字（例如“58369”）。

服务器未出现在Claude Desktop中

1. 验证配置文件语法是否为有效的JSON
2. 完全重新启动克劳德桌面
3. 检查Claude Desktop日志是否有错误

安全

• 凭据通过环境变量传递（从未硬编码）
• 在ZoomShift中使用基于会话的身份验证
• 无凭据缓存或持久性
• 遵循MCP安全最佳实践

相关项目

• @brandcast_app/zoomshift api客户端 -ZoomShift API的TypeScript客户端
• 模型上下文协议 -MCP规范

BrandCast集成

如果您是BrandCast客户，您可以使用 集成版本 这不需要手动配置：

{
  "mcpServers": {
    "zoomshift": {
      "url": "https://dev.brandcast.app/mcp/zoomshift",
      "transport": "http",
      "oauth": {
        "enabled": true
      }
    }
  }
}

此版本使用OAuth，凭据通过BrandCast平台进行管理。

支持

• 问题:
• 文档: MCP协议
• API客户端: zoomshift api客户端文档

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

致谢

内置：

• 模型上下文协议SDK
• @brandcast_app/zoomshift api客户端

______________________________________________________________________

备注：这是一种非正式的整合。与ZoomShift无关或不受其认可。

由以下材料制成❤️ BrandCast团队