Automação do BambooHR via Rube MCP

Automatize operações de recursos humanos do BambooHR através do kit de ferramentas BambooHR da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o BambooHR via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas bamboohr
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas bamboohr
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do BambooHR
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Pesquisar Funcionários

Quando usar: O usuário deseja encontrar funcionários ou obter o diretório completo de funcionários

Sequência de ferramentas:

1. BAMBOOHR_GET_ALL_EMPLOYEES - Obter o diretório de funcionários [Obrigatório]
2. BAMBOOHR_GET_EMPLOYEE - Obter informações detalhadas para um funcionário específico [Opcional]

Parâmetros chave:

• Para GET_ALL_EMPLOYEES: Nenhum parâmetro obrigatório; retorna o diretório
• Para GET_EMPLOYEE:
  • id: ID do funcionário (numérico)
  • fields: Lista de campos separados por vírgula a serem retornados (por exemplo, 'firstName,lastName,department,jobTitle')

Armadilhas:

• IDs de funcionários são inteiros numéricos
• GET_ALL_EMPLOYEES retorna informações básicas do diretório; use GET_EMPLOYEE para detalhes completos
• O parâmetro fields controla quais campos são retornados; omiti-lo pode retornar dados mínimos
• Campos comuns: firstName, lastName, department, division, jobTitle, workEmail, status
• Funcionários inativos/demitidos podem ser incluídos; verifique o campo status

2. Rastrear Alterações de Funcionários

Quando usar: O usuário deseja detectar alterações recentes nos dados dos funcionários para sincronização ou auditoria

Sequência de ferramentas:

1. BAMBOOHR_EMPLOYEE_GET_CHANGED - Obter funcionários com alterações recentes [Obrigatório]

Parâmetros chave:

• since: String de data/hora ISO 8601 para o limite de detecção de alterações
• type: Tipo de alterações a serem verificadas (por exemplo, 'inserted', 'updated', 'deleted')

Armadilhas:

• O parâmetro since é obrigatório; use o formato ISO 8601 (por exemplo, '2024-01-15T00:00:00Z')
• Retorna IDs de funcionários alterados, não dados completos dos funcionários
• Deve chamar GET_EMPLOYEE separadamente para os detalhes de cada funcionário alterado
• Útil para fluxos de trabalho de sincronização incremental; armazene em cache o último timestamp de sincronização

3. Gerenciar Afastamentos

Quando usar: O usuário deseja visualizar saldos de afastamento, solicitar afastamento ou gerenciar solicitações

Sequência de ferramentas:

1. BAMBOOHR_GET_META_TIME_OFF_TYPES - Listar tipos de afastamento disponíveis [Pré-requisito]
2. BAMBOOHR_GET_TIME_OFF_BALANCES - Verificar saldos atuais [Opcional]
3. BAMBOOHR_GET_TIME_OFF_REQUESTS - Listar solicitações existentes [Opcional]
4. BAMBOOHR_CREATE_TIME_OFF_REQUEST - Enviar uma nova solicitação [Opcional]
5. BAMBOOHR_UPDATE_TIME_OFF_REQUEST - Modificar ou aprovar/negar uma solicitação [Opcional]

Parâmetros chave:

• Para saldos: employeeId, ID do tipo de afastamento
• Para solicitações: start, end (intervalo de datas), employeeId
• Para criação:
  • employeeId: Funcionário para quem solicitar
  • timeOffTypeId: ID do tipo de GET_META_TIME_OFF_TYPES
  • start: Data de início (AAAA-MM-DD)
  • end: Data de término (AAAA-MM-DD)
  • amount: Número de dias/horas
  • notes: Notas opcionais para a solicitação
• Para atualização: requestId, status ('approved', 'denied', 'cancelled')

Armadilhas:

• IDs de tipos de afastamento são numéricos; resolva via GET_META_TIME_OFF_TYPES primeiro
• O formato da data é 'AAAA-MM-DD' para datas de início e término
• Saldos podem estar em horas ou dias dependendo da configuração da empresa
• Atualizações de status de solicitação exigem permissões apropriadas (gerente/administrador)
• Criar uma solicitação NÃO a aprova automaticamente; etapa de aprovação separada necessária

4. Atualizar Informações do Funcionário

Quando usar: O usuário deseja modificar dados do perfil do funcionário

Sequência de ferramentas:

1. BAMBOOHR_GET_EMPLOYEE - Obter dados atuais do funcionário [Pré-requisito]
2. BAMBOOHR_UPDATE_EMPLOYEE - Atualizar campos do funcionário [Obrigatório]

Parâmetros chave:

• id: ID do funcionário (numérico, obrigatório)
• Pares de nome de campo e valor para os campos a serem atualizados (por exemplo, department, jobTitle, workPhone)

Armadilhas:

• Apenas os campos incluídos na solicitação são atualizados; outros permanecem inalterados
• Alguns campos são somente leitura e não podem ser atualizados via API
• Os nomes dos campos devem corresponder exatamente aos nomes de campo esperados pelo BambooHR
• As atualizações são auditadas; as alterações aparecem no histórico de alterações do funcionário

…