Fungerande MCP (förhandsversion)

Workable är en anställnings- och HR-plattform. Med den här MCP-servern kan en agent arbeta med en användares workable-konto: bläddra och söka efter jobb, granska och åtgärda kandidater via rekryteringspipelinen, leta upp anställda och organisationsschemat, hantera rekvisitioner, erbjudanden, avdelningar och medlemmar och hantera tidsavgångar, tidsspårning och prestandagranskningar.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänst Class Regions
Copilot Studio Premium Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Standard Alla Logic Apps-regioner utom följande:
     - Azure Government regioner
     - Azure kinaregioner
     - US Department of Defense (DoD)
Power Apps Premium Alla Power Apps regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Fungerande support
URL https://help.workable.com/hc/en-us
Metadata för anslutningsprogram
Publisher Genomförbar
Webbplats https://www.workable.com
Sekretesspolicy https://www.workable.com/privacy
Kategorier Personal; Produktivitet

Genomförbar

Workable är en anställnings- och HR-plattform som används av mer än 30 000 företag för att posta jobb, flytta kandidater genom en anställningspipeline och hantera anställda när de har anställts.

Workable MCP-servern ger en agent autentiserad, behörighetsmedveten åtkomst till dessa data. En agent kan svara på frågor om öppna roller och sökande, agera på en kandidats pipelineposition, leta upp information om medarbetare och organisationsscheman och hantera arbetsflöden för godkännande som omger krav, erbjudanden och slutade – allt som den inloggade Workable-användaren och endast inom vad användaren får se och göra.

Publisher

Workable Inc

Prerequisites

  • Ett workable-konto.
  • Ett workable-användarkonto. Verktygen fungerar för den inloggade användarens räkning, så de data och åtgärder som är tillgängliga beror på användarens roll och behörigheter i Workable.

Hämta autentiseringsuppgifter

Servern använder OAuth 2.0. Ingen API-nyckel, klient-ID eller hemlighet behöver anges för hand.

När du skapar anslutningen omdirigeras du till Workable för att logga in och samtycka till de behörigheter som servern begär. Workable utfärdar en åtkomsttoken som är begränsad till användaren och anslutningen lagrar den. Token uppdateras automatiskt. du loggar bara in igen om du återkallar åtkomsten eller om din workable-administratör tar bort ditt konto.

Du kan granska eller återkalla auktoriseringen när som helst från Inställningar > Integreringar i Workable. Den fullständiga verktygsreferensen finns i dokumentationen om workable MCP-server.

Kom igång med anslutningsappen

Lägg till Workable MCP-servern som ett verktyg på din agent, skapa en anslutning och logga in när du uppmanas att göra det.

Alla andra verktyg än get_accounts tar ett account argument. En workable-användare kan tillhöra fler än ett konto, så agenten måste först anropa get_accounts för att visa de konton som den kan nå och sedan skicka det valda kontot subdomain som account vid varje efterföljande anrop. Väluppfostrade orkestratorer gör detta automatiskt. Om du arbetar med ett enda konto är det värt att namnge det i agentens instruktioner så att agenten inte behöver fråga.

Några användbara saker att prova när du är ansluten:

  • "Vilka kandidater ansökte om rollen som senior backend engineer den här veckan och var är de i pipelinen?"
  • "Flytta kandidat 12345 till intervjusteget och lägg till en anteckning om deras portfölj."
  • "Vem är borta från kontoret i Berlin nästa månad?"
  • "Visa mig rekvisitionerna som väntar på mitt godkännande."
  • "Vem rapporterar till den virtuella teknikleverantören?"

Tillgängliga verktyg

Servern exponerar drygt 100 verktyg. De grupperas på följande sätt. den auktoritativa listan för en viss distribution är vad servern returnerar från tools/list, eftersom ett konto eller distribution kan ha verktyg inaktiverade.

Area Vad agenten kan göra Representativa verktyg
Accounts Identifiera åtkomstbara konton och kontots anpassade behörighetsuppsättningar get_accounts, get_permission_sets
Jobs Lista, söka och inspektera jobb, deras faser, medlemmar, rekryterare, ansökningsformulär och aktivitetshistorik get_jobs, search_jobs, get_job, get_job_stages, get_job_activities
Kandidater Lista och inspektera kandidater; skapa dem; flytta, kopiera, flytta, diskvalificera eller omkvalificera dem; lägga till kommentarer, utvärderingar och omdömen. hantera taggar och läsa bifogade filer get_candidates, get_candidate, create_candidate, , move_candidate, disqualify_candidate, revert_disqualification, , add_comment, add_review
Employees Visa en lista över och inspektera anställda, läs organisationsschemat och medarbetardokumenten, uppdatera de anställdas poster get_employees, get_employee, , get_orgchartupdate_employee
Members Lista kontomedlemmar, bjud in nya, uppdatera roller och behörigheter, aktivera eller ta bort medlemmar get_members, invite_member, , update_memberdelete_member
Rekvisitioner Läs rekvisitioner och deras anpassade attribut; skapa, uppdatera, godkänna och avvisa dem get_requisitions, create_requisition, , approve_requisitionreject_requisition
Offers Läs en kandidats erbjudande och godkänn eller avvisa det get_offer, get_candidate_offer, , approve_offerreject_offer
Ledig tid Läsbalanser, begäranden och kategorier; skapa begäranden. godkänna eller avvisa väntande get_timeoff_balances, get_timeoff_requests, , create_timeoff_requestupdate_timeoff_approval
Tidsspårning Lista, skapa och uppdatera tidsposter, inklusive massinmatning och klocka in eller ut list_time_entries, clock_in, , clock_outbulk_create_time_entries
Prestationsgranskningar Läs granskningscykler, uppgifter, formulär och resultat; skapa cykelmallar. skicka, dela och signera recensioner get_review_cycles, list_review_tasks, , submit_reviewsign_review
Organization Läsa och hantera avdelningar, juridiska personer och arbetsscheman get_departments, create_department, , get_legal_entitiesget_work_schedules
Reporting Kör filtrerade sökningar över anställda och detaljerade kandidatposter när du har upptäckt tillgängliga fält och filteralternativ get_employee_fields, search_employees, search_candidates_detailed
Referensdata Läs pipelinesteg, diskvalificeringsorsaker, anpassade kontoattribut och händelser get_stages, get_disqualification_reasons, , get_account_custom_attributesget_events

