MCP viável (Pré-visualização)

Workable é uma plataforma de recrutamento e RH. Este servidor MCP permite a um agente trabalhar com a conta Workable de um utilizador: navegar e pesquisar empregos, analisar e analisar candidatos através do processo de contratação, consultar colaboradores e o organigrama, gerir requisitos, ofertas, departamentos e membros, e tratar de ausências, acompanhamento de tempo, avaliações de desempenho.

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

Serviço Class Regions
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - 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 (CCG)
     - 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 (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Entrar em contato
Name Suporte Operacional
URL https://help.workable.com/hc/en-us
Metadados do conector
Publisher Viável
Sítio Web https://www.workable.com
Política de privacidade https://www.workable.com/privacy
Categorias Recursos Humanos; Produtividade

Viável

Workable é uma plataforma de recrutamento e RH utilizada por mais de 30.000 empresas para publicar vagas, avançar candidatos numa cadeia de contratação e gerir colaboradores depois de contratados.

O servidor MCP Funcional dá a um agente acesso autenticado e consciente de permissões a esses dados. Um agente pode responder a perguntas sobre vagas abertas e candidatos, atuar sobre a posição de pipeline de um candidato, consultar informações de colaboradores e organigramas, e gerir os fluxos de trabalho de aprovação que envolvem requisitos, ofertas e dias de folga — tudo isto como utilizador Workable com sessão iniciada, e apenas dentro do que esse utilizador pode ver e fazer.

Publisher

Workable Inc

Prerequisites

  • Uma conta funcional.
  • Uma conta de utilizador viável. As ferramentas atuam em nome do utilizador iniciado, pelo que os dados e ações disponíveis dependem do papel e das permissões desse utilizador em Workable.

Como obter credenciais

O servidor utiliza OAuth 2.0. Nenhuma chave de API, ID de cliente ou segredo precisa de ser introduzida manualmente.

Quando cria a ligação, é redirecionado para o Workable para iniciar sessão e consentir com as permissões que o servidor solicita. Workable emite um token de acesso com escopo para o utilizador, e a ligação armazena-o. Os tokens são atualizados automaticamente; só voltas a iniciar sessão se revogares o acesso ou se o teu administrador Workable remover a tua conta.

Pode rever ou revogar a autorização a qualquer momento nas Integrações de Definições > em Funcional. Para a referência completa da ferramenta, consulte a documentação do servidor Workable MCP.

Introdução ao conector

Adiciona o servidor Workable MCP como ferramenta no teu agente, cria uma ligação e inicia sessão quando solicitado.

Todas as ferramentas, exceto get_accounts um account argumento. Um utilizador Workable pode pertencer a mais do que uma conta, por isso o agente deve primeiro ligar get_accounts para listar as contas que pode alcançar, depois passar as contas subdomain escolhidas como account em cada chamada subsequente. Orquestradores bem comportados fazem isto automaticamente; se trabalhar com uma única conta, vale a pena indicá-la nas instruções do seu agente para que o agente não tenha de pedir.

Algumas coisas úteis para experimentar depois de ligados:

  • "Que candidatos se candidataram esta semana ao cargo de Engenheiro Sénior de Backend, e em que ponto estão no pipeline?"
  • "Passe o candidato 12345 para a fase de entrevista e adicione uma nota sobre o seu portefólio."
  • "Quem está fora do escritório de Berlim no próximo mês?"
  • "Mostra-me as requisições à espera da minha aprovação."
  • "Quem responde ao Vice-Presidente de Engenharia?"

Ferramentas disponíveis

O servidor expõe pouco mais de 100 ferramentas. Estão agrupadas da seguinte forma; a lista autoritativa para uma dada implementação é aquilo que o servidor retorna de tools/list, uma vez que uma conta ou implementação pode ter ferramentas desativadas.

Area O que o agente pode fazer Ferramentas representativas
Accounts Descubra contas acessíveis e os conjuntos de permissões personalizados da conta get_accounts, get_permission_sets
Jobs Liste, pesquisa e inspecione os empregos, as suas fases, membros, recrutadores, formulários de candidatura e histórico de atividades get_jobs, search_jobs, get_job, get_job_stages, get_job_activities
Candidatos Listar e inspecionar candidatos; criá-los; movê-los, copiar, realocá-los, desqualificar ou requalificar-nos; adicionar comentários, avaliações e classificações; gerir etiquetas e ler ficheiros anexados get_candidates, get_candidate, create_candidate, move_candidate, disqualify_candidate, revert_disqualification, add_comment, add_review
Employees Liste e inspecione os funcionários, leia o organigrama e os documentos dos colaboradores, atualize os registos dos funcionários get_employees, get_employee, get_orgchart, update_employee
Members Listar membros da conta, convidar novos, atualizar funções e permissões, ativar ou remover membros get_members, invite_member, update_member, delete_member
Requisições ler requisições e os seus atributos personalizados; criar, atualizar, aprovar e rejeitá-los get_requisitions, create_requisition, approve_requisition, reject_requisition
Offers Leia a oferta de um candidato e aprove-a ou rejeite-a get_offer, get_candidate_offer, approve_offer, reject_offer
Licença ler saldos, pedidos e categorias; criar pedidos; aprovar ou rejeitar saldos pendentes get_timeoff_balances, get_timeoff_requests, create_timeoff_request, update_timeoff_approval
Monitorização do tempo Liste, crie e atualize entradas de tempo, incluindo entrada em massa, e faça o ponto de entrada ou saída list_time_entries, clock_in, clock_out, bulk_create_time_entries
Revisões de desempenho ler ciclos de avaliação, tarefas, formulários e resultados; criar modelos de ciclos; submeter, partilhar e assinar avaliações get_review_cycles, list_review_tasks, submit_review, sign_review
Organization Leia e gere departamentos, entidades legais e horários de trabalho get_departments, create_department, get_legal_entities, get_work_schedules
Reporting Execute pesquisas filtradas sobre os colaboradores e registos detalhados dos candidatos após descobrir os campos e opções de filtro disponíveis get_employee_fields, search_employees, search_candidates_detailed
Dados de referência Leia as fases do pipeline, razões de desqualificação, atributos personalizados da conta e eventos get_stages, get_disqualification_reasons, get_account_custom_attributes, get_events

As ferramentas apenas de leitura são anotadas como tal, e as ferramentas que alteram ou removem dados são anotadas como destrutivas, pelo que um host que apresenta anotações de ferramentas pode pedir confirmação antes da escrita.

Problemas e limitações conhecidos

  • Só ferramentas. O servidor expõe ferramentas MCP. Não publica recursos ou prompts MCP, nem utiliza amostragem ou elicitação.
  • Apenas HTTP transmitível. Os pedidos são POST JSON-RPC através do transporte HTTP streamable. O transporte SSE obsoleto não é suportado; a GET para o endpoint retorna 405.
  • Apátrida. Cada pedido é tratado de forma independente. Não há retoma de sessão e o servidor não envia notificações para o cliente entre chamadas.
  • O tratamento de múltiplas contas é explícito. Não existe uma "conta corrente" implícita. Omitir o account argumento falha em vez de adivinhar, o que é deliberado: agir com base na conta errada do Workable não é um erro recuperável.
  • As permissões são aplicadas pelo Workable, não pelo servidor. Uma chamada de ferramenta pode ter sucesso para um utilizador e ser recusada para outro na mesma conta. As recusas voltam a ser erros de ferramenta que descrevem a restrição; não são falhas no conector.
  • Limites de taxa. As chamadas estão sujeitas aos limites de taxa Workable API. Uma chamada com taxa limitada devolve um erro a pedir ao agente para tentar novamente após uma curta espera.
  • Ferramentas dependentes do plano. As ferramentas de RH (colaboradores, folgas, acompanhamento do tempo, avaliações de desempenho) exigem que os produtos Workable correspondentes estejam ativados na conta. Numa conta apenas ATS, essas ferramentas devolvem erros de "não encontrados" ou "proibidos".

Erros e soluções comuns

Erro Meaning Solução
Não Autorizado (401) O token de acesso está em falta, inválido ou expirado. Inicia sessão novamente para atualizar a ligação.
Proibido (403) O token é válido, mas este utilizador ou conta pode não realizar a ação. Verifique o papel Operacional e as permissões do utilizador iniciado, e confirme que o produto relevante está ativado na conta.
Não encontrado (404) O recurso não existe ou não é visível para esta conta. Confirma que o account subdomínio está correto e depois volta a buscar a lista de onde veio o id para obter os IDs válidos.
Conflito (409) O recurso encontra-se num estado que não permite a ação — por exemplo, reverter um candidato que não está desqualificado. Releia o estado atual do recurso e aja em conformidade.
Inprocessável (422) O pedido foi compreendido, mas não pôde ser processado como dado. Verifique os valores dos argumentos em relação ao esquema da ferramenta, especialmente campos do tipo enum, como nomes de palco e razões de desqualificação, que devem ser lidos a partir da conta em vez de assumidos.
Taxa limitada (429) Demasiados pedidos para a API Workable. Espera um pouco e tenta novamente.

FAQ

Em que conta Funcional atua o agente? Seja qual for o subdomínio da conta passado como account argumento, daqueles devolvidos por get_accounts. O agente deve ligar get_accounts antes da sua primeira chamada de dados.

O agente consegue ver dados que o utilizador iniciado não consegue? No. Cada chamada é feita com o token de acesso do utilizador e está sujeita às mesmas permissões da aplicação web Workable.

O agente pode alterar dados? Sim, quando as permissões do utilizador o permitem — por exemplo, mudar ou desqualificar candidatos, aprovar ofertas e dias de folga, atualizar registos de colaboradores e gerir membros. As ferramentas que escrevem são anotadas assim para que o anfitrião possa pedir confirmação primeiro.

Os dados de candidatos e colaboradores são usados para formação? No. O servidor lê e escreve a sua conta Workable através da API Workable e não retém conteúdos para além do necessário para servir o pedido.

Support

Ações

Servidor MCP funcional

Endpoint HTTP streamable para o servidor Workable MCP. Expõe ao agente ferramentas de recrutamento prático (ATS) e de RH. O agente deve ligar get_accounts primeiro para descobrir os subdomínios da conta que o utilizador iniciado pode alcançar, e depois passar o subdomínio escolhido como argumento da conta de todas as outras ferramentas.

Servidor MCP funcional

Endpoint HTTP streamable para o servidor Workable MCP. Expõe ao agente ferramentas de recrutamento prático (ATS) e de RH. O agente deve ligar get_accounts primeiro para descobrir os subdomínios da conta que o utilizador iniciado pode alcançar, e depois passar o subdomínio escolhido como argumento da conta de todas as outras ferramentas.

Devoluções

response
object

Definições

objecto

Este é o tipo 'objeto'.