Használható MCP (előzetes verzió)

A Workable egy munkaerő-kölcsönzési és HR-platform. Ez az MCP-kiszolgáló lehetővé teszi, hogy egy ügynök együttműködjön a felhasználó Munkahelyi fiókjával: böngészhet és kereshet a feladatok között, áttekintheti és végrehajthatja a jelölteket a felvételi folyamaton keresztül, megkeresheti az alkalmazottakat és a szervezeti diagramot, kezelheti az igényléseket, ajánlatokat, részlegeket és tagokat, valamint kezelheti a szabadidejét, az időkövetést és a teljesítményértékeléseket.

Ez az összekötő a következő termékekben és régiókban érhető el:

Szolgáltatás Class Regions
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Kapcsolat
Name Használható támogatás
URL https://help.workable.com/hc/en-us
Összekötő metaadatai
Publisher Megvalósítható
Webhely https://www.workable.com
Adatvédelmi irányelvek https://www.workable.com/privacy
Categories Emberi erőforrások; Termelékenység

Megvalósítható

A Workable egy több mint 30 000 vállalat által használt munkaerő-kölcsönzési és HR-platform, amellyel állásokat tehet közzé, átköltöztetheti a jelölteket egy felvételi folyamaton keresztül, és az alkalmazottakat a felvételük után kezelheti.

A Használható MCP-kiszolgáló hitelesített, engedélytudatos hozzáférést biztosít az ügynököknek az adatokhoz. Az ügynökök válaszolhatnak a nyitott szerepkörökkel és a pályázókkal kapcsolatos kérdésekre, kezelhetik a jelölt folyamatpozícióját, megkereshetik az alkalmazotti és szervezeti diagram adatait, és kezelhetik az igényléseket, ajánlatokat és időtúllépéseket körülvevő jóváhagyási munkafolyamatokat – mindezt bejelentkezett, működőképes felhasználóként, és csak azon belül, amit az adott felhasználó láthat és tehet.

Publisher

Workable Inc

Prerequisites

  • Egy működőképes fiók.
  • Egy működőképes felhasználói fiók. Az eszközök a bejelentkezett felhasználó nevében működnek, így az elérhető adatok és műveletek az adott felhasználó szerepkörétől és engedélyétől függnek a Workable-ben.

Hitelesítő adatok lekérése

A kiszolgáló az OAuth 2.0-t használja. Nem kell kézzel megadnia az API-kulcsot, az ügyfélazonosítót vagy a titkos kulcsot.

A kapcsolat létrehozásakor a rendszer átirányítja a Workable szolgáltatásba a bejelentkezéshez és a kiszolgáló által kért engedélyekhez való hozzájáruláshoz. A használható problémák egy, a felhasználó számára hatókörbe tartozó hozzáférési jogkivonatot ad meg, és a kapcsolat tárolja. A jogkivonatok automatikusan frissülnek; csak akkor jelentkezik be újra, ha visszavonja a hozzáférést, vagy a Munkahelyi rendszergazda eltávolítja a fiókját.

Az engedélyezést bármikor áttekintheti vagy visszavonhatja a Munkahelyi beállítások > integrációiból . A teljes eszközreferenciát a Workable MCP-kiszolgáló dokumentációjában találja.

Ismerkedés az összekötővel

Adja hozzá a Használható MCP-kiszolgálót eszközként az ügynökén, hozzon létre egy kapcsolatot, és jelentkezzen be, amikor a rendszer kéri.

Minden olyan eszköz, amely nem get_accounts argumentumot account használ. A használható felhasználók több fiókhoz is tartozhatnak, ezért az ügynöknek először fel kell hívnia get_accounts az elérni kívánt fiókokat, majd át kell adnia a kiválasztott fiókokat subdomain , mint account minden további hívásnál. A jól viselkedő vezénylők ezt automatikusan elvégzik; ha egyetlen fiókkal dolgozik, érdemes elnevezést adni az ügynök utasításaiban, hogy az ügynöknek ne kelljen megkérdeznie.

Néhány hasznos dolog, amit kipróbálhat, ha egyszer csatlakozik:

  • "Mely jelöltek jelentkeztek a vezető háttérmérnöki szerepkörre ezen a héten, és hol vannak a folyamatban?"
  • "Helyezze át az 12345-ös jelöltet az interjú szakaszba, és adjon hozzá egy megjegyzést a portfóliójukról."
  • "Ki lesz házon kívül a berlini irodában jövő hónapban?"
  • "Mutasd meg a jóváhagyásomra váró igényléseket."
  • "Ki jelent a műszaki igazgatónak?"

