可工作 MCP (预览版)
可工作是一个招聘和人力资源平台。 此 MCP 服务器允许代理使用用户的 Workable 帐户:浏览和搜索作业、通过招聘管道查看和操作候选人、查找员工和组织结构图、管理申请、产品/服务、部门和成员,以及处理休假、时间跟踪、性能评审。
此连接器在以下产品和区域中可用:
| Service | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | 可工作支持 |
| URL | https://help.workable.com/hc/en-us |
| 连接器元数据 | |
|---|---|
| Publisher | 可行的 |
| 网站 | https://www.workable.com |
| 隐私策略 | https://www.workable.com/privacy |
| Categories | 人力资源;生产力 |
可行的
Workable 是一个招聘和人力资源平台,由 30,000 多家公司用来发布工作、通过招聘管道移动候选人,并在员工被雇用后管理员工。
Workable MCP 服务器为代理提供对该数据进行身份验证的权限感知访问权限。 代理可以回答有关开放角色和申请人的问题,对候选人的管道职位采取行动,查找员工和组织结构图信息,并处理围绕申请、套餐和休假的审批工作流,这一切都是已登录的 Workable 用户,并且仅在允许用户查看和执行的操作范围内。
Publisher
Workable Inc
Prerequisites
- 可工作帐户。
- 可工作用户帐户。 这些工具代表已登录用户进行操作,因此可用的数据和操作取决于该用户在 Workable 中的角色和权限。
如何获取凭据
服务器使用 OAuth 2.0。 无需手动输入 API 密钥、客户端 ID 或机密。
创建连接时,会重定向到 Workable 以登录并同意服务器请求的权限。 可工作颁发限定于用户的访问权限令牌,连接存储该令牌。 令牌会自动刷新;仅当撤销访问权限或 Workable 管理员删除帐户时,才再次登录。
可以随时从 Workable 中的“设置集成”>中查看或撤销授权。 有关完整的工具参考,请参阅 Workable MCP 服务器文档。
连接器入门
将 Workable MCP 服务器添加为代理上的工具,创建连接,并在出现提示时登录。
除采用参数account以外的get_accounts每个工具。 Workable 用户可以属于多个帐户,因此代理必须首先调用 get_accounts 以列出其可访问的帐户,然后在每次后续调用中传递所选帐户 subdomain 的帐户 account 。 行为良好的业务流程协调程序会自动执行此操作;如果使用的是单个帐户,则值得在代理的说明中对其进行命名,以便代理无需询问。
连接后要尝试的一些有用事项:
- “本周哪些候选人申请了高级后端工程师角色,他们在哪里在管道中?
- “将候选人12345转移到面试阶段,并添加一份关于他们的投资组合的笔记。
- “下个月谁在柏林办公室外出?
- “向我展示等待审批的征用。
- “谁向工程副总裁报告?
可用工具
服务器只公开了 100 多个工具。 它们按如下方式分组:给定部署的权威列表是服务器从 tools/list中返回的任何内容,因为帐户或部署可能已禁用工具。
| 区域 | 代理可以执行的操作 | 代表工具 |
|---|---|---|
| Accounts | 发现可访问帐户和帐户的自定义权限集 |
get_accounts、get_permission_sets |
| Jobs | 列出、搜索和检查作业、其阶段、成员、招聘人员、应用程序表单和活动历史记录 |
get_jobs、search_jobs、get_job、get_job_stages、get_job_activities |
| 应聘者 | 列出和检查候选项;创建它们;移动、复制、重定位、取消资格或重新限定它们;添加注释、评估和评级;管理标记和读取附加文件 |
get_candidates、get_candidate、create_candidate、move_candidate、disqualify_candidate、revert_disqualification、add_comment、add_review |
| Employees | 列出并检查员工、读取组织结构图和员工文档、更新员工记录 |
get_employees、get_employee、get_orgchart、update_employee |
| Members | 列出帐户成员、邀请新成员、更新角色和权限、启用或禁用成员 |
get_members、invite_member、update_member、delete_member |
| 申请 | 读取申请及其自定义属性;创建、更新、批准和拒绝它们 |
get_requisitions、create_requisition、approve_requisition、reject_requisition |
| Offers | 阅读候选人的报价并批准或拒绝 |
get_offer、get_candidate_offer、approve_offer、reject_offer |
| 休假 | 读取余额、请求和类别;创建请求;批准或拒绝挂起的审批 |
get_timeoff_balances、get_timeoff_requests、create_timeoff_request、update_timeoff_approval |
| 时间跟踪 | 列出、创建和更新时间条目,包括批量输入和时钟传入或传出 |
list_time_entries、clock_in、clock_out、bulk_create_time_entries |
| 性能评审 | 读取评审周期、任务、表单和结果;创建周期模板;提交、共享和签名评审 |
get_review_cycles、list_review_tasks、submit_review、sign_review |
| 组织 | 读取和管理部门、法律实体和工作计划 |
get_departments、create_department、get_legal_entities、get_work_schedules |
| 报告 | 发现可用字段和筛选选项后,对员工和详细候选人记录运行筛选搜索 |
get_employee_fields、search_employees、search_candidates_detailed |
| 参考数据 | 读取管道阶段、取消资格原因、帐户自定义属性和事件 |
get_stages、get_disqualification_reasons、get_account_custom_attributes、get_events |
只读工具进行批注,更改或删除数据的工具将注释为破坏性,因此显示工具批注的主机可以在写入前提示确认。
已知问题和限制
- 仅工具。 服务器公开 MCP 工具。 它不会发布 MCP 资源或提示,也不会使用采样或引证。
- 仅可流式传输的 HTTP。 请求通过
POST可流式传输 HTTP 传输 JSON-RPC。 不支持弃用的 SSE 传输;aGET到终结点返回405。 - 无状态。 每个请求都是独立处理的。 没有会话恢复,服务器不会在调用之间向客户端推送通知。
- 多帐户处理是显式的。 没有隐式“当前帐户”。 省略争论
account失败,而不是猜测,这是故意的:对错误的 Workable 帐户采取行动不是一个可恢复的错误。 - 权限由 Workable 而不是服务器强制实施。 对于一个用户,工具调用可能会成功,并且在同一帐户上拒绝另一个用户。 拒绝作为描述限制的工具错误返回;它们不是连接器故障。
- 速率限制。 调用受 Workable API 速率限制的约束。 速率限制调用返回一个错误,要求代理在短暂等待后重试。
- 依赖于计划的工具。 HR 工具(员工、休假、时间跟踪、绩效评审)要求在帐户上启用相应的 Workable 产品。 在仅 ATS 帐户上,这些工具返回“找不到”或“禁止”错误。
常见错误和补救措施
| Error | Meaning | 纠正方法 |
|---|---|---|
| 未授权 (401) | 访问令牌缺失、无效或已过期。 | 再次登录以刷新连接。 |
| 禁止 (403) | 令牌有效,但此用户或帐户可能无法执行该操作。 | 检查已登录用户的 Workable 角色和权限,并确认是否已在帐户上启用相关产品。 |
| 找不到 (404) | 资源不存在或对此帐户不可见。 |
account确认子域正确,然后重新提取 ID 来自的列表以获取有效的 ID。 |
| 冲突 (409) | 资源处于不允许操作的状态,例如,还原未取消资格的候选项。 | 重新读取资源的当前状态并相应地采取行动。 |
| 无法处理 (422) | 已理解请求,但无法按给定方式处理。 | 根据工具的架构检查参数值,尤其是类似于枚举的字段,例如阶段名称和取消资格原因,应从帐户中读取这些参数值,而不是假定这些字段。 |
| 速率限制 (429) | 对 Workable API 的请求过多。 | 请短暂等待,然后重试。 |
FAQ
代理会处理哪些工作帐户?
无论哪个帐户子域作为 account 参数传递,都不是由该子域返回的 get_accounts子域。 代理应在第一次数据调用之前调用 get_accounts 。
代理能否看到已登录用户无法看到的数据? No. 每次调用都使用用户自己的访问令牌进行,并且受到与 Workable Web 应用相同的权限。
代理是否可以更改数据? 是的,用户的权限允许它,例如移动或取消候选人资格、批准套餐和休假、更新员工记录和管理成员。 写入的工具会进行批注,以便主机可以先请求确认。
候选人和员工数据是否用于培训? No. 服务器通过 Workable API 读取和写入 Workable 帐户,并且不会保留超出为请求提供服务所需的内容。
Support
- 文档: 可工作 MCP 服务器参考
- 支持: 可行的帮助中心
- 条款和条件: 可行的条款
操作
| 可工作 MCP 服务器 |
Workable MCP 服务器的可流式传输 HTTP 终结点。 向代理公开 Workable 招聘(ATS)和 HR 工具。 代理应首先调用get_accounts来发现登录用户可以访问的帐户子域,然后将所选的子域作为所有其他工具的帐户参数传递。 |
可工作 MCP 服务器
Workable MCP 服务器的可流式传输 HTTP 终结点。 向代理公开 Workable 招聘(ATS)和 HR 工具。 代理应首先调用get_accounts来发现登录用户可以访问的帐户子域,然后将所选的子域作为所有其他工具的帐户参数传递。
返回
- 响应
- object
定义
对象
这是类型“object”。