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
POSTJSON-RPC pelo transporte HTTP que pode ser transmitido. Não há suporte para o transporte SSE preterido; aGETpara o ponto de extremidade retorna405. - 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
accountargumento 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
- Documentação: Referência de servidor MCP viável
- Suporte: Central de Ajuda Viável
- Termos e condições: termos viáveis
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'.