API keys y agentes de IA (MCP)
Conecta tu cuenta de empresa a Claude u otros agentes de IA: D-OneCash expone tu panel como servidor MCP (Model Context Protocol), el estándar que usan los principales agentes. Tu agente consulta la operación con tus datos reales; las decisiones importantes siguen pasando por tu equipo.
Disponible en los planes Growth y Enterprise. Las API keys se gestionan desde Integraciones del panel.
Crear una API key
- Entra al panel → Integraciones → sección API keys para agentes de IA (MCP).
- Escribe un nombre que identifique al agente (p. ej. «Agente de tesorería»).
- Elige el rol de la key y pulsa Crear key. Te pediremos tu PIN y tu llave de acceso para confirmarlo, y lo mismo al revocarla.
La key se muestra una sola vez al crearla — guárdala en ese momento, no se puede volver a consultar (D-OneCash solo almacena un hash). Límite: 5 keys activas por empresa. Solo los administradores pueden crearlas y revocarlas.
Conectar tu agente
El endpoint es https://app.d-onecash.com/api/mcp (transporte HTTP). En Claude Code:
claude mcp add --transport http d1c https://app.d-onecash.com/api/mcp --header "Authorization: Bearer TU_API_KEY"En otros clientes compatibles con MCP, configura ese mismo endpoint y envía la key en la cabecera Authorization: Bearer.
Roles de las keys
| Rol | Qué permite |
|---|---|
| Solo lectura | Todas las consultas de la lista de abajo: saldo, tesorería, movimientos, nómina, empleados y aprobaciones pendientes. |
| Finanzas | Hoy, lo mismo que solo lectura. Próximamente: podrá además proponer pagos y nómina. |
Qué puede consultar tu agente
- Saldo de la empresa y configuración de tesorería (alertas, presupuestos y sub-cuentas).
- Movimientos (historial de transferencias, hasta 50 por consulta y paginado).
- Estado de la nómina (últimos lotes con sus pagos completados, fallidos y en curso; nóminas programadas, incluidas las pausadas; gasto del mes y tope de tu plan).
- Empleados y su estado de verificación.
- Aprobaciones pendientes: solicitudes de nómina a la espera de doble firma.
Límites y validez de las keys
- Cada key admite hasta 60 peticiones por minuto; si las superas, espera un minuto y vuelve a intentarlo.
- El servidor funciona sin sesión: cada petición es un
POSTal endpoint (no usa SSE). - Las keys empiezan por
d1c_mcp_. - Una key deja de funcionar si tu plan deja de ser Growth o Enterprise, o si tu cuenta se suspende. Se revoca automáticamente al completarse la eliminación de tu cuenta o si quitas del equipo a la persona que la creó.
Seguridad por diseño
- El agente nunca mueve dinero. Hoy todas las herramientas del servidor MCP son de consulta: tu agente no puede crear pagos, nóminas ni ningún otro cambio. Próximamente: que tu agente pueda proponer pagos; esas propuestas no se ejecutarán solas, sino que irán a la cola de Aprobaciones para que una persona de tu equipo decida en el panel (doble control). Hoy la cola de Aprobaciones es del plan Enterprise.
- Revocación inmediata: cualquier key se revoca al instante desde Integraciones, confirmando con tu PIN y tu llave de acceso.
- Auditoría: la creación y revocación de keys queda registrada en Auditoría del panel (plan Enterprise).
Updated about 1 month ago