Conectar tu función en Brain Studio
Despliega tu función
jelou deploy
# ✓ Deployed to https://mi-funcion.fn.jelou.ai
# ⚠ A default runtime token was created for this function.
# ▸ Token jfn_rt_abc123...
Verifica que MCP está activo
curl https://mi-funcion.fn.jelou.ai/__health \
-H "X-Jelou-Token: jfn_rt_abc123..."
{
"status": "ok",
"mode": "define",
"tool": {
"name": "mi-funcion",
"description": "Busca información de clientes"
}
}
app(), verás múltiples tools en el array tools.Si tu función tiene config: { mcp: false }, no se expondrá como herramienta MCP. Asegúrate de que MCP esté activo (es el default).
Abre Brain Studio
En el dashboard de Jelou, navega a tu agente IA:AI Agent → Tools → Servidores MCP externos
Configura el servidor MCP
Completa los campos:| Campo | Valor |
|---|
| URL | https://mi-funcion.fn.jelou.ai/mcp |
| Header name | X-Jelou-Token |
| Header value | jfn_rt_abc123... |
Selecciona las herramientas
Brain Studio descubrirá automáticamente las herramientas expuestas por tu función. Selecciona las que quieras que el agente pueda usar.Si usas app() con múltiples tools, cada uno aparece como una herramienta independiente con su nombre y descripción.
Prueba el agente
Inicia una conversación con el agente y pide algo que requiera usar tu herramienta. Por ejemplo:
“¿Cuál es el saldo del cliente 593987654321?”
El agente detectará que necesita invocar tu función, pasará los parámetros correctos, y mostrará la respuesta al usuario. app(), Brain Studio ve cada tool individualmente:
export default app({
tools: {
consultarSaldo: define({
description: "Consulta el saldo de un cliente por teléfono",
input: z.object({ telefono: z.string().min(10) }),
handler: async (input) => ({ saldo: 150.00 }),
}),
crearTicket: define({
description: "Crea un ticket de soporte",
input: z.object({ asunto: z.string(), detalle: z.string() }),
handler: async (input) => ({ ticketId: "TKT-001" }),
}),
},
});
- consultarSaldo — “Consulta el saldo de un cliente por teléfono”
- crearTicket — “Crea un ticket de soporte”
Puedes habilitar o deshabilitar cada herramienta individualmente.
Las descripciones de define() y las anotaciones .describe() de Zod en los campos de input son lo que Brain Studio muestra al agente IA. Descripciones claras y específicas mejoran la precisión del agente al decidir cuándo y cómo usar tu herramienta.
Troubleshooting
Verifica que:
- La función está desplegada (
jelou deploy)
- MCP está activo (
config.mcp no es false)
- La URL termina en
/mcp
- El token es correcto
Prueba manualmente:curl https://mi-funcion.fn.jelou.ai/mcp \
-H "X-Jelou-Token: jfn_rt_abc123..."
El token es inválido o falta. Verifica con:jelou tokens list mi-funcion
jelou tokens create mi-funcion --name brain-studio
Revisa la description de tu define(). Si es vaga (como “Maneja datos”), el agente no sabe cuándo usarla. Usa descripciones específicas como “Busca un cliente por número de teléfono y retorna su nombre, email y saldo”.
