Preparar carga segura | Voltline MCP

Propósito

Cuándo usarla

Antes de adjuntar un PDF o una evidencia desde el MCP remoto.

Cuándo no usarla

No la uses para URLs arbitrarias, base64 ni archivos fuera de los MIME admitidos.

Parámetros de entrada

Parámetro	Tipo	Requisito	Detalle
`organization_id`	string (uuid)	Opcional	—
`purpose`	procedure_pdf \| norm_pdf \| faena_evidence	Obligatorio	—
`original_name`	string	Obligatorio	—
`mime_type`	application/pdf \| image/jpeg \| image/png \| image/webp	Obligatorio	—
`size_bytes`	integer	Obligatorio	—

Ejemplo completo

Entrada

{
  "purpose": "procedure_pdf",
  "original_name": "procedimiento.pdf",
  "mime_type": "application/pdf",
  "size_bytes": 240000
}

Salida

{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "uploadId": "11111111-2222-4333-8444-555555555555",
    "uploadPage": "https://app.voltline.cl/es/mcp/uploads/11111111-2222-4333-8444-555555555555",
    "expiresInSeconds": 900
  }
}

Errores y recuperación

invalid_upload_metadata

Corrige nombre, MIME o tamaño.

mcp_write_grant_required

Habilita archivos en la conexión.

Auditoría

Se registra

✓upload ID
✓finalidad
✓MIME
✓tamaño
✓hash al completar

Nunca se registra

×contenido del archivo
×token OAuth
×URL firmada en auditoría