Skrivskyddade verktyg kommenteras som sådana, och verktyg som ändrar eller tar bort data kommenteras som destruktiva, så en värd som visar verktygsanteckningar kan be om bekräftelse före en skrivning.

Kända problem och begränsningar

  • Endast verktyg. Servern exponerar MCP-verktyg. Den publicerar inte MCP-resurser eller uppmaningar och använder inte sampling eller upprymdhet.
  • Endast strömmande HTTP. Begäranden JSON-RPC POST via den strömmande HTTP-transporten. Den inaktuella SSE-transporten stöds inte. a GET till slutpunkten returnerar 405.
  • Tillståndslös. Varje begäran hanteras oberoende av varandra. Det finns inget sessionsåtertagande och servern skickar inte meddelanden till klienten mellan anropen.
  • Hantering av flera konton är explicit. Det finns inget implicit "aktuellt konto". Att account utelämna argumentet misslyckas snarare än att gissa, vilket är avsiktligt: att agera på fel Workable-konto är inte ett återställningsbart misstag.
  • Behörigheter framtvingas av Workable, inte av servern. Ett verktygsanrop kan lyckas för en användare och nekas för ett annat på samma konto. Avslag kommer tillbaka som verktygsfel som beskriver begränsningen; de är inte anslutningsfel.
  • Hastighetsgränser. Anrop omfattas av hastighetsbegränsningarna för Workable API. Ett frekvensbegränsad anrop returnerar ett fel som ber agenten att försöka igen efter en kort väntan.
  • Planberoende verktyg. HR-verktyg (anställda, slutade, tidsspårning, prestandagranskningar) kräver att motsvarande Workable-produkter aktiveras på kontot. På ett ATS-konto returnerar dessa verktyg "hittades inte" eller "förbjuden" fel.

Vanliga fel och åtgärder

Fel Meaning Botemedel
Ej behörig (401) Åtkomsttoken saknas, är ogiltig eller har upphört att gälla. Logga in igen för att uppdatera anslutningen.
Förbjudet (403) Token är giltig, men den här användaren eller kontot kanske inte utför åtgärden. Kontrollera den inloggade användarens workable-roll och behörigheter och bekräfta att relevant produkt är aktiverad för kontot.
Hittades inte (404) Resursen finns inte eller är inte synlig för det här kontot. Bekräfta att underdomänen account är korrekt och hämta sedan listan som ID:t kom från för att hämta giltiga ID:t.
Konflikt (409) Resursen är i ett tillstånd som inte tillåter åtgärden , till exempel återställa en kandidat som inte är diskvalificerad. Läs resursens aktuella tillstånd igen och agera därefter.
Ej bearbetade (422) Begäran förstods men kunde inte bearbetas som den angavs. Kontrollera argumentvärdena mot verktygets schema, särskilt uppräkningsliknande fält som stegnamn och diskvalificeringsorsaker, som ska läsas från kontot i stället för att antas.
Hastighetsbegränsade (429) För många begäranden till api:et Workable. Vänta en kort stund och försök igen.

FAQ

Vilket Workable-konto agerar agenten på? Oavsett vilken kontounderdomän som skickas som account argument, av dem som returneras av get_accounts. Agenten bör anropa get_accounts före sitt första dataanrop.

Kan agenten se data som den inloggade användaren inte kan? No. Varje anrop görs med användarens egen åtkomsttoken och omfattas av samma behörigheter som webbappen Workable.

Kan agenten ändra data? Ja, där användarens behörigheter tillåter det – till exempel att flytta eller diskvalificera kandidater, godkänna erbjudanden och slutade, uppdatera anställdas poster och hantera medlemmar. Verktyg som skriver kommenteras som sådana så att värden kan be om bekräftelse först.

Används kandidat- och medarbetardata för utbildning? No. Servern läser och skriver ditt Workable-konto via Api:et Workable och behåller inte innehåll utöver vad som behövs för att hantera begäran.

Support

Åtgärder

Fungerande MCP-server

Streambar HTTP-slutpunkt för den fungerande MCP-servern. Gör arbetsbar rekrytering (ATS) och HR-verktyg tillgängliga för agenten. Agenten bör anropa get_accounts först för att identifiera de kontounderdomäner som den inloggade användaren kan nå och sedan skicka den valda underdomänen som kontoargument för alla andra verktyg.

Fungerande MCP-server

Streambar HTTP-slutpunkt för den fungerande MCP-servern. Gör arbetsbar rekrytering (ATS) och HR-verktyg tillgängliga för agenten. Agenten bör anropa get_accounts först för att identifiera de kontounderdomäner som den inloggade användaren kan nå och sedan skicka den valda underdomänen som kontoargument för alla andra verktyg.

Returer

response
object

Definitioner

object

Det här är typen "objekt".