Arbeitsfähiges MCP (Vorschau)
Arbeitbar ist eine Einstellungs- und Hr-Plattform. Mit diesem MCP-Server kann ein Agent mit dem arbeitsfähigen Konto eines Benutzers arbeiten: Durchsuchen und Suchen von Aufträgen, Überprüfen und Aktionen von Kandidaten über die Einstellungspipeline, Nachschlagen von Mitarbeitern und organigramm, Verwalten von Anfragen, Angeboten, Abteilungen und Mitgliedern und Behandeln von Abwesenheitszeit, Zeitnachverfolgung, Leistungsüberprüfungen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Arbeitsfähige Unterstützung |
| URL | https://help.workable.com/hc/en-us |
| Connectormetadaten | |
|---|---|
| Herausgeber | Durchführbar |
| Website | https://www.workable.com |
| Datenschutzrichtlinie | https://www.workable.com/privacy |
| Kategorien | Personalabteilung; Produktivität |
Durchführbar
Workable ist eine Einstellungs- und Hr-Plattform, die von mehr als 30.000 Unternehmen verwendet wird, um Arbeitsplätze zu posten, Kandidaten über eine Einstellungspipeline zu verschieben und Mitarbeiter zu verwalten, sobald sie eingestellt wurden.
Der Arbeitsfähige MCP-Server gewährt einem Agent authentifizierten, berechtigungsfähigen Zugriff auf diese Daten. Ein Agent kann Fragen zu offenen Rollen und Bewerbern beantworten, die Pipelineposition eines Kandidaten bearbeiten, Mitarbeiter- und Organigramminformationen nachschlagen und die Genehmigungsworkflows behandeln, die Anforderungen, Angebote und Abwesenheiten umgeben – alles als angemeldeter Benutzer und nur innerhalb dessen, was dieser Benutzer sehen und tun darf.
Herausgeber
Workable Inc
Prerequisites
- Ein arbeitsfähiges Konto.
- Ein arbeitsfähiges Benutzerkonto. Die Tools handeln im Namen des angemeldeten Benutzers, sodass die verfügbaren Daten und Aktionen von der Rolle und den Berechtigungen dieses Benutzers in Arbeit abhängig sind.
So erhalten Sie Anmeldeinformationen
Der Server verwendet OAuth 2.0. Es muss kein API-Schlüssel, keine Client-ID oder kein geheimer Schlüssel von Hand eingegeben werden.
Wenn Sie die Verbindung erstellen, werden Sie zu "Workable" umgeleitet, um sich anzumelden und den Berechtigungen zuzustimmen, die der Server anfordert. Bei arbeitbaren Problemen gibt es ein Zugriffstoken, das auf Ihren Benutzer festgelegt ist, und die Verbindung speichert es. Token werden automatisch aktualisiert; Sie melden sich nur erneut an, wenn Sie den Zugriff widerrufen oder Ihr arbeitsfähiger Administrator Ihr Konto entfernt.
Sie können die Autorisierung jederzeit über Einstellungenintegrationen > in Arbeit überprüfen oder widerrufen. Die vollständige Toolreferenz finden Sie in der Dokumentation zum Arbeitsfähigen MCP-Server.
Erste Schritte mit Ihrem Connector
Fügen Sie den Arbeitsfähigen MCP-Server als Tool zu Ihrem Agent hinzu, erstellen Sie eine Verbindung, und melden Sie sich an, wenn Sie dazu aufgefordert werden.
Jedes andere Tool als get_accounts ein account Argument. Ein bearbeitbarer Benutzer kann zu mehreren Konten gehören, daher muss der Agent zuerst die Konten auflisten get_accounts , die er erreichen kann, und dann das ausgewählte Konto subdomain wie account bei jedem nachfolgenden Anruf übergeben. Gut verhaltene Orchestratoren tun dies automatisch; Wenn Sie mit einem einzigen Konto arbeiten, lohnt es sich, es in den Anweisungen Ihres Agenten zu benennen, damit der Agent nicht fragen muss.
Einige nützliche Dinge, die Sie nach der Verbindung ausprobieren können:
- "Welche Kandidaten haben sich in dieser Woche für die Rolle "Senior Backend Engineer" beworben, und wo befinden sie sich in der Pipeline?
- "Verschieben Sie kandidaten 12345 in die Interviewphase und fügen Sie eine Notiz zu ihrem Portfolio hinzu."
- "Wer ist im nächsten Monat im Berliner Büro abwesend?"
- "Zeigen Sie mir die Anforderungen an, die auf meine Genehmigung warten."
- "Wer berichtet an den VP of Engineering?"
Verfügbare Tools
Der Server macht knapp 100 Tools verfügbar. Sie sind wie folgt gruppiert; Die autoritative Liste für eine bestimmte Bereitstellung ist unabhängig davon, von tools/listwelchem Server der Server zurückgegeben wird, da ein Konto oder eine Bereitstellung möglicherweise Tools deaktiviert haben.
| Area | Was der Agent tun kann | Repräsentative Tools |
|---|---|---|
| Konten | Ermitteln erreichbarer Konten und der benutzerdefinierten Berechtigungssätze des Kontos |
get_accounts, get_permission_sets |
| Jobs | Auflisten, Suchen und Überprüfen von Aufträgen, deren Phasen, Mitglieder, Personalverantwortlichen, Bewerbungen und Aktivitätsverlauf |
get_jobs, search_jobs, get_job, get_job_stages, , get_job_activities |
| Kandidaten | Kandidaten auflisten und prüfen; sie zu erstellen; verschieben, kopieren, verschieben, disqualifizieren oder requalifizieren; Kommentare, Bewertungen und Bewertungen hinzufügen; Verwalten von Tags und Lesen angefügter Dateien |
get_candidates, get_candidate, create_candidate, move_candidate, , disqualify_candidate, revert_disqualification, add_comment, add_review |
| Employees | Mitarbeiter auflisten und prüfen, Organigramm und Mitarbeiterdokumente lesen, Mitarbeiterdatensätze aktualisieren |
get_employees, get_employee, get_orgchart, update_employee |
| Elemente | Mitglieder des Kontos auflisten, neue einladen, Rollen und Berechtigungen aktualisieren, Mitglieder aktivieren oder entfernen |
get_members, invite_member, update_member, delete_member |
| Anforderungen | Lesen von Anforderungen und ihren benutzerdefinierten Attributen; erstellen, aktualisieren, genehmigen und ablehnen |
get_requisitions, create_requisition, approve_requisition, reject_requisition |
| Offers | Lesen Sie das Angebot eines Kandidaten, und genehmigen oder ablehnen Sie es. |
get_offer, get_candidate_offer, approve_offer, reject_offer |
| Arbeitsfreie Zeit | Lesen von Saldos, Anforderungen und Kategorien; Anfragen erstellen; Genehmigen oder Ablehnen ausstehender |
get_timeoff_balances, get_timeoff_requests, create_timeoff_request, update_timeoff_approval |
| Zeiterfassung | Auflisten, Erstellen und Aktualisieren von Zeiteinträgen, einschließlich Masseneingabe und Ein- oder Auschecken |
list_time_entries, clock_in, clock_out, bulk_create_time_entries |
| Leistungsüberprüfungen | Lesen von Überprüfungszyklen, Aufgaben, Formularen und Ergebnissen; Erstellen von Zyklusvorlagen; Übermitteln, Freigeben und Signieren von Rezensionen |
get_review_cycles, list_review_tasks, submit_review, sign_review |
| Organisation | Lesen und Verwalten von Abteilungen, Juristischen Personen und Arbeitszeitplänen |
get_departments, create_department, get_legal_entities, get_work_schedules |
| Reporting | Führen Sie gefilterte Suchvorgänge über Mitarbeiter und detaillierte Kandidatendatensätze aus, nachdem Sie die verfügbaren Felder und Filteroptionen ermittelt haben. |
get_employee_fields, search_employeessearch_candidates_detailed |
| Referenzdaten | Lesen von Pipelinephasen, Disqualifizierungsgründen, benutzerdefinierten Kontoattributen und Ereignissen |
get_stages, get_disqualification_reasons, get_account_custom_attributes, get_events |
Schreibgeschützte Tools werden als solche kommentiert, und Tools, die Daten ändern oder entfernen, werden als destruktiv gekennzeichnet, sodass ein Host, der Toolanmerkungen anzeigt, vor einem Schreibvorgang zur Bestätigung auffordern kann.
Bekannte Probleme und Einschränkungen
- Nur Tools. Der Server macht MCP-Tools verfügbar. Es werden keine MCP-Ressourcen oder -Eingabeaufforderungen veröffentlicht, und es werden keine Sampling- oder Elikitationsabfragen verwendet.
- Nur streambares HTTP. Anforderungen werden
POSTüber den streambaren HTTP-Transport JSON-RPC. Der veraltete SSE-Transport wird nicht unterstützt; einGETbis zum Endpunkt wird zurückgegeben405. - Zustandslos. Jede Anforderung wird unabhängig behandelt. Es gibt keine Sitzungsaufnahme, und der Server pusht keine Benachrichtigungen zwischen Anrufen an den Client.
- Die Behandlung mit mehreren Konten ist explizit. Es gibt kein implizites "Aktuelles Konto". Das Auslassen des
accountArguments schlägt fehl, anstatt zu erraten, was absichtlich ist: Das Handeln auf das falsche arbeitsfähige Konto ist kein behebbarer Fehler. - Berechtigungen werden von Workable erzwungen, nicht vom Server. Ein Toolaufruf kann für einen Benutzer erfolgreich sein und für ein anderes Konto abgelehnt werden. Weigerungen kommen als Werkzeugfehler zurück, die die Einschränkung beschreiben; sie sind keine Verbinderfehler.
- Zinslimits. Aufrufe unterliegen den Grenzwerten für arbeitsfähige API-Raten. Ein zinsbeschränkte Anruf gibt einen Fehler zurück, der den Agent nach einer kurzen Wartezeit auffordern soll, den Vorgang erneut auszuführen.
- Planabhängige Tools. Personaltools (Mitarbeiter, Abwesenheit, Zeitnachverfolgung, Leistungsüberprüfungen) erfordern, dass die entsprechenden arbeitsfähigen Produkte auf dem Konto aktiviert werden. Bei einem nur ATS-Konto geben diese Tools Fehler "nicht gefunden" oder "verboten" zurück.
Häufige Fehler und Abhilfemaßnahmen
| Fehler | Bedeutung | Abhilfe |
|---|---|---|
| Nicht autorisiert (401) | Das Zugriffstoken fehlt, ist ungültig oder abgelaufen. | Melden Sie sich erneut an, um die Verbindung zu aktualisieren. |
| Unzulässig (403) | Das Token ist gültig, aber dieser Benutzer oder dieses Konto führt die Aktion möglicherweise nicht aus. | Überprüfen Sie die arbeitsfähige Rolle und Berechtigungen des angemeldeten Benutzers, und vergewissern Sie sich, dass das entsprechende Produkt für das Konto aktiviert ist. |
| Nicht gefunden (404) | Die Ressource ist nicht vorhanden oder für dieses Konto nicht sichtbar. | Bestätigen Sie, dass die account Unterdomäne korrekt ist, und rufen Sie dann die Liste erneut ab, aus der die ID stammt, um gültige IDs abzurufen. |
| Konflikt (409) | Die Ressource befindet sich in einem Zustand, der die Aktion nicht zulässt, z. B. das Wiederherstellen eines Kandidaten, der nicht qualifiziert ist. | Lesen Sie den aktuellen Zustand der Ressource erneut, und reagieren Sie entsprechend. |
| Nicht verarbeitet (422) | Die Anforderung wurde verstanden, konnte aber nicht wie angegeben verarbeitet werden. | Überprüfen Sie die Argumentwerte anhand des Schemas des Tools, insbesondere auf enumerationsähnliche Felder wie Phasennamen und Disqualifizierungsgründe, die aus dem Konto gelesen werden sollten, anstatt davon ausgegangen zu werden. |
| Satz begrenzt (429) | Zu viele Anforderungen an die arbeitsfähige API. | Warten Sie kurz, und wiederholen Sie den Vorgang. |
FAQ
Welches arbeitsfähige Konto handelt der Agent?
Je nachdem, von welcher Kontodomäne als account Argument übergeben wird, werden diese von get_accountsdiesen zurückgegeben. Der Agent sollte vor dem ersten Datenanruf anrufen get_accounts .
Kann der Agent Daten sehen, die der angemeldete Benutzer nicht kann? No. Jeder Aufruf erfolgt mit dem eigenen Zugriffstoken des Benutzers und unterliegt den gleichen Berechtigungen wie die Workable Web App.
Kann der Agent Daten ändern? Ja, wenn die Berechtigungen des Benutzers dies zulassen – z. B. Verschieben oder Disqualifizieren von Kandidaten, Genehmigen von Angeboten und Abwesenheiten, Aktualisieren von Mitarbeiterdatensätzen und Verwalten von Mitgliedern. Tools, die schreiben, werden als solche kommentiert, damit der Host zuerst eine Bestätigung anfordern kann.
Werden Kandidaten- und Mitarbeiterdaten für schulungen verwendet? No. Der Server liest und schreibt Ihr arbeitsfähiges Konto über die Arbeitsfähige API und behält inhalte nicht über das hinaus, was für die Bereitstellung der Anforderung erforderlich ist.
Support
- Dokumentation: Arbeitsfähige MCP-Serverreferenz
- Support: Arbeitsfähiges Hilfecenter
- Geschäftsbedingungen: Geschäftsbedingungen
Aktionen
| Arbeitsfähiger MCP-Server |
Streambarer HTTP-Endpunkt für den Arbeitsfähigen MCP-Server. Macht Workable Recruiting (ATS) und HR Tools für den Agenten verfügbar. Der Agent sollte get_accounts zuerst aufrufen, um die Kontounterdomänen zu ermitteln, die der angemeldete Benutzer erreichen kann, und dann die ausgewählte Unterdomäne als Kontoargument aller anderen Tools übergeben. |
Arbeitsfähiger MCP-Server
Streambarer HTTP-Endpunkt für den Arbeitsfähigen MCP-Server. Macht Workable Recruiting (ATS) und HR Tools für den Agenten verfügbar. Der Agent sollte get_accounts zuerst aufrufen, um die Kontounterdomänen zu ermitteln, die der angemeldete Benutzer erreichen kann, und dann die ausgewählte Unterdomäne als Kontoargument aller anderen Tools übergeben.
Gibt zurück
- response
- object
Definitionen
Objekt
Dies ist der Typ „Objekt“.