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
POSTa streamelhető HTTP-átvitelen keresztül. Az elavult SSE-átvitel nem támogatott; aGETvégpont ad vissza405. - Á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
accounta 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
- Dokumentáció: Használható MCP-kiszolgáló referenciája
- Támogatás: Használható súgóközpont
- Használati feltételek: Használható feltételek
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.