MCP utilisable (préversion)

Workable est une plateforme d’embauche et de ressources humaines. Ce serveur MCP permet à un agent de travailler avec le compte Workable d’un utilisateur : parcourir et rechercher des travaux, examiner et agir les candidats via le pipeline d’embauche, rechercher des employés et l’organigramme, gérer les demandes, les offres, les services et les membres, et gérer les congés, le suivi du temps, les révisions de performances.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Regions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Standard Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Name Prise en charge utilisable
URL https://help.workable.com/hc/en-us
Métadonnées du connecteur
Éditeur Workable
Website https://www.workable.com
Politique de confidentialité https://www.workable.com/privacy
Categories Ressources humaines; Productivité

Workable

Workable est une plateforme d’embauche et de ressources humaines utilisée par plus de 30 000 entreprises pour publier des emplois, déplacer des candidats dans un pipeline d’embauche et gérer les employés une fois qu’ils sont embauchés.

Le serveur MCP workable donne à un agent un accès authentifié et prenant en compte les autorisations à ces données. Un agent peut répondre à des questions sur les rôles ouverts et les candidats, agir sur la position du pipeline d’un candidat, rechercher des informations sur l’employé et l’organigramme, et gérer les flux de travail d’approbation qui entourent les demandes, les offres et le congé , tout comme l’utilisateur Workable connecté, et uniquement dans ce que cet utilisateur est autorisé à voir et à faire.

Éditeur

Workable Inc

Prerequisites

  • Un compte workable.
  • Un compte d’utilisateur workable. Les outils agissent pour le compte de l’utilisateur connecté, de sorte que les données et les actions disponibles dépendent du rôle et des autorisations de cet utilisateur dans Workable.

Comment obtenir des informations d’identification

Le serveur utilise OAuth 2.0. Aucune clé API, l’ID client ou le secret ne doivent être entrés manuellement.

Lorsque vous créez la connexion, vous êtes redirigé vers Workable pour vous connecter et donner votre consentement aux autorisations que le serveur demande. Workable émet un jeton d’accès étendu à votre utilisateur, et la connexion la stocke. Les jetons sont actualisés automatiquement ; vous vous reconnectez uniquement si vous révoquez l’accès ou si votre administrateur Workable supprime votre compte.

Vous pouvez passer en revue ou révoquer l’autorisation à tout moment à partir des intégrations de paramètres > dans Workable. Pour obtenir la référence complète de l’outil, consultez la documentation du serveur MCP Workable.

Bien démarrer avec votre connecteur

Ajoutez le serveur MCP workable en tant qu’outil sur votre agent, créez une connexion et connectez-vous lorsque vous y êtes invité.

Chaque outil autre que get_accounts prend un account argument. Un utilisateur workable peut appartenir à plusieurs comptes, de sorte que l’agent doit d’abord appeler get_accounts pour répertorier les comptes qu’il subdomain peut atteindre, puis transmettre le compte choisi comme account lors de chaque appel suivant. Les orchestrateurs bien comportementaux effectuent cette opération automatiquement ; si vous travaillez avec un seul compte, il vaut la peine de le nommer dans les instructions de votre agent afin que l’agent ne soit pas obligé de demander.

Voici quelques éléments utiles à essayer une fois connecté :

  • « Quels candidats ont demandé le rôle Ingénieur principal senior cette semaine et où se trouvent-ils dans le pipeline ? »
  • « Déplacer le candidat 12345 à la phase d’entrevue et ajouter une note sur son portefeuille. »
  • « Qui est hors de bureau dans le bureau de Berlin le mois prochain ?
  • « Montrez-moi les demandes en attente de mon approbation. »
  • « Qui signale au vice-président de l’ingénierie ? »

Outils disponibles

Le serveur expose seulement plus de 100 outils. Ils sont regroupés comme suit ; la liste faisant autorité pour un déploiement donné correspond à ce que le serveur retourne tools/list, car un compte ou un déploiement peut avoir des outils désactivés.

