Propósito
Cuándo usarla
Cuando necesites revisar auditoría mcp/api.
Cuándo no usarla
No la uses para modificar datos ni para consultar otra empresa.
Parámetros de entrada
| Parámetro | Tipo | Requisito | Detalle |
|---|---|---|---|
organization_id | string (uuid) | Opcional | — |
actor_id | string (uuid) | Opcional | — |
limit | integer | Opcional | default: 100 |
Ejemplo completo
Entrada
{}Salida
{
"ok": true,
"requestId": "req_01JEXAMPLE",
"data": {
"result": "Respuesta resumida de Voltline"
}
}Errores y recuperación
authentication_requiredReconecta Voltline mediante OAuth.
mcp_tool_grant_requiredConfirma empresa, membresía activa, grant del cliente y request ID antes de reintentar.
organization_scope_mismatchSelecciona una empresa incluida en la conexión.
internal_errorEntrega el request ID a soporte; no reenvíes tokens ni archivos.
Auditoría
Se registra
- ✓request ID
- ✓usuario y cliente OAuth
- ✓empresa y herramienta
- ✓resultado, duración y hash de argumentos
Nunca se registra
- ×token
- ×prompt completo
- ×URL firmada
- ×archivo
- ×contraseña