Crear faena | Voltline MCP

Propósito

Cuándo usarla

Cuando necesites crear faena.

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	—
`work_site_id`	string (uuid)	Obligatorio	—
`template_version_id`	string (uuid)	Obligatorio	—
`name`	string	Obligatorio	—
`shift`	string	Obligatorio	—
`responsible_name`	string	Obligatorio	—
`inspector_ids`	string[]	Obligatorio	—

Ejemplo completo

Entrada

{
  "organization_id": "11111111-2222-4333-8444-555555555555",
  "work_site_id": "11111111-2222-4333-8444-555555555555",
  "template_version_id": "11111111-2222-4333-8444-555555555555",
  "name": "Ejemplo operativo",
  "shift": "valor-ejemplo",
  "responsible_name": "Ejemplo operativo",
  "inspector_ids": [
    "11111111-2222-4333-8444-555555555555"
  ]
}

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