Automação com Lever

Automatize suas operações de recrutamento no Lever ATS diretamente do Claude Code. Gerencie vagas, acompanhe pipelines de candidatos, atualize requisições e consulte oportunidades sem sair do seu terminal.

Documentação do Toolkit: composio.dev/toolkits/lever

Configuração

1. Adicione o servidor Composio MCP à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta Lever quando solicitado ao executar qualquer comando do Lever. O agente fornecerá um link OAuth para autenticação.
3. Certifique-se de que sua chave de API do Lever tenha escopos suficientes para as operações que você precisa (acesso de leitura/escrita a postings, oportunidades, requisições).

Fluxos de Trabalho Principais

1. Listar e Filtrar Vagas

Recupere todas as vagas com filtragem opcional por estado, equipe, departamento, localização ou tipo de contrato.

Ferramenta: LEVER_LIST_POSTINGS

Parâmetros principais:

• state -- filtrar por published, internal, closed, draft, pending, rejected
• team, department, location, commitment -- restrinja os resultados por atributos organizacionais
• limit (1-100) e offset -- pague por grandes conjuntos de vagas
• tag -- filtrar por tag da vaga

Exemplo de prompt: "Liste todas as vagas de engenharia publicadas no Lever"

2. Navegar por Oportunidades de Candidatos

Liste todas as oportunidades no pipeline de contratação com filtragem rica para análise de pipeline e acompanhamento de candidatos.

Ferramenta: LEVER_LIST_OPPORTUNITIES

Parâmetros principais:

• posting_id, stage_id, tag -- filtrar por vaga, estágio do pipeline ou tag
• email, contact_id -- encontre oportunidades para um candidato específico
• archived -- filtrar por status arquivado (true/false)
• created_at_start, created_at_end -- filtragem por intervalo de datas (ISO 8601)
• expand -- expanda applications, contact, owner, stage, stageChanges, sources, sourcedBy em objetos completos

Exemplo de prompt: "Mostre-me todas as oportunidades ativas para a vaga de Engenheiro Sênior, expandidas com detalhes de contato"

3. Obter Detalhes da Oportunidade

Busque detalhes abrangentes sobre uma única oportunidade de candidato, incluindo informações de contato, progressão de estágio, fontes e candidaturas.

Ferramenta: LEVER_GET_OPPORTUNITY

Parâmetros principais:

• opportunity (obrigatório) -- o UID único da oportunidade
• expand -- campos separados por vírgula para expandir: contact, stage, owner

Exemplo de prompt: "Obtenha detalhes completos para a oportunidade 31c9716c-d4e3-47e8-a6a1-54078a1151d6 com contato e estágio expandidos"

4. Gerenciar Requisições

Crie, liste, atualize e exclua requisições para rastrear headcount e necessidades de contratação.

Ferramentas: LEVER_LIST_REQUISITIONS, LEVER_GET_REQUISITION, LEVER_UPDATE_REQUISITION, LEVER_DELETE_REQUISITION

A atualização requer estes campos:

• requisition (obrigatório) -- UUID da requisição
• requisitionCode (obrigatório) -- código único como REQ-001
• name (obrigatório) -- título da requisição
• headcountTotal (obrigatório) -- número de posições (mínimo 1)
• status -- open ou closed
• Opcional: hiringManager, owner, department, team, location, compensationBand

Exemplo de prompt: "Atualize a requisição REQ-001 para aumentar o headcount para 3 e mudar o status para aberta"

5. Visualizar Estágios do Pipeline

Recupere todos os estágios do pipeline de contratação configurados em sua conta Lever.

Ferramenta: LEVER_LIST_STAGES

Parâmetros principais:

• limit (1-100) -- itens máximos por página
• offset -- token de paginação da resposta anterior

Exemplo de prompt: "Liste todos os estágios do pipeline em nossa conta Lever"

6. Gerenciar Tags

Liste todas as tags usadas para categorizar candidatos, oportunidades e vagas.

Ferramenta: LEVER_LIST_TAGS

Parâmetros principais:

• limit -- itens máximos por página
• offset -- token de paginação

Exemplo de prompt: "Mostre todas as tags de candidatos no Lever"

Armadilhas Conhecidas

• Paginação necessária para grandes conjuntos de dados: LEVER_LIST_OPPORTUNITIES e LEVER_LIST_POSTINGS têm um limite padrão de 100 resultados por página. Sempre verifique se há um token offset na resposta e itere para obter resultados completos.
• Formato do parâmetro expandir: O campo expand em LEVER_LIST_OPPORTUNITIES aceita um array de strings, enquanto em LEVER_GET_OPPORTUNITY e LEVER_GET_REQUISITION aceita uma string separada por vírgulas. Siga o esquema exato para cada ferramenta.

…