Guías de Scale OS
Integraciones con contexto.
Elegí el mecanismo adecuado para conectar tus herramientas. El acceso a los datos de una empresa siempre depende de una autorización y de los permisos vigentes.
Elegí el mecanismo de acceso#
Asistentes y herramientas compatibles con MCP
El conector MCP es el mecanismo documentado para que un cliente autorizado consulte y solicite cambios en Scale mediante OAuth. Expone un catálogo limitado de herramientas y revalida los permisos en cada llamada.
https://api.scaleparaguay.com/mcpVer configuración, permisos y ejemplos de MCP →
API de la aplicación
Scale utiliza endpoints internos para sus propios formularios, módulos y sesiones. Su existencia no los convierte en una API REST pública de acceso arbitrario. Un token MCP no permite llamar cualquier endpoint interno.
Integraciones existentes#
| Integración | Alcance |
|---|---|
| Google, Microsoft y Apple | Inicio de sesión mediante los proveedores configurados. Que el adaptador exista no significa que todos estén habilitados. Acceder a Scale no concede acceso general a Drive ni a otros servicios de identidad. |
| SSO empresarial | La aplicación contempla conexión de identidad por organización. Su disponibilidad depende de la configuración y habilitación de cada empresa. |
| Consulta de RUC | Autocompletado con revisión del dato fiscal según el proveedor disponible. El adaptador OwnData es opcional; su activación empresarial y validación real siguen pendientes de habilitación. |
| OwnCoding UI | Biblioteca compartida de componentes y catálogos, incluidos bancos y localidades; no es una API de datos externos. Un logo bancario no representa una conexión al banco ni un saldo remoto. |
| Correo transaccional | Envío de verificaciones, recuperación e invitaciones por Resend o el relay WEEM configurado en el servidor. No se exponen credenciales de envío a conectores. |
| Carga con IA | Proveedor compatible con chat/completions configurado en el servidor. Analiza el texto pegado y propone datos; la persona revisa y confirma las operaciones. Sin proveedor configurado, la función permanece desactivada. |
| Archivos y Drive | Asociación de enlaces a archivos y carpetas de proyectos. No implica sincronización de almacenamiento ni acceso API general a una cuenta de Drive. |
| Suscripción de Scale | Circuito de checkout y suscripciones con PagaYa/Stripe, condicionado a habilitación, credenciales privadas y webhook verificado. Su disponibilidad no está garantizada por la presencia del código. Es el pago del servicio Scale, separado de los cobros que una agencia registra de sus clientes. |
| Portal de clientes | Acceso del cliente a su circuito de entregas e invitaciones, separado de los permisos internos del equipo. |
La presencia de un adaptador en el producto no acredita que un proveedor esté habilitado en una empresa o entorno. Las credenciales y condiciones externas se configuran por canales privados.
Una operación conserva sus reglas#
- Empresa y persona: no se elige otro tenant ni se eleva el rol desde los argumentos de una herramienta.
- Fechas e historial: las condiciones comerciales guardan vigencias y cronología; los extras corresponden a un mes específico.
- Dinero: previsión de ingresos y cobro real son operaciones distintas. Los cobros conservan idempotencia y controles financieros.
- Contratos: completar un borrador no implica emisión, firma ni aceptación del cliente.
- Datos fiscales: un resultado de consulta debe revisarse antes de aplicarlo; no reemplaza silenciosamente los datos manuales.
Las listas MCP tienen paginación y límites de tamaño. Una respuesta demasiado grande requiere reducir la consulta; no habilita acceso directo a la base de datos.
Prepará tu integración#
- Definí qué datos necesitás consultar y qué cambios debe poder proponer la herramienta.
- Asigná el rol adecuado en Scale y elegí lectura o lectura con escritura al conectar.
- Usá una empresa y datos de prueba para validar el flujo antes de operar información real.
- Comprobá cambios de permisos, revocación, errores de revisión y períodos financieros cerrados.
Para construir un cliente MCP, seguí la referencia de descubrimiento OAuth y las herramientas que devuelve el servidor para esa autorización. Esta página no registra clientes, no ejecuta requests de escritura ni cambia configuración.