A rendelkezésre álló eszközök

A kiszolgáló több mint 100 eszközt tesz elérhetővé. Ezek a következők szerint vannak csoportosítva; az adott üzemelő példány mérvadó listája az, ahonnan a kiszolgáló visszatér tools/list, mivel egy fiók vagy üzembe helyezés eszközei le vannak tiltva.

Terület Az ügynök által elvégezhető műveletek Reprezentatív eszközök
Accounts Elérhető fiókok és a fiók egyéni engedélykészleteinek felderítése get_accounts, get_permission_sets
Jobs Állások, szakaszok, tagok, toborzók, jelentkezési űrlapok és tevékenységelőzmények listázása, keresése és vizsgálata get_jobs, search_jobs, get_job, get_job_stages, get_job_activities
Jelöltek Jelöltek listázása és vizsgálata; létrehozásuk; áthelyezés, másolás, áthelyezés, kizárás vagy ismételt kizárás; megjegyzések, értékelések és értékelések hozzáadása; címkék kezelése és csatolt fájlok olvasása get_candidates, get_candidate, create_candidate, move_candidatedisqualify_candidate, revert_disqualification, add_commentadd_review
Employees Alkalmazottak listázása és vizsgálata, szervezeti diagram és alkalmazotti dokumentumok elolvasása, alkalmazotti rekordok frissítése get_employees, get_employee, get_orgchartupdate_employee
Members Fióktagok listázása, újak meghívása, szerepkörök és engedélyek frissítése, tagok engedélyezése vagy eltávolítása get_members, invite_member, update_memberdelete_member
Igénylések Olvasási igénylések és egyéni attribútumaik; létrehozásuk, frissítésük, jóváhagyásuk és elutasításuk get_requisitions, create_requisition, approve_requisitionreject_requisition
Offers A jelölt ajánlatának elolvasása és jóváhagyása vagy elutasítása get_offer, get_candidate_offer, approve_offerreject_offer
Szabadidő Olvasási egyenlegek, kérelmek és kategóriák; kérések létrehozása; függőben lévők jóváhagyása vagy elutasítása get_timeoff_balances, get_timeoff_requests, create_timeoff_requestupdate_timeoff_approval
Időkövetés Időbejegyzések listázása, létrehozása és frissítése, beleértve a tömeges bejegyzést, valamint a be- vagy kimenő órákat list_time_entries, clock_in, clock_outbulk_create_time_entries
Teljesítményértékelések Ellenőrzési ciklusok, feladatok, űrlapok és eredmények olvasása; ciklussablonok létrehozása; felülvizsgálatok elküldése, megosztása és aláírása get_review_cycles, list_review_tasks, submit_reviewsign_review
Szervezet Részlegek, jogi személyek és munkaütemezések olvasása és kezelése get_departments, create_department, get_legal_entitiesget_work_schedules
Reporting Szűrt keresések futtatása az alkalmazottak és a részletes jelöltrekordok között az elérhető mezők és szűrési beállítások felfedezése után \, \, \
Referenciaadatok Folyamatszakaszok olvasása, kizárási okok, egyéni fiókattribútumok és események olvasása get_stages, get_disqualification_reasons, get_account_custom_attributesget_events

Az írásvédett eszközök így vannak széljegyzetben, az adatokat módosító vagy eltávolító eszközök pedig rombolóként jelennek meg, így az eszközjegyzeteket megjelenítő gazdagépek megerősítést kaphatnak az írás előtt.

Ismert problémák és korlátozások

  • Csak eszközök. A kiszolgáló mcp-eszközöket tesz elérhetővé. Nem tesz közzé MCP-erőforrásokat vagy kéréseket, és nem használ mintavételezést vagy kérést.
  • Csak streamelhető HTTP. A kérelmek JSON-RPC POST a streamelhető HTTP-átvitelen keresztül. Az elavult SSE-átvitel nem támogatott; a GET végpont ad vissza 405.
  • Állapot nélküli. Minden kérést egymástól függetlenül kezelünk. Nincs munkamenet-újraindítás, és a kiszolgáló nem küld értesítéseket az ügyfélnek a hívások között.
  • A többfiókos kezelés explicit. Nincs implicit "folyó fiók". Az argumentum kihagyása account a találgatás helyett meghiúsul, ami szándékos: nem helyreállítható hiba, ha a hibás Workable-fiókon kell eljárni.
  • Az engedélyeket a Workable kényszeríti, nem a kiszolgáló. Az eszközhívások sikeresek lehetnek az egyik felhasználó számára, és egy másikat is elutasíthatnak ugyanazon a fiókon. A megtagadások a korlátozást leíró eszközhibákként térnek vissza; ezek nem összekötőhibák.
  • Lekérdezési korlátok. A hívásokra a Használható API-sebességkorlátok vonatkoznak. A korlátozott sebességű hívások egy hibát adnak vissza, amely arra kéri az ügynököt, hogy rövid várakozás után próbálkozzon újra.
  • Tervfüggő eszközök. A HR-eszközök (alkalmazottak, munkaidő-nyilvántartás, teljesítményértékelések) használatához engedélyezni kell a megfelelő Munkaképes termékeket a fiókban. Csak ATS-fiókban ezek az eszközök "nem találhatók" vagy "tiltott" hibákat ad vissza.