Area Ce que l’agent peut faire Outils représentatifs
Accounts Découvrir les comptes accessibles et les jeux d’autorisations personnalisés du compte get_accounts, get_permission_sets
Jobs Répertorier, rechercher et inspecter des travaux, leurs étapes, membres, recruteurs, formulaires d’application et historique d’activité get_jobs, search_jobs, get_job, get_job_stages, get_job_activities
Candidats Lister et inspecter les candidats ; créez-les ; déplacer, copier, déplacer, disqualifier ou requalifier ; ajouter des commentaires, des évaluations et des évaluations ; gérer les étiquettes et lire les fichiers joints get_candidates, get_candidate, create_candidate, move_candidate, disqualify_candidate, revert_disqualification, add_comment, add_review
Employees Répertorier et inspecter les employés, lire l’organigramme et les documents des employés, mettre à jour les enregistrements des employés get_employees, , get_employeeget_orgchart, ,update_employee
Members Répertorier les membres du compte, inviter de nouveaux membres, mettre à jour des rôles et des autorisations, activer ou supprimer des membres get_members, , invite_memberupdate_member, ,delete_member
Demandes d’achat Lire les demandes et leurs attributs personnalisés ; créer, mettre à jour, approuver et rejeter ces derniers get_requisitions, , create_requisitionapprove_requisition, ,reject_requisition
Offers Lire l’offre d’un candidat et l’approuver ou la rejeter get_offer, , get_candidate_offerapprove_offer, ,reject_offer
Congés Lire les soldes, les demandes et les catégories ; créer des demandes ; approuver ou rejeter les demandes en attente get_timeoff_balances, , get_timeoff_requestscreate_timeoff_request, ,update_timeoff_approval
Suivi du temps Répertorier, créer et mettre à jour les entrées d’heure, y compris l’entrée en bloc et l’horloge dans ou l’arrière list_time_entries, , clock_inclock_out, ,bulk_create_time_entries
Révisions des performances Lire les cycles de révision, les tâches, les formulaires et les résultats ; créer des modèles de cycle ; envoyer, partager et signer des révisions get_review_cycles, , list_review_taskssubmit_review, ,sign_review
Organisation Lire et gérer des services, des entités juridiques et des planifications de travail get_departments, , create_departmentget_legal_entities, ,get_work_schedules
Reporting Exécuter des recherches filtrées sur les employés et les enregistrements candidats détaillés après avoir découvert les champs disponibles et les options de filtre get_employee_fields, search_employees, search_candidates_detailed
Données de référence Lire les étapes de pipeline, les raisons de disqualification, les attributs personnalisés de compte et les événements get_stages, , get_disqualification_reasonsget_account_custom_attributes, ,get_events

Les outils en lecture seule sont annotés comme tels, et les outils qui modifient ou suppriment des données sont annotés comme destructeurs, de sorte qu’un hôte qui expose les annotations des outils peut demander une confirmation avant une écriture.

Problèmes connus et limitations

  • Outils uniquement. Le serveur expose les outils MCP. Il ne publie pas de ressources ou d’invites MCP, et n’utilise pas l’échantillonnage ou l’étourdissement.
  • HTTP pouvant être diffusé en continu uniquement. Les requêtes sont POST JSON-RPC sur le transport HTTP streamable. Le transport SSE déconseillé n’est pas pris en charge ; a GET pour point de terminaison retourne 405.
  • Sans état. Chaque requête est gérée indépendamment. Il n’existe aucune reprise de session et le serveur n’envoie pas de notifications Push au client entre les appels.
  • La gestion multi-comptes est explicite. Il n’existe aucun « compte actuel » implicite. L’omission de l’argument account échoue plutôt que de deviner, ce qui est délibéré : agir sur le mauvais compte workable n’est pas une erreur récupérable.
  • Les autorisations sont appliquées par Workable, et non par le serveur. Un appel d’outil peut réussir pour un utilisateur et être refusé pour un autre sur le même compte. Les refus reviennent en tant qu’erreurs d’outil décrivant la restriction ; ils ne sont pas des erreurs de connecteur.
  • Limites de taux. Les appels sont soumis aux limites de débit d’API Workable. Un appel limité à taux retourne une erreur demandant à l’agent de réessayer après une courte attente.
  • Outils dépendants du plan. Les outils RH (employés, congés, suivi du temps, révisions de performances) nécessitent que les produits Workable correspondants soient activés sur le compte. Sur un compte ATS uniquement, ces outils retournent des erreurs « introuvables » ou « interdites ».

