Settra

Um servidor MCP auto-hospedado para Google Sheets e Google Drive, para consultar dados de planilhas com IA.

Documentação

Settra

Torne os dados de arquivos tabulares duráveis e fáceis de usar para agentes automatizados.

O Settra é um servidor MCP auto-hospedado que sincroniza dados de origem no PostgreSQL e expõe snapshots duráveis por meio de uma camada semântica governada. Agentes automatizados podem descobrir esquemas exatos, inspecionar amostras limitadas e executar consultas estruturadas sem SQL bruto ou acesso direto às credenciais da fonte.

Ele foi criado para equipes que desejam que agentes trabalhem com dados operacionais com segurança, consistência e repetibilidade. A versão atual oferece suporte a Google Sheets, CSV, Excel e arquivos Parquet selecionados no Google Drive.

Fontes e destinos são modelados separadamente. Cada pipe conecta um arquivo do Drive a um destino registrado e a um namespace de destino. Hoje, o Settra inicializa um destino explícito de PostgreSQL gerenciado, respaldado pelas configurações de POSTGRES_* da implantação, deixando um limite claro para tipos adicionais de destino no futuro.

[!IMPORTANT] Você pode executar o Settra em um servidor que você controla ou pedir que nós o hospedemos para você. Para hospedagem gerenciada, envie um e-mail para support@outermeasure.com.

O que os agentes podem fazer?

Encontrar itens atrasados em um rastreador de operações.
Resumir o pipeline deste mês a partir de uma planilha de vendas.
Comparar valores reais com metas armazenadas em outra aba.
Identificar linhas que mudaram ou que precisam de acompanhamento.
Reutilizar uma definição aprovada, como "cliente ativo" ou "receita reconhecida", em consultas posteriores.

Como 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

O Settra detecta o formato do arquivo e o delimitador CSV inicial, a codificação e a linha de cabeçalho e, em seguida, realiza uma carga de substituição completa com o dlt. O PostgreSQL mantém o último snapshot bem-sucedido disponível enquanto um novo é preparado. O YAML por fonte controla substituições de análise, planilhas selecionadas, agendamentos, tipos, nomes, contratos de esquema e descrições.

A camada semântica canônica dá aos agentes nomes estáveis, medidas, dimensões, definições de negócios e regras de validação, em vez de acesso irrestrito a SQL.

As coleções agrupam pipes relacionados em espaços de trabalho de agentes focados. Um agente que usa a URL MCP global pergunta qual coleção usar, carrega o contexto dela uma vez e consulta apenas as tabelas e cubos de destino derivados dela. Uma URL MCP específica de coleção pode, opcionalmente, fixar essa seleção.

Cada conta começa com um espaço de trabalho pessoal privado. Conexões, coleções, autorização do Google, ativos semânticos, consultas Cube, concessões MCP e métricas de solicitação são isolados nesse espaço de trabalho. O modelo de associação está pronto para espaços de trabalho organizacionais compartilhados, sem alterar a propriedade dos objetos.

Como os dados são tratados

Quando auto-hospedado, o Settra é executado dentro da infraestrutura que você controla. O token de atualização OAuth do Google é criptografado por espaço de trabalho com SECRET_KEY no volume de dados e não é armazenado no banco de dados do produto nem no YAML de origem. O conteúdo de solicitações/respostas MCP também não é armazenado; o histórico de solicitações do PostgreSQL contém apenas métricas de uso seguras para a privacidade.

Os resultados das consultas são enviados ao assistente de IA ou ao agente que você conectar, portanto, as políticas de privacidade e retenção desse provedor ainda se aplicam.

O que você precisa

Um arquivo Google Sheets, CSV, Excel ou Parquet no Google Drive.
Um cliente OAuth Web do Google Cloud, além de uma chave da API Google Picker restrita ao navegador. O Settra solicita acesso específico a arquivos apenas para os arquivos que os usuários selecionam.
Uma implantação do Settra.
Um assistente de IA compatível com MCP ou um agente automatizado.

Para desenvolvedores

O Settra é open source sob a Licença Apache 2.0.