MCP viável (versão prévia)

Workable é uma plataforma de contratação e RH. Esse servidor MCP permite que um agente trabalhe com a conta viável de um usuário: procurar e pesquisar trabalhos, examinar e executar ação candidatos por meio do pipeline de contratação, pesquisar funcionários e o organograma, gerenciar requisições, ofertas, departamentos e membros e lidar com tempo de folga, acompanhamento de tempo, revisões de desempenho.

Esse conector está disponível nos seguintes produtos e regiões:

Serviço Classe Regions
Copilot Studio Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Azure Governamental regiões
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Name Suporte viável
URL https://help.workable.com/hc/en-us
Metadados do conector
Publicador Workable
Website https://www.workable.com
Política de privacidade https://www.workable.com/privacy
Categories Recursos humanos; Produtividade

Workable

Workable é uma plataforma de contratação e RH usada por mais de 30.000 empresas para postar empregos, mover candidatos através de um pipeline de contratação e gerenciar funcionários assim que forem contratados.

O servidor MCP viável fornece a um agente acesso autenticado e com reconhecimento de permissão a esses dados. Um agente pode responder a perguntas sobre funções abertas e candidatos, atuar na posição de pipeline de um candidato, pesquisar informações de funcionários e organogramas e lidar com os fluxos de trabalho de aprovação que envolvem requisição, ofertas e folga — tudo como o usuário workable conectado e somente dentro do que esse usuário tem permissão para ver e fazer.

Publicador

Workable Inc

Prerequisites

  • Uma conta viável.
  • Uma conta de usuário viável. As ferramentas atuam em nome do usuário conectado, portanto, os dados e as ações disponíveis dependem da função e das permissões desse usuário no Workable.

Como obter credenciais

O servidor usa o OAuth 2.0. Nenhuma chave de API, ID do cliente ou segredo precisa ser inserida manualmente.

Ao criar a conexão, você é redirecionado para Workable para entrar e consentir com as permissões que o servidor solicita. O workable emite um token de acesso com escopo para o usuário e a conexão o armazena. Os tokens são atualizados automaticamente; você só entrará novamente se revogar o acesso ou o administrador viável remover sua conta.

Você pode examinar ou revogar a autorização a qualquer momento das Integrações de Configurações > no Workable. Para obter a referência completa da ferramenta, consulte a documentação do servidor MCP viável.

Introdução ao conector

Adicione o servidor MCP viável como uma ferramenta em seu agente, crie uma conexão e entre quando solicitado.

Cada ferramenta que não get_accounts usa um account argumento. Um usuário viável pode pertencer a mais de uma conta, portanto, o agente deve primeiro chamar get_accounts para listar as contas que pode acessar e, em seguida, passar a conta subdomain escolhida como account em cada chamada subsequente. Orquestradores bem comportados fazem isso automaticamente; se você trabalha com uma única conta, vale a pena nomeá-la nas instruções do agente para que o agente não precise perguntar.

Algumas coisas úteis para tentar uma vez conectado:

  • "Quais candidatos se inscreveram para o cargo de Engenheiro de Back-end Sênior esta semana, e onde eles estão no pipeline?"
  • "Mova o candidato 12345 para o estágio de entrevista e adicione uma nota sobre seu portfólio."
  • "Quem está fora do cargo no escritório de Berlim no próximo mês?"
  • "Mostre-me as requisições esperando minha aprovação."
  • "Quem se reporta ao VP de Engenharia?"

Ferramentas disponíveis

O servidor expõe pouco mais de 100 ferramentas. Eles são agrupados da seguinte maneira; a lista autoritativa de uma determinada implantação é o que o servidor retorna tools/list, uma vez que uma conta ou implantação pode ter ferramentas desabilitadas.

Area O que o agente pode fazer Ferramentas representativas
Accounts Descobrir contas acessíveis e os conjuntos de permissões personalizados da conta get_accounts, get_permission_sets
Jobs Listar, pesquisar e inspecionar trabalhos, seus estágios, membros, recrutadores, formulários de aplicativo e histórico de atividades get_jobs, search_jobs, get_job, get_job_stages, get_job_activities
Candidatos Listar e inspecionar candidatos; criá-los; mover, copiar, realocar, desqualificar ou requalificá-los; adicionar comentários, avaliações e classificações; gerenciar marcas e ler arquivos anexados get_candidates, get_candidate, create_candidate, move_candidate, disqualify_candidate, revert_disqualification, add_comment, , add_review
Employees Listar e inspecionar funcionários, ler o organograma e documentos de funcionários, atualizar registros de funcionários get_employees, get_employee, , get_orgchartupdate_employee
Members Listar membros da conta, convidar novos, atualizar funções e permissões, habilitar ou remover membros get_members, invite_member, , update_memberdelete_member
Requisições Ler as requisições e seus atributos personalizados; criar, atualizar, aprovar e rejeitá-los get_requisitions, create_requisition, , approve_requisitionreject_requisition
Offers Ler a oferta de um candidato e aprová-la ou rejeitá-la get_offer, get_candidate_offer, , approve_offerreject_offer
Folga Balanceamentos de leitura, solicitações e categorias; criar solicitações; aprovar ou rejeitar os pendentes get_timeoff_balances, get_timeoff_requests, , create_timeoff_requestupdate_timeoff_approval
Rastreamento de tempo Listar, criar e atualizar entradas de hora, incluindo entrada em massa e relógio dentro ou fora list_time_entries, clock_in, , clock_outbulk_create_time_entries
Avaliações de desempenho Ler ciclos de revisão, tarefas, formulários e resultados; criar modelos de ciclo; enviar, compartilhar e assinar revisões get_review_cycles, list_review_tasks, , submit_reviewsign_review
Organização Ler e gerenciar departamentos, entidades jurídicas e agendas de trabalho get_departments, create_department, , get_legal_entitiesget_work_schedules
Reporting Executar pesquisas filtradas em funcionários e registros candidatos detalhados depois de descobrir os campos disponíveis e as opções de filtro get_employee_fields, search_employees, search_candidates_detailed
Dados de referência Ler estágios de pipeline, motivos de desqualificação, atributos e eventos personalizados da conta get_stages, get_disqualification_reasons, , get_account_custom_attributesget_events