Erreurs courantes et solutions

Error Meaning Correctif
Non autorisé (401) Le jeton d’accès est manquant, non valide ou expiré. Reconnectez-vous pour actualiser la connexion.
Interdit (403) Le jeton est valide, mais cet utilisateur ou compte peut ne pas effectuer l’action. Vérifiez le rôle et les autorisations Workable de l’utilisateur connectés, puis vérifiez que le produit approprié est activé sur le compte.
Introuvable (404) La ressource n’existe pas ou n’est pas visible pour ce compte. Vérifiez que le account sous-domaine est correct, puis récupérez à nouveau la liste dont l’ID provient pour obtenir des ID valides.
Conflit (409) La ressource est dans un état qui n’autorise pas l’action , par exemple, en rétablissant un candidat qui n’est pas disqualifié. Relisez l’état actuel de la ressource et agissez en conséquence.
Non traité (422) La demande a été comprise, mais elle n’a pas pu être traitée comme indiqué. Vérifiez les valeurs d’argument par rapport au schéma de l’outil, en particulier les champs de type énumération tels que les noms d’étape et les raisons de disqualification, qui doivent être lus à partir du compte plutôt que supposé.
Taux limité (429) Trop de requêtes adressées à l’API Workable. Attendez brièvement et réessayez.

FAQ

Quel compte professionnel l’agent agit-il ? Quel que soit le account sous-domaine de compte passé en tant qu’argument, hors de ceux retournés par get_accounts. L’agent doit appeler get_accounts avant son premier appel de données.

L’agent peut-il voir les données que l’utilisateur connecté ne peut pas ? Non. Chaque appel est effectué avec le propre jeton d’accès de l’utilisateur et est soumis aux mêmes autorisations que l’application web Workable.

L’agent peut-il modifier les données ? Oui, lorsque les autorisations de l’utilisateur l’autorisent , par exemple le déplacement ou la disqualification des candidats, l’approbation des offres et le congé, la mise à jour des enregistrements des employés et la gestion des membres. Les outils qui écrivent sont annotés de telle sorte que l’hôte puisse demander la confirmation en premier.

Les données des candidats et des employés sont-elles utilisées pour la formation ? Non. Le serveur lit et écrit votre compte Workable via l’API Workable et ne conserve pas le contenu au-delà de ce qui est nécessaire pour traiter la requête.

Support

Actions

Serveur MCP utilisable

Point de terminaison HTTP streamable pour le serveur MCP workable. Expose les outils atS (Workable recruiting) et RH à l’agent. L’agent doit appeler get_accounts d’abord pour découvrir les sous-domaines de compte que l’utilisateur connecté peut atteindre, puis passer le sous-domaine choisi comme argument de compte de chaque autre outil.

Serveur MCP utilisable

Point de terminaison HTTP streamable pour le serveur MCP workable. Expose les outils atS (Workable recruiting) et RH à l’agent. L’agent doit appeler get_accounts d’abord pour découvrir les sous-domaines de compte que l’utilisateur connecté peut atteindre, puis passer le sous-domaine choisi comme argument de compte de chaque autre outil.

Retours

response
object

Définitions

Objet

Il s’agit du type 'object'.