可行的 MCP(預覽)

Workable 是一個招聘與人力資源平台。 此 MCP 伺服器讓客服人員能操作使用者的 Workable 帳戶:瀏覽與搜尋職缺、審查並處理招聘流程中的候選人、查詢員工及組織架構圖、管理職缺、錄取、部門與成員,並處理休假、時間追蹤、績效評估。

此連接器適用於以下產品和區域:

服務 Class Regions
Copilot Studio 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
聯絡方式
Name 可行的支援
URL https://help.workable.com/hc/en-us
連接器中繼資料
Publisher 可行的
網站 https://www.workable.com
隱私權原則 https://www.workable.com/privacy
類別 人力資源;生產力

可行的

Workable 是一個招聘與人力資源平台,被超過 30,000 家公司用來發布職缺、引導候選人通過招聘管道,以及在員工被錄取後管理。

可行的 MCP 伺服器提供代理程式認證且權限感知的存取權限。 客服人員可以回答有關職缺與應徵者的問題,處理候選人的流程位置,查詢員工及組織架構資訊,並處理與職缺、邀約及休假相關的核准流程——所有這些都只能以登入的可行使用者身份,且僅限於該使用者被允許看到和執行的範圍內。

Publisher

可行公司

Prerequisites

  • 一個可行的帳戶。
  • 一個可操作的使用者帳號。 這些工具代表已登入的使用者行動,因此可用的資料和動作取決於該使用者在 Workable 中的角色與權限。

如何取得認證

伺服器使用 OAuth 2.0。 不需要手動輸入 API 金鑰、客戶端 ID 或秘密資料。

當你建立連線時,會被導向 Workable 登入並同意伺服器請求的權限。 Workable 會發出一個權限,權限限定給你的使用者,連線會儲存它。 代幣會自動刷新;只有當你撤銷存取權或你的 Workable 管理員移除你的帳號時,你才會重新登入。

你可以隨時從 Workable 的 設定 > 整合 中檢視或撤銷授權。 完整工具參考請參閱 可行的 MCP 伺服器文件。

開始使用連接器

在代理程式上新增可行的 MCP 伺服器作為工具,建立連線,並在提示時登入。

除了所有工具 get_accounts 外,都需要一個 account 論證。 可操作的使用者可以同時擁有多個帳號,因此客服人員必須先打電話get_accounts列出可聯絡的帳號,然後在每次通話中都依照account所選帳subdomain號的帳號轉交。 行為良好的協調者會自動做到這點;如果你只用單一帳戶,建議在經紀人說明中標明,這樣經紀人就不用再問。

連接後可以嘗試一些有用的方法:

  • 「本週有哪些候選人申請了資深後端工程師的職位?他們目前在哪個階段?」
  • 「將候選人12345移至面試階段,並附上關於其作品集的說明。」
  • 「下個月柏林辦公室誰不在辦公室?」
  • 「給我看申請表,等我批准。」
  • 「誰向工程副總裁報告?」

可用工具

伺服器上有超過 100 種工具。 它們被分組如下;某個部署的權威清單是伺服器從 回傳的 tools/list,因為帳號或部署可能被停用了工具。

Area 代理人能做的事 代表性工具
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
Reporting 在發現可用欄位與篩選選項後,對員工及詳細候選人紀錄進行篩選搜尋 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 API 速率限制。 有速率限制的通話會回傳錯誤,要求客服人員在短暫等待後重試。
  • 依計畫而定的工具。 人力資源工具(員工、休假、時間追蹤、績效評估)需要在帳戶上啟用相應的可行產品。 在僅支援 ATS 的帳號中,這些工具會回傳「找不到」或「禁止」錯誤。

常見錯誤和補救措施

錯誤 Meaning 補救方法
未經授權 (401) 存取權杖遺失、無效或已過期。 請再次登入以刷新連線。
禁止 (403) 該令牌有效,但此使用者或帳號不得執行該動作。 檢查已登入使用者的可行角色和權限,並確認該帳號已啟用相關產品。
未找到(404) 該資源不存在或對此帳號無法顯示。 確認 account 子網域正確,然後重新取得該 ID 來源的清單,取得有效的 ID。
衝突 (409) 該資源處於不允許該行動的州——例如,撤銷未被取消資格的候選人。 重新閱讀資源的現況並依此採取行動。
不可處理(422) 這個請求被理解了,但無法依照既定條件處理。 檢查參數值與工具架構上的差異,特別是類枚舉欄位,例如階段名稱和不合格理由,這些應該直接從帳號讀取,而非假設。
費率有限(429) 對 Workable API 的請求太多。 稍作等待,再重試。

FAQ

代理人會對哪個可行帳戶採取行動? 從 返回get_accounts的參數中,從傳遞的 參數中,取出被傳遞為account參數的帳戶子網域。 客服人員應該在第一次通話前先撥打 get_accounts 電話。

客服人員能看到登入用戶看不到的資料嗎? No. 每次通話皆使用使用者自己的存取權杖,權限與 Workable 網頁應用程式相同。

客服人員可以更改資料嗎? 是的,只要使用者權限允許——例如調動或取消候選人資格、核准邀約與休假、更新員工紀錄及管理會員。 寫入工具會標註,讓主機先請求確認。

候選人和員工資料會用於訓練嗎? No. 伺服器透過 Workable API 讀寫你的 Workable 帳號,且不會保留超出服務請求所需的內容。

Support

動作

可行的 MCP 伺服器

可串流的 HTTP 端點用於可運作的 MCP 伺服器。 讓業務員掌握可行的招聘(ATS)及人力資源工具。 代理應該先呼叫get_accounts,以發現登入使用者可存取的帳號子網域,然後將所選子網域作為其他工具的帳號參數傳遞。

可行的 MCP 伺服器

可串流的 HTTP 端點用於可運作的 MCP 伺服器。 讓業務員掌握可行的招聘(ATS)及人力資源工具。 代理應該先呼叫get_accounts,以發現登入使用者可存取的帳號子網域,然後將所選子網域作為其他工具的帳號參數傳遞。

傳回

response
object

定義

物件

這是類型 'object'。