Settra

Un servidor MCP autohospedado de Google Sheets y Google Drive para consultar datos de hojas de cálculo con IA.

Documentación

Settra

Haz que los datos de archivos tabulares sean duraderos y fáciles de usar para agentes automatizados.

Settra es un servidor MCP autoalojado que sincroniza datos de origen en PostgreSQL y expone instantáneas duraderas a través de una capa semántica gobernada. Los agentes automatizados pueden descubrir esquemas exactos, inspeccionar muestras limitadas y ejecutar consultas estructuradas sin SQL crudo ni acceso directo a las credenciales de origen.

Está diseñado para equipos que quieren que los agentes trabajen con datos operativos de forma segura, consistente y repetible. La versión actual admite Google Sheets, CSV, Excel y archivos Parquet seleccionados desde Google Drive.

Las fuentes y los destinos se modelan por separado. Cada canal conecta un archivo de Drive a un destino registrado y un espacio de nombres objetivo. Hoy Settra inicializa un destino explícito de PostgreSQL administrado respaldado por la configuración de POSTGRES_* del despliegue, dejando un límite limpio para tipos de destino adicionales más adelante.

[!IMPORTANT] Puedes ejecutar Settra en un servidor que controles o pedirnos que lo alojemos por ti. Para alojamiento administrado, envía un correo a support@outermeasure.com.

¿Qué pueden hacer los agentes?

Encontrar elementos vencidos en un rastreador de operaciones.
Resumir el pipeline de este mes desde una hoja de cálculo de ventas.
Comparar valores reales con objetivos almacenados en otra pestaña.
Identificar filas que cambiaron o que requieren seguimiento.
Reutilizar una definición aprobada como "cliente activo" o "ingresos reconocidos" en consultas posteriores.

Cómo funciona

flowchart LR
    sheet["Google Drive tabular files<br/>Sheets, CSV, Excel, Parquet"]
    sync["dlt full sync<br/>OAuth + loading rules"]
    postgres["PostgreSQL<br/>Durable snapshots"]
    settra["Cube + Settra<br/>Approved semantics"]
    agent["Automated agent<br/>MCP client"]
    task["Question or workflow"]

    task --> agent
    agent -->|"structured metadata and queries"| settra
    sheet --> sync
    sync --> postgres
    postgres --> settra
    settra -->|"bounded results"| agent

Settra detecta el formato del archivo y el delimitador CSV inicial, la codificación y la fila de encabezado, luego realiza una carga de reemplazo completa con dlt. PostgreSQL mantiene la última instantánea exitosa disponible mientras se prepara una nueva. El YAML por fuente controla las anulaciones de análisis, las hojas seleccionadas, los cronogramas, los tipos, los nombres, los contratos de esquema y las descripciones.

La capa semántica canónica brinda a los agentes nombres estables, medidas, dimensiones, definiciones de negocio y reglas de validación en lugar de acceso SQL sin restricciones.

Las colecciones agrupan canales relacionados en espacios de trabajo de agentes enfocados. Un agente que usa la URL MCP global pregunta qué colección usar, carga su contexto una vez y consulta solo sus tablas y cubos de destino derivados. Una URL MCP específica de colección puede fijar opcionalmente esa selección.

Cada cuenta comienza con un espacio de trabajo personal privado. Las conexiones, colecciones, autorización de Google, activos semánticos, consultas de Cube, permisos MCP y métricas de solicitudes están aislados en ese espacio de trabajo. El modelo de membresía está listo para espacios de trabajo organizacionales compartidos sin cambiar la propiedad de los objetos.

Cómo se manejan los datos

Cuando se autoalojan, Settra se ejecuta dentro de la infraestructura que controlas. El token de actualización de OAuth de Google se cifra por espacio de trabajo con SECRET_KEY en el volumen de datos y no se almacena en la base de datos del producto ni en el YAML de origen. Los contenidos de solicitudes/respuestas MCP tampoco se almacenan; el historial de solicitudes de PostgreSQL contiene solo métricas de uso seguras para la privacidad.

Los resultados de las consultas se envían al asistente de IA o agente que conectes, por lo que las políticas de privacidad y retención de ese proveedor aún se aplican.

Lo que necesitas

Un archivo de Google Sheets, CSV, Excel o Parquet en Google Drive.
Un cliente OAuth web de Google Cloud más una clave de API de Google Picker restringida al navegador. Settra solicita acceso específico a archivos solo para los archivos que los usuarios seleccionan.
Un despliegue de Settra.
Un asistente de IA compatible con MCP o un agente automatizado.

Para desarrolladores

Settra es de código abierto bajo la Licencia Apache 2.0.