Werkbare MCP (preview)
Workable is een hr-platform voor inhuren en hr. Met deze MCP-server kan een agent werken met het werkbare account van een gebruiker: door taken bladeren en zoeken, kandidaten beoordelen en actie ondernemen via de pijplijn voor het inhuren, werknemers en het organigram opzoeken, aanvragen, aanbiedingen, afdelingen en leden beheren en verlof, tijd bijhouden, prestatiebeoordelingen afhandelen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Name | Werkbare ondersteuning |
| URL | https://help.workable.com/hc/en-us |
| Connectormetagegevens | |
|---|---|
| Publisher | Werkbaar |
| Website | https://www.workable.com |
| Privacybeleid | https://www.workable.com/privacy |
| Categorieën | Personeel; Productiviteit |
Werkbaar
Workable is een hr-platform dat door meer dan 30.000 bedrijven wordt gebruikt om taken te posten, kandidaten te verplaatsen via een pijplijn voor inhuren en werknemers te beheren zodra ze zijn ingehuurd.
De Workable MCP-server biedt een geverifieerde, machtigingsbewuste agenttoegang tot die gegevens. Een agent kan vragen beantwoorden over openstaande rollen en aanvragers, handelen op de pijplijnpositie van een kandidaat, werknemers- en organigramgegevens opzoeken en de goedkeuringswerkstromen verwerken die betrekking hebben op aanvragen, aanbiedingen en verlof , allemaal als de aangemelde Workable-gebruiker, en alleen binnen wat die gebruiker mag zien en doen.
Publisher
Workable Inc
Prerequisites
- Een Werkbaar account.
- Een workable-gebruikersaccount. De hulpprogramma's handelen namens de aangemelde gebruiker, zodat de beschikbare gegevens en acties afhankelijk zijn van de rol en machtigingen van die gebruiker in Workable.
Referenties ophalen
De server maakt gebruik van OAuth 2.0. Er moet geen API-sleutel, client-id of geheim met de hand worden ingevoerd.
Wanneer u de verbinding maakt, wordt u omgeleid naar Workable om u aan te melden en toestemming te geven voor de machtigingen die de server aanvraagt. Werkbare problemen met een toegangstoken dat is gericht op uw gebruiker en de verbinding slaat het op. Tokens worden automatisch vernieuwd; u meldt u zich alleen opnieuw aan als u de toegang intrekt of als uw Workable-beheerder uw account verwijdert.
U kunt de autorisatie op elk gewenst moment bekijken of intrekken vanuit Instellingenintegraties > in Workable. Zie de documentatie van de Workable MCP-server voor het volledige hulpprogramma.
Aan de slag met uw connector
Voeg de Workable MCP-server toe als hulpprogramma op uw agent, maak een verbinding en meld u aan wanneer u hierom wordt gevraagd.
Elk ander hulpmiddel dan get_accounts een argument.account Een Workable-gebruiker kan deel uitmaken van meer dan één account, zodat de agent eerst moet aanroepen get_accounts om de accounts weer te geven die het kan bereiken en vervolgens het gekozen account subdomain door te geven zoals account bij elke volgende aanroep. Goed gevoede orchestrators doen dit automatisch; als u met één account werkt, is het de moeite waard om deze in de instructies van uw agent te benoemen, zodat de agent dit niet hoeft te vragen.
Enkele handige dingen die u kunt proberen wanneer u verbinding hebt gemaakt:
- "Welke kandidaten hebben deze week de rol Senior Backend Engineer aangevraagd en waar bevinden ze zich in de pijplijn?"
- "Verplaats kandidaat 12345 naar het interviewstadium en voeg een notitie toe over hun portfolio."
- "Wie is er volgende maand niet aanwezig in het kantoor van Berlijn?"
- "Laat me de opdrachten zien die wachten op mijn goedkeuring."
- "Wie rapporteert aan de VP van Engineering?"
Beschikbare hulpmiddelen
De server maakt meer dan 100 hulpprogramma's beschikbaar. Ze worden als volgt gegroepeerd; de gezaghebbende lijst voor een bepaalde implementatie is wat de server retourneert tools/list, omdat een account of implementatie hulpprogramma's kan hebben uitgeschakeld.
| Area | Wat de agent kan doen | Representatieve hulpprogramma's |
|---|---|---|
| Accounts | Bereikbare accounts en de aangepaste machtigingensets van het account detecteren |
get_accounts, get_permission_sets |
| Jobs | Taken weergeven, zoeken en inspecteren, hun fasen, leden, recruiters, toepassingsformulieren en activiteitengeschiedenis |
get_jobs, search_jobs, get_job, get_job_stages, , get_job_activities |
| Kandidaten | Kandidaten vermelden en inspecteren; maken; verplaatsen, kopiëren, verplaatsen, diskwalificeren of opnieuw classificeren; opmerkingen, evaluaties en beoordelingen toe te voegen; tags beheren en bijgevoegde bestanden lezen |
get_candidates, get_candidate, create_candidate, move_candidate, disqualify_candidate, revert_disqualification, , add_comment, add_review |
| Employees | Werknemers weergeven en inspecteren, het organigram en werknemersdocumenten lezen, werknemersrecords bijwerken |
get_employees,get_employee,get_orgchart,update_employee |
| Members | Accountleden weergeven, nieuwe uitnodigen, rollen en machtigingen bijwerken, leden in- of uitschakelen |
get_members,invite_member,update_member,delete_member |
| Bestelopdrachten | Lees opdrachten en hun aangepaste kenmerken; maken, bijwerken, goedkeuren en negeren |
get_requisitions,create_requisition,approve_requisition,reject_requisition |
| Offers | Het aanbod van een kandidaat lezen en goedkeuren of afwijzen |
get_offer,get_candidate_offer,approve_offer,reject_offer |
| Verlof | Balansen, aanvragen en categorieën lezen; aanvragen maken; in behandeling goedkeuren of afwijzen |
get_timeoff_balances,get_timeoff_requests,create_timeoff_request,update_timeoff_approval |
| Tijden bijhouden | Tijdvermeldingen weergeven, maken en bijwerken, inclusief bulkinvoer en in- of uitkloken |
list_time_entries,clock_in,clock_out,bulk_create_time_entries |
| Beoordelingsgesprekken | Beoordelingscycli, taken, formulieren en resultaten lezen; cyclussjablonen maken; beoordelingen verzenden, delen en ondertekenen |
get_review_cycles,list_review_tasks,submit_review,sign_review |
| Organisatie | Afdelingen, juridische entiteiten en werkschema's lezen en beheren |
get_departments,create_department,get_legal_entities,get_work_schedules |
| Reporting | Gefilterde zoekopdrachten uitvoeren op werknemers en gedetailleerde kandidaatrecords na het detecteren van de beschikbare velden en filteropties |
get_employee_fields, search_employees, search_candidates_detailed |
| Verwijzingsgegevens | Pijplijnfasen, disqualificatieredenen, aangepaste kenmerken en gebeurtenissen van accounts lezen |
get_stages,get_disqualification_reasons,get_account_custom_attributes,get_events |
Hulpprogramma's met het kenmerk Alleen-lezen worden als zodanig geannoteerd en hulpprogramma's die gegevens wijzigen of verwijderen, worden als destructief geannoteerd, zodat een host waarop aantekeningen van hulpprogramma's worden weergegeven, om bevestiging kan worden gevraagd voordat een schrijfbewerking wordt uitgevoerd.
Bekende problemen en beperkingen
- Alleen hulpprogramma's. De server maakt MCP-hulpprogramma's beschikbaar. Er worden geen MCP-resources of prompts gepubliceerd en er wordt geen gebruikgemaakt van steekproeven of elicitatie.
- Alleen streambare HTTP. Aanvragen worden
POSTJSON-RPC via het streambare HTTP-transport. Het afgeschafte SSE-transport wordt niet ondersteund; aGETnaar het eindpunt retourneert405. - Staatloos. Elke aanvraag wordt onafhankelijk verwerkt. Er is geen sessie hervat en de server pusht geen pushmeldingen naar de client tussen aanroepen.
- Verwerking van meerdere accounts is expliciet. Er is geen impliciete 'huidige rekening'. Het weglaten van het
accountargument mislukt in plaats van te raden, wat opzettelijk is: handelen op het verkeerde Werkbare account is geen herstelbare fout. - Machtigingen worden afgedwongen door Workable, niet door de server. Een aanroep van een hulpprogramma kan slagen voor één gebruiker en kan worden geweigerd voor een andere gebruiker op hetzelfde account. Weigeringen komen terug als toolfouten die de beperking beschrijven; dit zijn geen verbindingslijnfouten.
- Frequentielimieten. Aanroepen zijn onderhevig aan de frequentielimieten voor workable-API's. Een aanroep met een frequentielimiet retourneert een fout waarin de agent wordt gevraagd het opnieuw te proberen na een korte wachttijd.
- Planafhankelijke hulpprogramma's. HR-hulpprogramma's (werknemers, verlof, tijd bijhouden, prestatiebeoordelingen) vereisen dat de bijbehorende werkbare producten op het account zijn ingeschakeld. Op een ATS-account retourneren deze hulpprogramma's 'niet gevonden' of 'verboden' fouten.
Veelvoorkomende fouten en oplossingen
| Fout | Betekenis | Remedy |
|---|---|---|
| Niet-gemachtigd (401) | Het toegangstoken ontbreekt, is ongeldig of verlopen. | Meld u opnieuw aan om de verbinding te vernieuwen. |
| Verboden (403) | Het token is geldig, maar deze gebruiker of dit account kan de actie niet uitvoeren. | Controleer de werkbare rol en machtigingen van de aangemelde gebruiker en controleer of het relevante product is ingeschakeld voor het account. |
| Niet gevonden (404) | De resource bestaat niet of is niet zichtbaar voor dit account. | Controleer of het account subdomein juist is en haal de lijst van de id opnieuw op om geldige id's op te halen. |
| Conflict (409) | De resource heeft een status die de actie niet toestaat, bijvoorbeeld het terugdraaien van een kandidaat die niet gediskwalificeerd is. | Lees de huidige status van de resource opnieuw en werk dienovereenkomstig. |
| Onverwerkbaar (422) | De aanvraag is begrepen, maar kan niet worden verwerkt zoals opgegeven. | Controleer de argumentwaarden op basis van het schema van het hulpprogramma, met name enum-achtige velden, zoals fasenamen en diskwalificatieredenen, die moeten worden gelezen uit het account in plaats van uit te gaan. |
| Snelheid beperkt (429) | Te veel aanvragen voor de Workable-API. | Wacht even en probeer het opnieuw. |
FAQ
Op welk Workable-account reageert de agent?
Welk accountsubdomein ook wordt doorgegeven als het account argument, uit de door get_accounts. De agent moet worden aangeroepen get_accounts vóór de eerste gegevensoproep.
Kan de agent gegevens zien die de aangemelde gebruiker niet kan? No. Elke aanroep wordt uitgevoerd met het eigen toegangstoken van de gebruiker en is onderworpen aan dezelfde machtigingen als de workable-web-app.
Kan de agent gegevens wijzigen? Ja, wanneer de machtigingen van de gebruiker dit toestaan, bijvoorbeeld het verplaatsen of weigeren van kandidaten, het goedkeuren van aanbiedingen en verlof, het bijwerken van werknemersrecords en het beheren van leden. Hulpprogramma's die schrijven, worden als zodanig geannoteerd, zodat de host eerst om bevestiging kan vragen.
Worden kandidaat- en werknemersgegevens gebruikt voor training? No. De server leest en schrijft uw Workable-account via de Workable-API en behoudt geen inhoud buiten wat nodig is om de aanvraag te verwerken.
Support
- Documentatie: Naslaginformatie over werkbare MCP-servers
- Ondersteuning: Workable Help Center
- Voorwaarden: Werkbare voorwaarden
Acties
| Werkbare MCP-server |
Streamable HTTP-eindpunt voor de Workable MCP-server. Stelt Workable Recruiting (ATS) en HR-hulpprogramma's beschikbaar voor de agent. De agent moet get_accounts eerst aanroepen om de accountsubdomeinen te detecteren die de aangemelde gebruiker kan bereiken en vervolgens het gekozen subdomein doorgeven als het accountargument van elk ander hulpprogramma. |
Werkbare MCP-server
Streamable HTTP-eindpunt voor de Workable MCP-server. Stelt Workable Recruiting (ATS) en HR-hulpprogramma's beschikbaar voor de agent. De agent moet get_accounts eerst aanroepen om de accountsubdomeinen te detecteren die de aangemelde gebruiker kan bereiken en vervolgens het gekozen subdomein doorgeven als het accountargument van elk ander hulpprogramma.
Retouren
- response
- object
Definities
Voorwerp
Dit is het type 'object'.