Workable MCP (wersja zapoznawcza)

Ten łącznik jest dostępny w następujących produktach i regionach:

Wykonalny

Workable to platforma zatrudniania i kadr używana przez ponad 30 000 firm do publikowania miejsc pracy, przenoszenia kandydatów przez potok zatrudniania i zarządzania pracownikami po ich zatrudnieniu.

Serwer McP workable zapewnia uwierzytelniony agent z uprawnieniami dostęp do tych danych. Agent może odpowiedzieć na pytania dotyczące otwartych ról i kandydatów, działać na stanowisku potoku kandydata, wyszukać informacje o pracownikach i schematach organizacyjnych oraz obsługiwać przepływy pracy zatwierdzania, które otaczają wymagania, oferty i czas wolny — wszystko jako zalogowany użytkownik Workable i tylko w ramach tego, co może zobaczyć i zrobić ten użytkownik.

Publisher

Workable Inc

Prerequisites

• Konto workable.
• Konto użytkownika z możliwością pracy. Narzędzia działają w imieniu zalogowanego użytkownika, więc dostępne dane i akcje zależą od roli i uprawnień tego użytkownika w aplikacji Workable.

Jak uzyskać poświadczenia

Serwer używa protokołu OAuth 2.0. Nie trzeba ręcznie wprowadzać klucza interfejsu API, identyfikatora klienta ani wpisu tajnego.

Podczas tworzenia połączenia nastąpi przekierowanie do aplikacji Workable w celu zalogowania się i wyrażenia zgody na uprawnienia, których serwer żąda. Możliwe do działania problemy z tokenem dostępu w zakresie użytkownika, a połączenie je przechowuje. Tokeny są odświeżane automatycznie; Zalogujesz się ponownie tylko wtedy, gdy odwołasz dostęp lub administrator Workable usunie twoje konto.

Autoryzację można przejrzeć lub odwołać w dowolnym momencie z obszaru Integracje ustawień > w programie Workable. Aby uzyskać pełną dokumentację dotyczącą narzędzia, zobacz dokumentację serwera MCP Workable.

Wprowadzenie do łącznika

Dodaj serwer McP workable jako narzędzie na agencie, utwórz połączenie i zaloguj się po wyświetleniu monitu.

Każde narzędzie inne niż get_accounts przyjmuje account argument. Użytkownik z możliwością pracy może należeć do więcej niż jednego konta, więc agent musi najpierw wywołać get_accounts listę kont, do których może nawiązać połączenie, a następnie przekazać wybrane konto subdomain zgodnie account z każdym kolejnym wywołaniem. Dobrze zachowywani orkiestratorzy wykonują to automatycznie; Jeśli pracujesz z jednym kontem, warto nadać mu nazwę w instrukcjach agenta, aby agent nie musiał pytać.

Kilka przydatnych rzeczy do wypróbowania po nawiązaniu połączenia:

• "Którzy kandydaci ubiegali się o rolę starszego inżyniera zaplecza w tym tygodniu i gdzie są w potoku?"
• "Przenieś kandydata 12345 na etap wywiadu i dodaj notatkę o swoim portfolio."
• "Kto jest poza biurem w Berlinie w przyszłym miesiącu?"
• "Pokaż mi wymagania oczekujące na moje zatwierdzenie."
• "Kto zgłasza się do wiceprezesa ds. inżynierii?"

Dostępne narzędzia

Serwer uwidacznia nieco ponad 100 narzędzi. Są one pogrupowane w następujący sposób; lista autorytatywna dla danego wdrożenia jest niezależnie od tego, co serwer zwraca z tools/listprogramu , ponieważ konto lub wdrożenie może mieć wyłączone narzędzia.

Narzędzia tylko do odczytu są oznaczone adnotacjami, a narzędzia, które zmieniają lub usuwają dane, są oznaczane jako destrukcyjne, więc host, który wyświetla adnotacje narzędzi, może monitować o potwierdzenie przed zapisem.

Znane problemy i ograniczenia

• Tylko narzędzia. Serwer uwidacznia narzędzia MCP. Nie publikuje zasobów ani monitów MCP i nie używa próbkowania ani wywołania.
• Tylko przesyłanie strumieniowe HTTP. Żądania są POST JSON-RPC za pośrednictwem przesyłanego strumieniowo transportu HTTP. Przestarzały transport SSE nie jest obsługiwany; element GET do punktu końcowego zwraca wartość 405.
• Bezstanowy. Każde żądanie jest obsługiwane niezależnie. Nie ma wznowienia sesji, a serwer nie wypycha powiadomień do klienta między wywołaniami.
• Obsługa wielu kont jest jawna. Nie ma niejawnego "bieżącego konta". Pominięcie argumentu account kończy się niepowodzeniem, a nie zgadywaniem, co jest celowe: działanie na niewłaściwym koncie Workable nie jest błędem możliwy do odzyskania.
• Uprawnienia są wymuszane przez program Workable, a nie przez serwer. Wywołanie narzędzia może zakończyć się powodzeniem dla jednego użytkownika i odrzucone dla innego na tym samym koncie. Odmowy wracają jako błędy narzędzi opisujące ograniczenie; nie są to błędy łącznika.
• Limity szybkości. Wywołania podlegają limitom szybkości interfejsu API z możliwością pracy. Wywołanie z ograniczoną szybkością zwraca błąd z prośbą agenta o ponowienie próby po krótkim oczekiwaniu.
• Narzędzia zależne od planu. Narzędzia kadr (pracownicy, czas wolny, śledzenie czasu, przeglądy wydajności) wymagają włączenia odpowiednich produktów Workable na koncie. Na koncie usługi ATS te narzędzia zwracają błędy "nie znaleziono" lub "zabronione".

Typowe błędy i środki zaradcze

Często zadawane pytania

Na którym koncie workable działa agent? Niezależnie od tego, która poddomena konta jest przekazywana jako account argument, z tych zwróconych przez get_accounts. Agent powinien wywołać get_accounts wywołanie przed jego pierwszym wywołaniem danych.

Czy agent może wyświetlać dane, których nie może zalogować się użytkownik? No. Każde wywołanie jest wykonywane przy użyciu własnego tokenu dostępu użytkownika i podlega tym samym uprawnieniam co aplikacja internetowa Workable.

Czy agent może zmienić dane? Tak, gdzie zezwalają na to uprawnienia użytkownika — na przykład przenoszenie lub dyskwalifikacja kandydatów, zatwierdzanie ofert i godzin wolnych, aktualizowanie rekordów pracowników i zarządzanie członkami. Narzędzia zapisu są oznaczone adnotacjami, aby host mógł najpierw poprosić o potwierdzenie.

Czy dane kandydata i pracownika są używane do szkolenia? No. Serwer odczytuje i zapisuje konto workable za pośrednictwem interfejsu API Workable i nie zachowuje zawartości poza tym, co jest potrzebne do obsługi żądania.

Support

• Dokumentacja: Dokumentacja serwera MCP workable
• Pomoc techniczna: Workable Help Center
• Warunki i postanowienia: Warunki pracy

Akcje

Roboczy serwer MCP

Definicje

obiekt