Floid para desarrolladores y agentes de IA
Pregúntale a tu agente si un cliente ya pagó, por qué falló un pago o cuánto gana una persona. El agente encuentra la herramienta de Floid, la ejecuta con el token de tu empresa y responde con datos reales.
Las credenciales nunca pasan por un modelo de IA
Así lo resuelve un agente
› ¿Ya pagó el cliente el cobro fc74b16d…?
buscar_herramientas("estado payin chile")
ejecutar("pagos.payin_cl.consultar",
{"payment_token": "fc74b16d…"})
{"data": {"status": "SUCCESS",
"step": "FINISHED", …}}
› Sí: pagó y el flujo terminó sin errores.
Qué puedes resolver
Cada pregunta corresponde a una herramienta del catálogo, con su ficha de parámetros y avisos escritos para que un agente la use bien.
Basta el token de tu empresa: no se piden credenciales del titular.
La mayoría pide que el titular conecte su cuenta en el widget de Floid.
Cómo se conecta
Usas el token Floid de tu empresa. Para el MCP, tu ejecutivo comercial lo activa. Para probar, pide un token de sandbox.
Agrega el servidor a Claude, Cursor o cualquier cliente MCP. Desde tu backend, llama POST /v1/ejecutar.
El agente busca con buscar_herramientas y ejecuta con ejecutar. La respuesta siempre es {data, meta}, y si algo falla, el error dice qué hacer.
mcp.json
{
"mcpServers": {
"floid": {
"url": "https://mcp.floid.app",
"headers": {
"Authorization": "Bearer ${env:FLOID_TOKEN}"
}
}
}
}
Terminal
curl https://mcp.floid.app/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{"herramienta": "pagos.payin_cl.consultar",
"parametros": {"payment_token": "…"}}'
Seguridad
Por MCP solo se acepta credencial_token. El titular conecta su cuenta en el widget de Floid
y el agente recibe un token, nunca la clave. Si un agente intenta enviar una clave o un certificado, la capa lo rechaza antes de llamar a Floid.
Las mismas herramientas con datos ficticios. Para producción, usa tu token Floid con los servicios contratados.