ComposioHQ/Ashby-Automation

Automação Ashby

Automatize suas operações de recrutamento no Ashby ATS diretamente do Claude Code. Crie candidatos, publique vagas, gerencie inscrições, visualize agendas de entrevistas e pesquise no seu pipeline de talentos — tudo sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/ashby

---

Configuração

1. Adicione o servidor MCP Rube à configuração do seu Claude Code com a URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta Ashby através do link de conexão fornecido
3. Comece a automatizar seus fluxos de recrutamento com linguagem natural

---

Fluxos Principais

1. Gerenciar Candidatos

Crie, liste, pesquise, atualize e recupere informações detalhadas de candidatos.

Ferramentas: ASHBY_CREATE_CANDIDATE, ASHBY_LIST_CANDIDATES, ASHBY_SEARCH_CANDIDATES, ASHBY_GET_CANDIDATE_INFO, ASHBY_UPDATE_CANDIDATE

Crie um candidato chamado "João Silva" com email [email protected] e perfil do LinkedIn https://linkedin.com/in/joaosilva

Parâmetros principais para ASHBY_CREATE_CANDIDATE:

• name (obrigatório) — nome completo do candidato
• email — endereço de e-mail principal
• phoneNumber, linkedInUrl, githubUrl, websiteUrl — perfis de contato/sociais

Parâmetros principais para ASHBY_SEARCH_CANDIDATES:

• email — correspondência exata de e-mail
• name — correspondência parcial de nome

Parâmetros principais para ASHBY_LIST_CANDIDATES:

• perPage (máx. 100) / cursor — paginação
• syncToken — para atualizações incrementais desde a última sincronização

2. Criar e Listar Vagas

Publique novas oportunidades de emprego e navegue por posições existentes.

Ferramentas: ASHBY_CREATE_JOB, ASHBY_LIST_JOBS, ASHBY_GET_JOB_INFO

Crie uma nova vaga "Engenheiro de Software Sênior" no time dept-123 na localização loc-456 com a marca brand-789

Parâmetros principais para ASHBY_CREATE_JOB:

• title (obrigatório) — título da vaga
• teamId (obrigatório) — ID do departamento/time (da lista de departamentos)
• locationId (obrigatório) — ID da localização do escritório (da lista de localizações)
• brandId (obrigatório) — ID da marca empregadora (da lista de marcas)
• defaultInterviewPlanId — necessário para abrir a vaga para inscrições
• jobTemplateId — pré-preenchido a partir de um modelo

Parâmetros principais para ASHBY_LIST_JOBS:

• perPage (máx. 100) / cursor / syncToken — paginação e sincronização incremental

Observação: Vagas recém-criadas começam no status "Rascunho". Você deve definir um defaultInterviewPlanId para abrir/publicar a vaga.

3. Gerenciar Inscrições

Crie inscrições para conectar candidatos a vagas e acompanhar seu progresso.

Ferramentas: ASHBY_CREATE_APPLICATION, ASHBY_LIST_APPLICATIONS

Inscreva o candidato cand-abc123 na vaga job-xyz789 com a fonte src-referral

Parâmetros principais para ASHBY_CREATE_APPLICATION:

• candidateId (obrigatório) — UUID de um candidato existente
• jobId (obrigatório) — UUID de uma vaga existente
• sourceId — UUID da fonte da inscrição (LinkedIn, Indicação, etc.)
• creditedToUserId — UUID do recrutador/indicador a creditar
• interviewStageId — colocar diretamente em uma etapa específica (padrão é a primeira etapa)

Parâmetros principais para ASHBY_LIST_APPLICATIONS:

• perPage (máx. 100) / cursor / syncToken — paginação e sincronização incremental

4. Visualizar Agendas de Entrevistas

Liste entrevistas agendadas com informações de horário, entrevistador e candidato.

Ferramenta: ASHBY_LIST_INTERVIEW_SCHEDULES

