Documentação

Runner: a máquina onde o agente trabalha

O runner é o programa que roda numa VM ou num computador da empresa e executa os agentes com o Claude instalado na máquina. Ele só faz conexões de saída para o CaseFy.

1. 1No CaseFy, abra Agentes › Runtimes › Conectar um runtime. Aparece um código de uso único, válido por 15 minutos.
2. 2Na máquina, rode o comando abaixo com esse código.
3. 3A máquina aparece como conectada, com o limite de execuções ao mesmo tempo e o que está rodando. Depois, escolha em cada agente onde ele roda.

casefy-runner connect <código>

• Use uma máquina dedicada: o agente tem acesso total a ela. Cada caso ganha uma pasta de trabalho limpa.
• Segredos de produção (senha de banco, chave de nuvem) ficam na máquina, lidos do cofre da empresa, e nunca no CaseFy.
• Revogar desconecta na hora; uma execução interrompida volta para a fila sozinha.

Servidor MCP: o CaseFy dentro do Claude

Conecte o Claude ao CaseFy como um conector MCP remoto. O login é OAuth e o Claude trabalha com as mesmas permissões do seu usuário.

1. 1Copie o endereço do conector em Configurações › MCP, no CaseFy.
2. 2No Claude, adicione um conector personalizado com esse endereço e faça login.
3. 3Cada processo define, em Configurações do processo › MCP, quais ferramentas valem nos casos dele.

https://api.casefy.io/mcp

• O Claude recebe o manual da empresa e o do processo antes de agir.
• Segredos, como token do runner e chave de webhook, nunca saem pelo MCP.

Webhooks e API

Outros sistemas criam casos no CaseFy e recebem avisos do que aconteceu.

1. 1Webhook de entrada: em Configurações do processo › Automação, crie uma automação com esse gatilho. Ela gera uma URL com chave secreta.
2. 2O outro sistema chama a URL e o CaseFy cria o caso. Envio repetido não duplica.
3. 3Webhooks de saída avisam outros sistemas quando algo muda no caso.

• A Agenda é o outro gatilho que sempre cria caso: diário, semanal, mensal ou dia útil, com horário e fuso.
• Cada caso também tem um endereço de e-mail próprio.