Apps conectados

Você pode conectar um assistente de IA — ou outro aplicativo — para ler e atualizar suas tabelas em seu nome, por meio de uma conexão segura que você aprova.

Conectar o Claude

Um assistente se conecta ao servidor MCP do DataWasi, em https://datawasi.app/mcp. O endereço também está em Configurações do usuário → Apps conectados, com um botão para copiá-lo.

1. No Claude (claude.ai ou o app para desktop), abra Configurações → Conectores, adicione um conector personalizado e cole o endereço.
2. O Claude abre o DataWasi: entre e aprove o que ele pode fazer.
3. Pergunte ao Claude sobre suas tabelas — "quanto gastamos com gasolina em março?" — ou diga o que adicionar.

No Claude Code, adicione-o pelo terminal e depois digite /mcp no Claude Code para entrar:

claude mcp add --transport http datawasi https://datawasi.app/mcp

Qualquer outro assistente que se conecte a servidores MCP e entre pelo navegador usa o mesmo endereço.

Como funciona

Quando um aplicativo pede para conectar, você entra e aprova exatamente o que ele pode fazer: ler seus dados, adicionar ou editar registros, ou alterar a estrutura de uma tabela. Nada acontece até você aprovar, e um aplicativo só pode agir dentro do acesso que você concede.

O que um assistente pode fazer

Dentro do acesso que você aprova, um assistente pode:

• Ver suas tabelas e os campos delas: as suas e as que foram compartilhadas com você. As arquivadas, só se pedir, e só para ler.
• Buscar e ler registros, e somá-los: totais, contagens e médias, agrupados por qualquer campo.
• Ler uma tabela pelas visualizações salvas nela: peça "Compras grandes" e ele usa os filtros dessa visualização, sem adivinhá-los.
• Adicionar, editar e excluir registros. Um registro que ele exclui vai para a lixeira da tabela; ele pode ver o que está lá e recuperar um registro, inclusive um que você excluiu.
• Adicionar muitos registros de uma vez — uma pilha de recibos, as linhas de uma planilha — e dizer quais não conseguiu adicionar, e por quê.
• Ler o histórico e os comentários de um registro — quem mudou o valor, o que alguém disse sobre ele — e comentar em seu nome. Uma @menção no comentário avisa essa pessoa, como a sua avisaria; onde os comentários de uma tabela estão desativados, ele não pode comentar.
• Criar tabelas, renomeá-las, e adicionar e alterar seus campos, se você deixar que ele mude a estrutura de uma tabela.
• Adicionar opções a um campo de Opções — uma categoria nova, um status novo — com esse mesmo acesso. As opções que já existem, e os registros que as usam, ficam como estão; renomear ou remover uma é com você, nas configurações do campo.
• Ler os arquivos anexados a um registro e anexar arquivos novos (veja Arquivos, mais abaixo).

Quando um assistente monta suas tabelas

Dê a um assistente que pode mudar a estrutura das suas tabelas uma pilha de faturas, ou conte o que você quer acompanhar, e ele monta tabelas que guardam tudo sem que você precise explicar: um cliente ou um produto que aparece de novo e de novo ganha sua própria tabela, e cada registro aponta para ele; as linhas de uma fatura ficam dentro da fatura. Um valor simples, como uma moeda ou um status, fica como uma opção do registro em vez de virar outra tabela — e quando os valores vêm em várias moedas, cada valor segue essa opção, então cada registro mostra a sua.

Ele também pode montar o layout dos registros — seções lado a lado, o total grande — para que apareçam e sejam impressos como os papéis de onde vieram (veja o layout dos registros).

Gerenciar conexões

Abra Configurações do usuário → Apps conectados para ver tudo o que você autorizou. Desconecte um aplicativo para revogar o acesso dele imediatamente.

Até onde vai a escrita, tabela por tabela

Quando você dá a um aplicativo acesso de escrita, a mesma tela deixa você decidir até onde isso vai em cada tabela em que pode escrever: criar, atualizar e excluir (o padrão), criar e atualizar, ou apenas criar — para um livro de gastos ao qual um assistente pode acrescentar, mas nunca alterar. A leitura nunca é limitada por aqui, e tabelas criadas depois terão tudo.

Os limites de cada conexão aparecem em Configurações do usuário → Apps conectados. Como o resto do que você aprovou, mudá-los significa desconectar o aplicativo e conectá-lo de novo.

Arquivos

Um assistente pode ler os arquivos anexados a um registro e anexar arquivos novos. Ao ler um registro, ele recebe um link para baixar cada arquivo, que funciona por 15 minutos: o bastante para abrir o PDF de uma fatura ou salvar uma foto, e o link que fica na conversa logo deixa de funcionar. Para anexar um arquivo, ele o envia direto para o seu armazenamento e depois o adiciona ao registro.

As duas coisas exigem um assistente que consiga executar comandos em um computador, como o Claude Code: o arquivo passa pela conexão dele, nunca pelo chat. Anexar conta como editar o registro, então exige acesso de escrita e uma tabela em que a conexão possa atualizar registros, e os tipos de arquivo que o campo aceita e o limite de 100 MB valem como para você. Um assistente não pode remover um arquivo.

Tokens de acesso pessoal

Algumas coisas não conseguem entrar por um navegador: um passo do Zapier, Make ou n8n, um script que roda toda noite, uma máquina que você controla. Para isso, crie um token de acesso pessoal — uma chave de longa duração que age por você na API, sem a tela de aprovação. Um token serve só para a API, não para o servidor MCP: para conectar um assistente, use o endereço lá de cima.

1. Abra Configurações do usuário → Apps conectados e escolha Novo token.
2. Dê a ele um nome que diga quem o usa, decida se ele só pode ler ou também criar, atualizar e excluir registros — e, se escreve, até onde isso vai em cada tabela, exatamente como num aplicativo conectado — e escolha quando expira: em 90 dias, um ano ou dois.
3. Copie o token na página seguinte. Ele é mostrado só dessa vez; se perdê-lo, revogue-o e crie outro.

Os tokens aparecem na mesma lista que seus aplicativos conectados, com o nome, o que podem fazer, quando foram usados pela última vez e quando expiram. Revogue um a qualquer momento; o que o usava perde o acesso imediatamente.

Enviar registros de fora

Um token pode adicionar registros a uma tabela, além de lê-la. Além de criar e atualizar registros por id, a API tem uma chamada de upsert: você envia o campo que identifica o registro no outro sistema — um número de fatura, um id de pedido — e os valores, e ela atualiza o registro que coincide ou cria um quando não há nenhum. Também pode adicionar um registro a partir de uma frase: você envia o que alguém disse ou escreveu — "500 de gasolina no posto, hoje" — e a IA preenche os campos da tabela com isso, como lê uma foto (conta para o uso de IA da conta). A página que mostra um token novo traz uma chamada de exemplo para começar.