关于 Namely MCP by usefulapi
Namely MCP by usefulapi 为 MCP 客户端提供 Namely 员工资料及组织数据的读取和部分写入能力,适用于人力资源信息查询与员工动态管理。还可更新个人资料、发布公告和评论。
主要功能
- 01查看员工资料、群组和团队
- 02查询职位、职级和报告
- 03读取动态及评论
- 04更新员工资料
- 05发布公告和动态评论
适用场景
- 01查询员工及组织信息
- 02查看职位结构和报告
- 03更新员工档案或发布公告
MCP 相关
作为 MCP 服务,它向客户端公开 Namely 员工资料、群组、团队、职位、动态和报告的读取工具,也支持资料更新、公告发布及评论。客户端通过远程端点连接,并在首次连接时提供站点名称和 Personal Access Token。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://namely.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-namely https://namely.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-namely":{"type":"http","url":"https://namely.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-namely":{"type":"http","url":"https://namely.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-namely":{"type":"http","url":"https://namely.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-namely":{"serverUrl":"https://namely.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 Namely MCP
读取 Namely 员工档案、群组、团队、职位和报告;更新档案、发布动态。
在线端点: https://namely.usefulapi.io/mcp · 主页: https://usefulapi.io/namely
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://namely.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http namely https://namely.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"namely": {
"url": "https://namely.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:该服务会通过 OAuth 为你登录,登录页面会要求你输入 Namely 凭据。
分步设置说明、凭据查找方式和常见问题:https://usefulapi.io/namely/
首次连接时,你需要输入 Namely 站点名称(例如 acme.namely.com 中的 acme)和 个人访问令牌。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
namely_get_me | 读取 | 获取我的档案 |
namely_list_profiles | 读取 | 列出员工档案 |
namely_get_profile | 读取 | 获取员工档案 |
namely_list_profile_fields | 读取 | 列出档案字段 |
namely_list_groups | 读取 | 列出群组 |
namely_get_group | 读取 | 获取群组 |
namely_list_group_types | 读取 | 列出群组类型 |
namely_list_teams | 读取 | 列出团队 |
namely_get_team | 读取 | 获取团队 |
namely_list_job_titles | 读取 | 列出职位名称 |
namely_list_job_tiers | 读取 | 列出职位级别 |
namely_list_events | 读取 | 列出动态事件 |
namely_list_event_comments | 读取 | 列出事件评论 |
namely_get_report | 读取 | 获取报告 |
namely_update_profile | 写入 | 更新员工档案 |
namely_create_announcement | 写入 | 发布公告 |
namely_create_event_comment | 写入 | 评论事件 |
namely_usage_status | 元数据 | 使用情况(免费套餐用量计数) |
namely_request_feature | 元数据 | 申请添加缺失功能 |
namely_upgrade | 元数据 | 升级到 Pro(无限*) |
namely_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应要求确认);meta 工具用于报告使用情况、管理订阅或提交功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 namely_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。你可以随时使用 namely_cancel_subscription 取消:Pro 会持续有效至已付费周期结束,当前周期不予退款;在此之前运行 namely_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Namely 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。