可工作 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 传输;a GET 到终结点返回 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 服务器

Workable MCP 服务器的可流式传输 HTTP 终结点。 向代理公开 Workable 招聘(ATS)和 HR 工具。 代理应首先调用get_accounts来发现登录用户可以访问的帐户子域,然后将所选的子域作为所有其他工具的帐户参数传递。

可工作 MCP 服务器

Workable MCP 服务器的可流式传输 HTTP 终结点。 向代理公开 Workable 招聘(ATS)和 HR 工具。 代理应首先调用get_accounts来发现登录用户可以访问的帐户子域,然后将所选的子域作为所有其他工具的帐户参数传递。

返回

响应
object

定义

对象

这是类型“object”。