ComposioHQ/sap-successfactors-automation

Automação de SAP SuccessFactors via Rube MCP

Automatize operações do SAP SuccessFactors através do toolkit SAP SuccessFactors da Composio via Rube MCP.

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

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com SAP SuccessFactors via RUBE_MANAGE_CONNECTIONS com o toolkit sap_successfactors
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Não são necessárias chaves de API — basta adicionar o endpoint e ele funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit sap_successfactors
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme que o status da conexão mostra ATIVO antes de executar qualquer workflow

Descoberta de Ferramentas

Sempre descubra as ferramentas disponíveis antes de executar workflows:

RUBE_SEARCH_TOOLS
queries: [{use_case: "Operações SAP SuccessFactors", known_fields: ""}]
session: {generate_id: true}

Isso retorna slugs de ferramentas disponíveis, esquemas de entrada, planos de execução recomendados e armadilhas conhecidas.

Padrão de Workflow Principal

Etapa 1: Descobrir Ferramentas Disponíveis

RUBE_SEARCH_TOOLS
queries: [{use_case: "sua tarefa específica do SAP SuccessFactors"}]
session: {id: "id_da_sessao_existente"}

Etapa 2: Verificar Conexão

RUBE_MANAGE_CONNECTIONS
toolkits: ["sap_successfactors"]
session_id: "id_da_sua_sessao"

Etapa 3: Executar Ferramentas

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "SLUG_DA_FERRAMENTA_PESQUISADA",
  arguments: {/* argumentos compatíveis com o esquema dos resultados da pesquisa */}
}]
memory: {}
session_id: "id_da_sua_sessao"

Armadilhas Conhecidas

• Sempre pesquise primeiro: Os esquemas das ferramentas mudam. Nunca fixe slugs ou argumentos de ferramentas sem chamar RUBE_SEARCH_TOOLS
• Verifique a conexão: Confirme que RUBE_MANAGE_CONNECTIONS mostra status ATIVO antes de executar ferramentas
• Conformidade com o esquema: Use nomes e tipos de campos exatos dos resultados da pesquisa
• Parâmetro memory: Sempre inclua memory nas chamadas RUBE_MULTI_EXECUTE_TOOL, mesmo que vazio ({})
• Reutilização de sessão: Reutilize IDs de sessão dentro de um mesmo workflow. Gere novos para novos workflows
• Paginação: Verifique as respostas para tokens de paginação e continue a busca até completar

Referência Rápida

Operação	Abordagem
Encontrar ferramentas	RUBE_SEARCH_TOOLS com caso de uso específico do SAP SuccessFactors
Conectar	RUBE_MANAGE_CONNECTIONS com toolkit sap_successfactors
Executar	RUBE_MULTI_EXECUTE_TOOL com slugs de ferramentas descobertas
Operações em lote	RUBE_REMOTE_WORKBENCH com run_composio_tool()
Esquema completo	RUBE_GET_TOOL_SCHEMAS para ferramentas com schemaRef

---

Desenvolvido por Composio