关于 Smartplan MCP by usefulapi
Smartplan MCP by usefulapi 将 Smartplan 账户连接到 MCP 客户端,用于查询人员排班数据。只读工具涵盖账户、员工、地点、班次、工时记录和缺勤,并通过托管 OAuth 流程授权。
主要功能
- 01查看已连接账户和成员
- 02浏览地点和工作类型
- 03列出并获取班次
- 04查询工时记录和缺勤
适用场景
- 01检查即将到来的班次和员工信息
- 02查看已记录的工作时长
- 03查询员工缺勤日期
MCP 相关
通过远程端点向 MCP 客户端提供 Smartplan 只读工具,并使用 Smartplan 凭据完成托管授权。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://smartplan.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-smartplan https://smartplan.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-smartplan":{"type":"http","url":"https://smartplan.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-smartplan":{"serverUrl":"https://smartplan.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 Smartplan MCP
远程 MCP 端点:https://smartplan.usefulapi.io/mcp
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://smartplan.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http smartplan https://smartplan.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code:添加到 VS Code。
- **Cursor 和其他客户端:**将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"smartplan": {
"url": "https://smartplan.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Smartplan 凭据。
分步设置说明、凭据查找位置和常见问题:https://usefulapi.io/smartplan/
使用 Smartplan 凭据,通过托管授权流程进行连接。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
smartplan_list_accounts | read | 显示已连接的账户 |
smartplan_get_account | read | 获取已连接的账户 |
smartplan_list_members | read | 列出成员 |
smartplan_get_member | read | 获取成员 |
smartplan_list_locations | read | 列出地点 |
smartplan_get_location | read | 获取地点 |
smartplan_list_jobtypes | read | 列出工作角色 |
smartplan_get_jobtype | read | 获取工作类型 |
smartplan_list_shifts | read | 列出即将开始的班次 |
smartplan_get_shift | read | 获取班次 |
smartplan_list_worklogs | read | 列出已记录的工时日志 |
smartplan_get_worklog | read | 获取工时日志 |
smartplan_list_absences | read | 列出缺勤日期 |
smartplan_get_absence | read | 获取缺勤记录 |
smartplan_usage_status | meta | 使用情况状态(免费套餐用量计数) |
smartplan_request_feature | meta | 申请添加缺失的功能 |
smartplan_upgrade | meta | 升级到 Pro 或 Pro+ |
smartplan_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或提交功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(每个账户) | $9/mo 或 $90/yr(免费 2 个月) | 无限* |
*此服务上的 Pro 套餐公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 smartplan_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 smartplan_cancel_subscription 取消:Pro 服务会持续到已付费期限结束;当前期限不予退款;在此之前运行 smartplan_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
请参阅仓库许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。