Invitar usuario | Voltline MCP

Propósito

Cuándo usarla

Cuando necesites invitar usuario.

Cuándo no usarla

No la uses sin una solicitud humana clara, grant de escritura y revisión del alcance.

Parámetros de entrada

Parámetro	Tipo	Requisito	Detalle
`organization_id`	string (uuid)	Obligatorio	—
`email`	string (email)	Obligatorio	—
`full_name`	string	Obligatorio	—
`role`	org_admin \| org_lead \| inspector	Obligatorio	—
`locale`	es \| en	Opcional	default: es

Ejemplo completo

Entrada

{
  "organization_id": "11111111-2222-4333-8444-555555555555",
  "email": "persona@empresa.cl",
  "full_name": "Ejemplo operativo",
  "role": "org_admin"
}

Salida

{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "result": "Respuesta resumida de Voltline"
  }
}

Errores y recuperación

authentication_required

Reconecta Voltline mediante OAuth.

mcp_tool_grant_required

Confirma empresa, membresía activa, grant del cliente y request ID antes de reintentar.

organization_scope_mismatch

Selecciona una empresa incluida en la conexión.

internal_error

Entrega 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