Gyakori hibák és jogorvoslatok

Error Meaning Orvoslat
Nem engedélyezett (401) A hozzáférési jogkivonat hiányzik, érvénytelen vagy lejárt. Jelentkezzen be újra a kapcsolat frissítéséhez.
Hozzáférés megtagadva (403) A jogkivonat érvényes, de előfordulhat, hogy ez a felhasználó vagy fiók nem hajtja végre a műveletet. Ellenőrizze a bejelentkezett felhasználó Működőképes szerepkörét és engedélyeit, és ellenőrizze, hogy a megfelelő termék engedélyezve van-e a fiókban.
Nem található (404) Az erőforrás nem létezik, vagy nem látható a fiók számára. Ellenőrizze, hogy az account altartomány helyes-e, majd kérje le újra az azonosítót tartalmazó listát az érvényes azonosítók lekéréséhez.
Ütközés (409) Az erőforrás olyan állapotban van, amely nem engedélyezi a műveletet – például visszaállít egy olyan jelöltet, aki nincs kizárva. Olvassa újra az erőforrás aktuális állapotát, és ennek megfelelően jár el.
Feldolgozhatatlan (422) A kérést megértettük, de nem sikerült a megadott módon feldolgozni. Ellenőrizze az argumentumértékeket az eszköz sémájában, különösen a számszerű mezőkben, például a szakasznevekben és a kizárási okokban, amelyeket a fiókból kell beolvasni a feltételezett helyett.
Korlátozott ráta (429) Túl sok kérés érkezett a Workable API-hoz. Várjon röviden, és próbálkozzon újra.

GYIK

Melyik Workable-fiókon dolgozik az ügynök? Bármelyik fiók altartományát is adja át argumentumként a account függvény, a visszaadott get_accountsfiókok közül. Az ügynöknek az első adathívása előtt kell hívnia get_accounts .

Láthatja az ügynök azokat az adatokat, amelyekre a bejelentkezett felhasználó nem képes? No. Minden hívás a felhasználó saját hozzáférési jogkivonatával történik, és ugyanazokra az engedélyekre vonatkozik, mint a Workable webalkalmazásra.

Módosíthatja az ügynök az adatokat? Igen, ahol a felhasználó engedélyei lehetővé teszik – például a jelöltek áthelyezését vagy kizárását, az ajánlatok jóváhagyását és a szabadidőt, az alkalmazotti rekordok frissítését és a tagok kezelését. Az írási eszközök így vannak széljegyzetekkel eljegyzve, hogy a gazdagép először megerősítést kérjen.

A képzéshez a jelöltek és az alkalmazottak adatait használják? No. A kiszolgáló a Workable API-val olvassa és írja be a Munkahelyi fiókot, és nem őrzi meg a tartalmat a kérés kiszolgálásához szükségesen túl.

Support

Műveletek

Használható MCP-kiszolgáló

Streamelhető HTTP-végpont a workable MCP-kiszolgálóhoz. A workable recruiting (ATS) és a HR-eszközöket az ügynök számára teszi elérhetővé. Az ügynöknek először fel kell hívnia get_accounts, hogy felderítse a bejelentkezett felhasználó által elérhető fiók altartományokat, majd adja át a kiválasztott altartományt minden más eszköz fiókargumentumaként.

Használható MCP-kiszolgáló

Streamelhető HTTP-végpont a workable MCP-kiszolgálóhoz. A workable recruiting (ATS) és a HR-eszközöket az ügynök számára teszi elérhetővé. Az ügynöknek először fel kell hívnia get_accounts, hogy felderítse a bejelentkezett felhasználó által elérhető fiók altartományokat, majd adja át a kiválasztott altartományt minden más eszköz fiókargumentumaként.

Válaszok

response
object

Definíciók

objektum

Ez az "objektum" típus.