Assistentes de IA (MCP)

O DeepVisuals expõe um servidor MCP (Model Context Protocol) que permite a um assistente de IA ler o modelo de dados e construir dashboards consigo.

O que isto permite

Com a ligação feita, pode pedir a um assistente coisas como:

"Que tabelas tenho na conta e que campos têm?"

"Cria um dashboard chamado Margens com um KPI da margem total e um gráfico de barras por categoria."

"No dashboard de Vendas, muda o gráfico mensal para área e acrescenta uma tabela dos dez produtos com maior margem."

O assistente trabalha através das mesmas operações que a interface usa — não há um caminho paralelo aos dados.

Ligar

A página Definições → MCP (/settings/mcp) mostra o endereço do servidor e instruções para os clientes mais comuns:

Cliente	Como se liga
claude.ai	Custom Connector, com o endereço do servidor
ChatGPT	Custom Connector, com o mesmo endereço
Claude Code	Comando de adição de servidor MCP

A ligação é feita por OAuth 2.1: o cliente pede autorização, o utilizador aprova num ecrã de consentimento, e o cliente recebe um token. Não há chaves para copiar nem passwords partilhadas.

Permissões

O token vale o que o utilizador que o autorizou vale. Um assistente ligado por uma conta de leitura lê; não cria nem altera nada.

O acesso por categoria também se aplica: o assistente vê os dashboards que aquele utilizador veria.

Aplicações ligadas

A mesma página lista as aplicações ligadas por si, com a data de ligação, e permite revogar cada uma. Revogar invalida o token imediatamente.

A lista é pessoal: cada utilizador vê e revoga as suas.

O que o assistente pode fazer

As operações disponíveis cobrem quatro áreas:

Dashboards — listar, ver, criar, renomear, apagar, clonar, publicar e despublicar.

Ecrãs e widgets — ler o documento de um ecrã, listar os ecrãs de um dashboard, criar e apagar ecrãs de detalhe, substituir um documento inteiro, e listar, acrescentar, alterar, mover e remover widgets.

Dados — listar as entidades do modelo com os seus campos, consultar dados em leitura, e pré-visualizar as primeiras linhas de uma entidade.

O assistente não importa dados

Sobre dados, o servidor MCP é só de leitura: não importa ficheiros Excel, não cria tabelas nem conjuntos partilhados, não acrescenta nem substitui linhas, e não apaga nada. Um assistente monta dashboards sobre os dados que já lá estão — a importação é sempre feita por uma pessoa, pelo assistente de importação. Ver Importar um Excel.

Organização e histórico — listar e criar categorias, consultar o histórico de alterações e repor uma versão anterior.

Há ainda duas operações de documentação, que o assistente usa para se orientar: a referência do formato dos ecrãs e a do SDK de eventos. São geradas do próprio código, e é por isso que um assistente ligado sabe exactamente que widgets existem e que propriedades têm.

O que o servidor MCP não faz

Não expõe nada de administração da plataforma: não gere contas, não aprova licenças, não lê registos de auditoria globais. Tudo o que faz está dentro de uma conta e limitado às permissões de quem autorizou.

Alterações feitas por um assistente

Ficam registadas no histórico como as outras, mas marcadas como vindas de MCP, com o nome do utilizador que autorizou.

Reverter é igual a reverter qualquer alteração — ver Histórico de versões.

Modo Autónomo

Quando um assistente está a trabalhar num dashboard, a aplicação mostra um aviso a indicá-lo. É útil quando se está a acompanhar o trabalho no ecrã: evita a confusão de ver widgets a aparecer sem se perceber porquê.

Sair do Modo Autónomo fecha o aviso e devolve o controlo.

Boas práticas

Ligue com uma conta adequada. Se o objectivo é só explorar, ligue com uma conta de leitura.

Reveja o que foi feito. O histórico mostra cada alteração; ler antes de publicar é barato.

Revogue o que já não usa. A lista de aplicações ligadas tende a acumular.