可行的 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 傳輸不被支援;aGET返回端點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 伺服器參考
- 支援: 可行的幫助中心
- 條款與條件: 可行條款
動作
| 可行的 MCP 伺服器 |
可串流的 HTTP 端點用於可運作的 MCP 伺服器。 讓業務員掌握可行的招聘(ATS)及人力資源工具。 代理應該先呼叫get_accounts,以發現登入使用者可存取的帳號子網域,然後將所選子網域作為其他工具的帳號參數傳遞。 |
可行的 MCP 伺服器
可串流的 HTTP 端點用於可運作的 MCP 伺服器。 讓業務員掌握可行的招聘(ATS)及人力資源工具。 代理應該先呼叫get_accounts,以發現登入使用者可存取的帳號子網域,然後將所選子網域作為其他工具的帳號參數傳遞。
傳回
- response
- object
定義
物件
這是類型 'object'。