Mostre-me todas as próximas agendas de entrevistas

Parâmetros principais:

• perPage (máx. 100) / cursor — paginação
• syncToken — sincronização incremental para agendas alteradas

5. Notas do Candidato

Visualize notas internas, observações e comentários de recrutadores sobre candidatos.

Ferramenta: ASHBY_LIST_CANDIDATE_NOTES

Mostre-me todas as notas para o candidato cand-abc123

• Recupera todas as notas adicionadas por recrutadores e membros da equipe de contratação
• Útil para revisar feedback de entrevistas e avaliações internas

6. Relatórios do Pipeline

Combine ferramentas de listagem para criar relatórios do pipeline de contratação.

Ferramentas: ASHBY_LIST_CANDIDATES, ASHBY_LIST_APPLICATIONS, ASHBY_LIST_JOBS

Liste todas as inscrições para ver o estado atual do nosso pipeline de contratação

• Use syncToken para buscas incrementais de dados (eficiente para relatórios recorrentes)
• Combine dados de candidatos, inscrições e vagas para visibilidade total do pipeline
• Pagine por todos os resultados com cursor para conjuntos de dados completos

---

Armadilhas Conhecidas

• Vagas começam como Rascunho: Vagas recém-criadas via ASHBY_CREATE_JOB começam no status "Rascunho" e não podem aceitar inscrições até que um defaultInterviewPlanId seja definido e a vaga seja aberta.
• Quatro campos obrigatórios para vagas: ASHBY_CREATE_JOB requer title, teamId, locationId e brandId. Use os endpoints de listar departamentos, localizações e marcas para descobrir IDs válidos.
• Candidato antes da inscrição: Um candidato deve existir antes de criar uma inscrição. Sempre crie ou encontre o candidato primeiro, depois crie a inscrição.
• Paginação baseada em cursor: Todos os endpoints de listagem usam paginação baseada em cursor com perPage (máx. 100) e cursor. Você não pode pular para páginas arbitrárias — deve iterar sequencialmente.
• syncToken para eficiência: Use syncToken de respostas anteriores para buscar apenas registros alterados. Isso reduz drasticamente as chamadas de API para fluxos de trabalho recorrentes.
• Formato UUID em toda parte: Todos os IDs (candidatos, vagas, inscrições, etapas) são UUIDs. Passar IDs malformados retorna erros 400.
• Limitações de pesquisa: ASHBY_SEARCH_CANDIDATES suporta correspondência exata de e-mail ou correspondência parcial de nome, mas não consultas combinadas ou outros campos. Para pesquisas mais amplas, use ASHBY_LIST_CANDIDATES com paginação.

---

Referência Rápida

Slug da Ferramenta	Descrição
ASHBY_CREATE_CANDIDATE	Cria um novo candidato (requer name)
ASHBY_LIST_CANDIDATES	Lista todos os candidatos com paginação e sincronização
ASHBY_SEARCH_CANDIDATES	Pesquisa candidatos por e-mail ou nome
ASHBY_GET_CANDIDATE_INFO	Obtém detalhes completos do candidato (requer candidateId)
ASHBY_UPDATE_CANDIDATE	Atualiza informações do perfil do candidato
ASHBY_LIST_CANDIDATE_NOTES	Lista notas internas de um candidato
ASHBY_CREATE_JOB	Cria uma vaga (requer title, teamId, locationId, brandId)
ASHBY_LIST_JOBS	Lista todas as vagas com paginação e sincronização
ASHBY_GET_JOB_INFO	Obtém detalhes completos da vaga por ID
ASHBY_CREATE_APPLICATION	Inscreve um candidato em uma vaga (requer candidateId, jobId)
ASHBY_LIST_APPLICATIONS	Lista todas as inscrições com paginação e sincronização
ASHBY_LIST_INTERVIEW_SCHEDULES	Lista entrevistas agendadas com paginação

---

Desenvolvido por Composio