Guías de Scale OS

Conectá tu asistente con Scale.

MCP permite que un asistente compatible trabaje con las herramientas de Scale en la empresa que autorizás, respetando tus permisos actuales.

Conectar por OAuth#

En un cliente que admita servidores MCP remotos con Streamable HTTP y OAuth, agregá esta URL. El bloque es texto seleccionable para copiar.

https://api.scaleparaguay.com/mcp

Elegí autenticación OAuth en el cliente.
Iniciá sesión en Scale. Revisá la empresa, la URL completa de retorno y los permisos solicitados.
Aprobá la conexión en la pantalla de consentimiento de Scale. Podés rechazarla si el destino no coincide con el cliente que elegiste.
Pedile una consulta sencilla, por ejemplo: «Mostrame los clientes de mi empresa».

Elegí cuánto acceso dar#

scale:read: consultar los datos que tu rol puede ver.
scale:write: solicitar cambios que tu rol puede realizar.

Un cliente puede solicitar ambos scopes o sólo lectura. La autorización queda ligada a tu empresa y no amplía tus permisos. Cada llamada comprueba nuevamente usuario, membresía, empresa, suscripción, rol y excepciones de capacidades.

Las escrituras requieren confirm: true y los datos del formulario correspondiente. El asistente debe confirmar el cambio con vos antes de enviarlo. Ese campo no equivale a una firma ni reemplaza el consentimiento OAuth.

41 herramientas, según tus permisos#

El listado que recibe el asistente incluye sólo las herramientas disponibles para tu autorización y rol. Todas usan las validaciones de los módulos de Scale.

Áreas y operaciones del catálogo MCP
Área	Operaciones
Clientes	Listar, consultar, crear y editar; consultar reporting e historial de plan; actualizar condiciones comerciales.
Planes personalizados	Listar, crear y editar el catálogo de planes.
Proyectos y piezas	Listar, consultar, crear y editar proyectos y órdenes de trabajo.
Tareas internas	Listar, consultar, crear y editar.
Presupuestos y contratos	Listar, consultar, crear y editar según las reglas de cada documento.
Inventario	Listar, crear y editar.
Ingresos mensuales	Consultar por mes, agregar y editar bases o extras con revisión y motivo.
Gastos planificados	Listar por mes, crear y editar.
Cobros	Listar recibos y registrar un cobro real con autorización reciente.

El conector no ofrece eliminación, cambios de roles, administración global, secretos, SQL, deploy, transferencias ni edición directa de saldos. No agrega un circuito alternativo de emisión o firma de contratos. La integración de firma digital bilateral sigue siendo una propuesta, sin firma certificada implementada.

Planes, precios y extras#

Crear un plan y asignarlo a un cliente

Son dos operaciones: primero crear el plan con scale_create_plan; después asignar su identificador positivo con scale_update_client_commercial_terms. No se acepta un planId vacío. Antes de cambiar condiciones, consultá scale_get_client_plan_history para obtener la revisión vigente.

Ejemplo de pedido al asistente (datos ficticios):
“Creá un plan personalizado de cuatro videos por
Gs. 400.000. Después mostrame la propuesta para
asignarlo al cliente Estudio Ejemplo desde noviembre.”

La asignación requiere los campos comerciales completos, fecha de vigencia, motivo, requestId y expectedRevision. Si otra persona cambió el acuerdo, hay que consultar de nuevo antes de guardar. Los períodos cerrados siguen protegidos y el historial conserva los precios anteriores.

Agregar un ingreso de un mes

Para un servicio adicional de noviembre, usá scale_add_client_monthly_income con mes, tipo, concepto, importe, moneda, motivo, identificador de operación y revisión. Esto registra una previsión del mes; no sustituye el acuerdo permanente ni registra un cobro.

Ejemplo sintético de argumentos, sin ejecutar:
{
  "id": "123",
  "confirm": true,
  "data": {
    "month": "2026-11",
    "kind": "extra",
    "label": "Cobertura adicional",
    "amount": "250000",
    "currency": "PYG",
    "requestId": "00000000-0000-4000-8000-000000000001",
    "expectedRevision": "0",
    "reason": "Cobertura extra acordada con el cliente"
  }
}

Los IDs y la revisión del ejemplo son ficticios: el asistente debe consultar los valores actuales antes de proponer una operación.

Referencia OAuth#

El servidor usa el SDK oficial MCP 1.32.1, PKCE S256 obligatorio, registro dinámico de clientes públicos (DCR) y audiencia resource exacta. Las URLs de retorno se registran y comparan exactamente, con HTTPS.

Recurso:
https://api.scaleparaguay.com/mcp

Metadatos del recurso protegido:
https://api.scaleparaguay.com/.well-known/oauth-protected-resource/mcp

Metadatos del servidor de autorización:
https://api.scaleparaguay.com/.well-known/oauth-authorization-server

El cliente descubre los endpoints de autorización, registro, tokens y revocación desde esos metadatos. La solicitud de consentimiento dura 10 minutos, el código es de un solo uso y dura 60 segundos, el acceso dura 1 hora y la renovación hasta 30 días. Los tokens se guardan como hashes; la renovación rota el token y reutilizar uno consumido revoca la conexión.

Los tokens MCP se envían por Authorization: Bearer a su recurso. No sirven como sesión del navegador ni como credencial general para la API REST interna. Client ID Metadata Documents (CIMD) no está implementado.

Referencia: especificación de autorización MCP. Para otras integraciones, consultá la guía de API e integraciones.

Revocar y resolver problemas#

En Configuración o Preferencias, abrí tus conexiones y revocá la que corresponda. La revocación invalida acceso y renovación. Si perdés tu acceso a la empresa, la conexión deja de estar autorizada.

Falta una herramienta: revisá los scopes y tu permiso para ese módulo.
La revisión cambió: consultá el registro actual y confirmá otra vez el cambio.
Período cerrado: corregí la fecha o seguí el procedimiento financiero desde Scale.
Cobro requiere autorización reciente: iniciá sesión y autorizá una conexión nueva.
Conexión ocupada: esperá un momento y reintentá. La concurrencia se limita para proteger las transacciones.

No compartas tokens, códigos de autorización ni credenciales en un chat o una captura. Esta guía no ejecuta operaciones ni autoriza conexiones por sí sola.

Conocé el espacio de trabajo antes de conectar tus herramientas.Explorar demo