Propósito
Cuándo usarla
Cuando necesites listar operadores de plataforma.
Cuándo no usarla
No la uses para modificar datos ni para consultar otra empresa.
Parámetros de entrada
No recibe parámetros.
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 una conexión global de platform_admin activa y vuelve a intentar con el request ID.
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