Documentación

Runner: la máquina donde trabaja el agente

El runner es el programa que se ejecuta en una VM o un ordenador de la empresa y ejecuta los agentes con el Claude instalado en esa máquina. Solo abre conexiones salientes hacia CaseFy.

1. 1En CaseFy, abre Agentes › Runtimes › Conectar un runtime. Aparece un código de un solo uso, válido 15 minutos.
2. 2En la máquina, ejecuta el comando de abajo con ese código.
3. 3La máquina aparece como conectada, con el límite de ejecuciones a la vez y lo que se está ejecutando. Después, elige en cada agente dónde se ejecuta.

casefy-runner connect <código>

• Usa una máquina dedicada: el agente tiene acceso total a ella. Cada caso tiene una carpeta de trabajo limpia.
• Los secretos de producción (contraseña de base de datos, clave de nube) se quedan en la máquina, leídos del almacén de secretos de la empresa, nunca en CaseFy.
• Revocar desconecta al instante; una ejecución interrumpida vuelve sola a la cola.

Servidor MCP: CaseFy dentro de Claude

Conecta Claude a CaseFy como un conector MCP remoto. El inicio de sesión es OAuth y Claude trabaja con los mismos permisos que tu usuario.

1. 1Copia la dirección del conector en Configuración › MCP, en CaseFy.
2. 2En Claude, añade un conector personalizado con esa dirección e inicia sesión.
3. 3Cada proceso define, en Configuración del proceso › MCP, qué herramientas valen en sus casos.

https://api.casefy.io/mcp

• Claude recibe el manual de la empresa y el del proceso antes de actuar.
• Los secretos, como el token del runner y la clave del webhook, nunca salen por MCP.

Webhooks y API

Otros sistemas crean casos en CaseFy y reciben avisos de lo que pasó.

1. 1Webhook de entrada: en Configuración del proceso › Automatización, crea una automatización con ese disparador. Genera una URL con clave secreta.
2. 2El otro sistema llama a la URL y CaseFy crea el caso. Un envío repetido no lo duplica.
3. 3Los webhooks de salida avisan a otros sistemas cuando algo cambia en el caso.

• La Agenda es el otro disparador que siempre crea un caso: diaria, semanal, mensual o día hábil, con hora y zona horaria.
• Cada caso tiene también su propia dirección de correo.