As ferramentas somente leitura são anotadas como tal e as ferramentas que alteram ou removem dados são anotadas como destrutivas, de modo que um host que apresenta anotações de ferramentas pode solicitar confirmação antes de uma gravação.

Limitações e problemas conhecidos

  • Somente ferramentas. O servidor expõe ferramentas MCP. Ele não publica os recursos ou prompts do MCP e não usa amostragem ou provocação.
  • Somente HTTP que pode ser transmitido. As solicitações são POST JSON-RPC pelo transporte HTTP que pode ser transmitido. Não há suporte para o transporte SSE preterido; a GET para o ponto de extremidade retorna 405.
  • Sem estado. Cada solicitação é tratada de forma independente. Não há nenhuma retomada de sessão e o servidor não envia notificações por push para o cliente entre chamadas.
  • O tratamento de várias contas é explícito. Não há nenhuma "conta atual" implícita. Omitir o account argumento falha em vez de adivinhar, o que é deliberado: agir na conta viável errada não é um erro recuperável.
  • As permissões são impostas por Workable, não pelo servidor. Uma chamada de ferramenta pode ser bem-sucedida para um usuário e ser recusada por outro na mesma conta. As recusas voltam como erros de ferramenta que descrevem a restrição; não são falhas do conector.
  • Limites de taxa. As chamadas estão sujeitas aos limites de taxa de API viável. Uma chamada limitada por taxa retorna um erro solicitando que o agente tente novamente após uma breve espera.
  • Ferramentas dependentes do plano. As ferramentas de RH (funcionários, folga, acompanhamento de tempo, revisões de desempenho) exigem que os produtos viáveis correspondentes sejam habilitados na conta. Em uma conta somente do ATS, essas ferramentas retornam erros "não encontrados" ou "proibidos".

Erros comuns e soluções

Erro Meaning Solução
Não autorizado (401) O token de acesso está ausente, inválido ou expirado. Entre novamente para atualizar a conexão.
Proibido (403) O token é válido, mas esse usuário ou conta pode não executar a ação. Verifique as permissões e a função viável do usuário conectado e confirme se o produto relevante está habilitado na conta.
Não encontrado (404) O recurso não existe ou não está visível para essa conta. Confirme se o account subdomínio está correto e, em seguida, busque novamente a lista da qual a ID veio para obter ids válidas.
Conflito (409) O recurso está em um estado que não permite a ação , por exemplo, revertendo um candidato que não está desqualificado. Leia novamente o estado atual do recurso e atue adequadamente.
Não processável (422) A solicitação foi compreendida, mas não pôde ser processada conforme determinado. Verifique os valores de argumento em relação ao esquema da ferramenta, especialmente campos semelhantes a enumeração, como nomes de estágio e motivos de desqualificação, que devem ser lidos da conta em vez de assumidos.
Taxa limitada (429) Muitas solicitações para a API viável. Aguarde brevemente e tente novamente.

perguntas frequentes

Em qual conta viável o agente age? Qualquer subdomínio de conta é passado como o account argumento, daqueles retornados por get_accounts. O agente deve chamar get_accounts antes de sua primeira chamada de dados.

O agente pode ver dados que o usuário conectado não pode? No. Cada chamada é feita com o token de acesso do próprio usuário e está sujeita às mesmas permissões que o aplicativo Web viável.

O agente pode alterar dados? Sim, onde as permissões do usuário permitem isso , por exemplo, mover ou desqualificar candidatos, aprovar ofertas e folga, atualizar registros de funcionários e gerenciar membros. As ferramentas que gravam são anotadas como tal para que o host possa solicitar a confirmação primeiro.

Os dados do candidato e do funcionário são usados para treinamento? No. O servidor lê e grava sua conta viável por meio da API viável e não retém conteúdo além do necessário para atender à solicitação.

Support

Ações

Servidor MCP viável

Ponto de extremidade HTTP que pode ser transmitido para o servidor MCP viável. Expõe o ATS (recrutamento viável) e as ferramentas de RH para o agente. O agente deve chamar get_accounts primeiro para descobrir os subdomínios de conta que o usuário conectado pode acessar e, em seguida, passar o subdomínio escolhido como o argumento da conta de todas as outras ferramentas.

Servidor MCP viável

Ponto de extremidade HTTP que pode ser transmitido para o servidor MCP viável. Expõe o ATS (recrutamento viável) e as ferramentas de RH para o agente. O agente deve chamar get_accounts primeiro para descobrir os subdomínios de conta que o usuário conectado pode acessar e, em seguida, passar o subdomínio escolhido como o argumento da conta de todas as outras ferramentas.

Retornos

response
object

Definições

objeto

Esse é o tipo 'object'.