SmartHR MCP by usefulapi

Name: SmartHR MCP by usefulapi
Author: usefulapi.io

远程服务

usefulapi.io商业与营销1今天更新

代码仓库访问官网

关于 SmartHR MCP by usefulapi

SmartHR MCP by usefulapi 将 SmartHR 账户连接到 MCP 客户端，用于员工和组织数据操作。它提供员工记录及相关类别的查询工具，也可创建或更新员工、部门和被扶养人信息。

主要功能

01列出并获取员工记录
02查询被扶养人、部门和职位类别
03创建或更新员工和部门
04创建被扶养人并邀请员工

适用场景

01查询员工或部门信息
02维护员工和部门记录
03邀请员工并登记被扶养人

MCP 相关

通过远程端点向 MCP 客户端提供 SmartHR 查询和写入工具，并使用 OAuth 登录。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://smarthr.usefulapi.io/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http io-usefulapi-smarthr https://smarthr.usefulapi.io/mcp

Cursor.cursor/mcp.json{"mcpServers":{"io-usefulapi-smarthr":{"type":"http","url":"https://smarthr.usefulapi.io/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"io-usefulapi-smarthr":{"type":"http","url":"https://smarthr.usefulapi.io/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"io-usefulapi-smarthr":{"type":"http","url":"https://smarthr.usefulapi.io/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"io-usefulapi-smarthr":{"serverUrl":"https://smarthr.usefulapi.io/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

usefulapi 的 SmartHR MCP

连接已启用 API 的 SmartHR 账户。

连接

Claude（claude.ai、Desktop）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://smarthr.usefulapi.io/mcp。
**Claude Code：**运行 claude mcp add --transport http smarthr https://smarthr.usefulapi.io/mcp，然后运行 /mcp 登录。
VS Code：添加到 VS Code。
**Cursor 和其他客户端：**将 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "smarthr": {
      "url": "https://smarthr.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 SmartHR 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/smarthr/

工具

工具	类型	功能
`smarthr_list_employees`	read	列出员工
`smarthr_get_employee`	read	获取员工信息
`smarthr_list_dependents`	read	列出员工的受抚养人
`smarthr_list_maternity_childcare_leaves`	read	列出员工的产假和育儿假
`smarthr_list_departments`	read	列出部门
`smarthr_get_department`	read	获取部门信息
`smarthr_list_positions`	read	列出职位
`smarthr_list_employment_types`	read	列出雇佣类型
`smarthr_list_grades`	read	列出职级
`smarthr_list_job_categories`	read	列出工作类别
`smarthr_list_companies`	read	列出公司
`smarthr_list_business_establishments`	read	列出营业场所
`smarthr_list_employee_custom_fields`	read	列出员工自定义字段定义
`smarthr_list_dependent_relations`	read	列出受抚养人关系
`smarthr_list_users`	read	列出用户
`smarthr_list_employee_input_forms`	read	列出员工信息填写表单
`smarthr_list_webhooks`	read	列出 Webhook
`smarthr_create_employee`	write	创建员工
`smarthr_update_employee`	write	更新员工
`smarthr_create_department`	write	创建部门
`smarthr_update_department`	write	更新部门
`smarthr_create_dependent`	write	创建受抚养人
`smarthr_invite_employee`	write	通过电子邮件邀请员工
`smarthr_usage_status`	meta	使用情况状态（免费套餐用量计数）
`smarthr_request_feature`	meta	申请添加缺失功能
`smarthr_upgrade`	meta	升级到 Pro 或 Pro+
`smarthr_cancel_subscription`	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先确认）；meta 工具用于报告使用情况、管理订阅或提交功能申请。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（每个 SmartHR 租户）	$9/月或 $90/年（免费 2 个月）	无限次*

*此服务上的 Pro 公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 smarthr_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 smarthr_cancel_subscription 取消：Pro 将持续到付费周期结束，当前周期不予退款；在此之前运行 smarthr_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。