GuiasLigar clientes de IA

Ligar clientes de IA (MCP)

O DataCNVS executa um servidor Model Context Protocol (MCP), para que possa trabalhar nos seus canvases a partir das ferramentas de IA que já utiliza. Peça ao Claude ou ao Claude Code que encontre uma observação, monte uma figura com vários painéis, converta um eixo para outras unidades ou refaça o estilo de um canvas, e ele faz as edições no DataCNVS em seu nome, onde o utilizador e os seus colaboradores as veem em direto.

Nesta página

Os valores dos seus dados nunca chegam à IA

Os clientes de IA ligados constroem e editam o gráfico: painéis, eixos, séries, rótulos e estilo. Nunca recebem os números das suas observações. O DataCNVS desenha a figura a partir dos seus dados dentro da aplicação. Como funciona.

Antes de começar #

Um plano pago do DataCNVS. O MCP está incluído em todos os planos pagos do DataCNVS. Num workspace cujo plano não o inclui, cada ferramenta explica-o e não faz nada.
MCP ativado no seu workspace. Os administradores do workspace controlam isto em Definições → Workspace → Geral → IA → MCP / clientes de IA externos. Desativá-lo também impede os clientes de IA de acederem aos canvases e às observações desse workspace, onde quer que estejam partilhados.
As suas próprias permissões. O cliente de IA age em seu nome. Pode abrir exatamente os canvases e as observações que o utilizador pode abrir e editar apenas onde o utilizador pode editar.

Todos os clientes se ligam ao mesmo URL do servidor:

https://mcp.datacnvs.com/mcp

Listagens em diretórios

O DataCNVS está listado no diretório de conectores do Claude, pelo que pode ligá-lo a partir do Claude sem qualquer configuração. Estamos também a submetê-lo ao diretório do ChatGPT; até estar listado aí, use as definições gerais abaixo.

Claude (web, computador e telemóvel) #

O DataCNVS está no diretório de conectores do Claude, pelo que a ligação demora apenas alguns cliques. Um conector que adicione no claude.ai fica também disponível nas aplicações Claude para computador e telemóvel, na mesma conta. Não precisa de uma subscrição paga do Claude para utilizar o conector.

Abra a página do DataCNVS no diretório do Claude ou vá a Settings → Connectors no Claude e procure por DataCNVS.
Escolha Connect to Claude.
Inicie sessão com a sua conta DataCNVS e aprove o acesso que o Claude pede: ler os seus canvases e editá-los.
Defina as permissões das ferramentas conforme recomendado abaixo.
Numa conversa, ative o DataCNVS no menu de ferramentas e pergunte à vontade.

Permissões de ferramentas recomendadas #

Por predefinição, o Claude pergunta antes de cada ferramenta que altera algo. Abra Settings → Connectors → DataCNVS e defina as permissões das ferramentas. Recomendamos Always allow para todas as ferramentas de leitura e escrita, exceto as cujo nome começa pela palavra delete. Deixe essas em Needs approval para evitar eliminações acidentais.

Ferramentas de eliminaçãodelete_canvasdelete_canvas_themedelete_observationdelete_observation_memberdelete_plot_objectdelete_variable

As ferramentas de leitura e escrita podem ser automatizadas sem receio: as alterações são aplicadas em seu nome, aparecem em direto para os colaboradores e podem ser anuladas durante 7 dias. Eliminar é definitivo, por isso fica com a última palavra.

No Claude Team e no Enterprise, um Owner adiciona o conector uma única vez para a organização. Cada membro liga-o depois com o seu próprio início de sessão no DataCNVS, pelo que todos trabalham com as suas próprias permissões.

Claude Code #

Adicione o servidor a partir do terminal:

bash

claude mcp add --transport http datacnvs https://mcp.datacnvs.com/mcp \
  --client-id 3f7or4t9so6894qi3ofgbgs79j --callback-port 33418

Depois inicie o Claude Code, execute /mcp, escolha datacnvs e selecione Authenticate. O navegador abre o início de sessão do DataCNVS e o Claude Code guarda o token por si.

Mantenha --callback-port 33418 exatamente como mostrado: o DataCNVS só aceita inícios de sessão que regressem a essa porta. Se outro programa a estiver a usar, feche-o e tente novamente.

O comando acima adiciona o DataCNVS apenas ao projeto atual. Para o ter em todos os projetos, acrescente --scope user:

bash

claude mcp add --transport http --scope user datacnvs https://mcp.datacnvs.com/mcp \
  --client-id 3f7or4t9so6894qi3ofgbgs79j --callback-port 33418

Como o Claude Code é executado no seu próprio computador, também recebe a ferramenta request_upload, que carrega um ficheiro da sua máquina diretamente para o pipeline de carregamento do DataCNVS. As aplicações web, de computador e de telemóvel do Claude não conseguem enviar ficheiros desta forma; faça o carregamento no DataCNVS.

Definições MCP genéricas #

Para ligar qualquer outro cliente MCP, ou para verificar a configuração de um cliente, estas são as definições do servidor:

Definição	Valor
URL do servidor	`https://mcp.datacnvs.com/mcp`
Transporte	Streamable HTTP
Autenticação	OAuth 2.1, código de autorização + PKCE (S256)
Scopes	`https://mcp.datacnvs.com/mcp/canvas.readhttps://mcp.datacnvs.com/mcp/canvas.write`
Metadados do recurso protegido	`https://mcp.datacnvs.com/.well-known/oauth-protected-resource`
Metadados do servidor de autorização	`https://mcp.datacnvs.com/.well-known/oauth-authorization-server`
Limite de pedidos	60 chamadas de ferramentas por utilizador por minuto
Prazo para anular	7 dias após uma edição

O servidor não suporta registo dinâmico de clientes, pelo que um cliente precisa de um ID de cliente OAuth pré-registado. O Claude liga-se através do diretório e o Claude Code como descrito acima. Para ligar outra coisa, escreva para support@datacnvs.com com o nome do cliente e o respetivo URL de redirecionamento OAuth.

O scope read abrange encontrar e ler canvases, observações, variáveis, temas e carregamentos. O scope write é necessário para qualquer edição e ação. A um cliente que iniciou sessão apenas com o scope read são oferecidas somente as ferramentas de leitura.

Para experimentar o servidor manualmente, o MCP Inspector (npx @modelcontextprotocol/inspector@latest) funciona com o mesmo ID de cliente do Claude Code: escolha Streamable HTTP, introduza o URL do servidor e o ID de cliente e inicie sessão.

Como funcionam as ferramentas #

Há algumas coisas que vale a pena saber, seja qual for o cliente:

Primeiro, os workspaces. A IA começa por listar os seus workspaces e canvases e depois lê a estrutura de um canvas antes de o editar. Pode indicar um canvas pelo título ou colar a respetiva ligação.
As ligações de canvas funcionam em qualquer lado. Qualquer ferramenta que peça um canvas aceita o respetivo URL do DataCNVS.
As edições aplicam-se de imediato, em seu nome. Aparecem em direto para quem tiver o canvas aberto, como qualquer outra edição.
As edições podem ser anuladas. Cada edição de canvas devolve um ID de edição, e a IA pode anulá-la durante 7 dias. Também pode restaurar uma versão anterior a partir do histórico de versões do canvas no DataCNVS.
Algumas ações não podem ser anuladas. Eliminar um canvas, uma observação ou um tema, revogar uma partilha e os passos do pipeline de carregamento são definitivos. Os clientes assinalam estas ferramentas como destrutivas e perguntam-lhe antes.
Mantém o controlo. O Claude pede a sua aprovação antes das ferramentas que alteram algo, a menos que as tenha permitido (veja as permissões de ferramentas recomendadas); o Claude Code segue as suas definições de permissões.
Os resultados têm ligação de volta. Os resultados que indicam um canvas incluem a respetiva ligação, para que possa ir diretamente até ele.

Privacidade: a IA nunca vê os valores dos seus dados #

Os dados científicos são muitas vezes inéditos, confidenciais ou regulamentados, pelo que o DataCNVS foi concebido para que uma IA o ajude a construir a figura sem nunca receber os dados que ela contém.

Os clientes de IA constroem o gráfico. O DataCNVS desenha os seus dados nele. Os valores em si nunca saem do DataCNVS.

O que a IA não pode ver #

Valores dos dados. Os valores de séries (cada ponto de cada curva) e os valores escalares (medições individuais, como a massa de uma amostra ou o setpoint de um forno) nunca são enviados a um cliente de IA. A ferramenta que lê uma observação não devolve valores, e o resultado de qualquer outra ferramenta tem os valores removidos antes de sair do DataCNVS.
Os seus ficheiros carregados. Nenhuma ferramenta devolve o conteúdo de um ficheiro que carregou.
Tudo o que não pode abrir. A IA trabalha apenas com aquilo a que a sua própria conta pode aceder, em workspaces onde o MCP está ativado.

Com o que a IA trabalha #

A estrutura do canvas: painéis, eixos e respetivos intervalos, séries, legendas, anotações, temas e estilo.
Nomes e descrições: títulos de canvases e observações, nomes de variáveis, unidades, grandezas e os rótulos de texto das suas figuras.
Referências: IDs de observações e variáveis, que devolve ao DataCNVS para indicar que dados vão para onde.

Isto chega para construir e redesenhar o estilo de uma figura, mas significa que títulos, nomes e rótulos ficam visíveis para a IA. Se isso lhe importa, não coloque neles nada sensível.

Como as figuras continuam a mostrar os seus dados #

Quando a IA representa uma série, entrega ao DataCNVS uma referência à observação e à variável, nunca os números. O DataCNVS carrega então os valores no seu navegador, converte as unidades e desenha-os. Intervalos de eixos, marcas e ajustes são todos calculados pelo DataCNVS.

O texto que mostra um valor, como um rótulo com a massa de uma amostra, usa um token de rótulo: um marcador que nomeia a variável, que o DataCNVS preenche e converte para as unidades corretas ao desenhar o rótulo. A IA escreve o marcador; nunca vê aquilo em que ele se transforma.

Pode continuar a pedir dados por valor, como «observações em que a temperatura de recozimento foi superior a 600 °C». O DataCNVS faz essa comparação por si e entrega à IA apenas os IDs das observações correspondentes.

Convém saber #

O seu fornecedor de IA vê a sua conversa. O que escreve, e os nomes e a estrutura que as ferramentas devolvem, são processados pelo fornecedor de IA que escolheu, como a Anthropic, ao abrigo do seu acordo com ele.
Os agentes locais podem ler ficheiros locais. O Claude Code é executado no seu computador e pode ler ficheiros nele, independentemente do DataCNVS. Se carregar um ficheiro com request_upload, o agente já obteve esse ficheiro do seu disco; o DataCNVS continua, ainda assim, a nunca devolver os respetivos valores.
Os valores que escreve são seus para partilhar. Se colar números na conversa, a IA vê-os, como veria em qualquer outro lado.

Para saber mais, consulte a nossa política de privacidade e a nossa descrição geral de segurança.

Exemplos de utilização #

Fale com a IA como falaria com um colega que conhece o DataCNVS. Cada exemplo mostra um prompt, o que acontece e as ferramentas normalmente envolvidas.

Encontrar e descrever um canvas #

O que há no meu canvas «Ensaios de fluência 2026»? Lista cada painel e o que ele representa.

A IA encontra o canvas nos seus workspaces e descreve a respetiva disposição: painéis, eixos, unidades e as séries de cada um, pelo nome. Descreve a figura, não os números que ela contém.

Ferramentaslist_workspaceslist_canvasesread_canvas_model

Construir uma figura a partir das suas observações #

Encontra os meus ensaios de tração do lote de amostras B-17 e cria um novo canvas a representar a tensão em função da deformação, uma linha por provete.

A IA pesquisa as suas observações, cria um canvas e representa cada uma como uma série por referência. O DataCNVS carrega e desenha os dados.

Ferramentassearch_observationscreate_canvasplot_series

Alterar unidades e títulos de eixos #

Em «Ciclo do forno 14», mostra a temperatura em °C em vez de K e dá ao eixo y o título «Temperatura (°C)».

A conversão de unidades acontece no DataCNVS. A IA só escolhe a unidade de apresentação, pelo que os valores convertidos nunca passam por ela.

Ferramentasread_canvas_modelset_axis_display_unitset_axis_title

Anotar um gráfico #

Adiciona uma linha de limiar tracejada na tensão de cedência no painel de cima e uma legenda no canto superior esquerdo.

Anotações, linhas de limiar, chamadas e legendas são todos objetos do gráfico que a IA pode posicionar e estilizar. Os valores que indicar no prompt, como um limiar, são seus para partilhar.

Ferramentasread_canvas_modelinsert_threshold_lineinsert_legend

Organizar uma figura com vários painéis #

Transforma isto numa figura dois por dois: copia o painel superior esquerdo para os outros três.

A IA trabalha com a grelha do canvas: inserindo e duplicando painéis e definindo espaçamentos e margens.

Ferramentasinsert_panelduplicate_panelconfigure_canvas_grid

Refazer o estilo para uma revista científica #

Aplica o nosso tema «Revista coluna única» a todos os canvases com «Nature Paper» no título.

A IA lista os temas do seu workspace e aplica um a cada canvas, para que tipos de letra, tamanhos e cores sejam coerentes em todo o artigo.

Ferramentaslist_canvas_themesapply_canvas_theme

Carregar um ficheiro (apenas Claude Code) #

Carrega ./data/run_42.csv no DataCNVS, associa as colunas às nossas variáveis habituais e avisa-me quando estiver pronto a representar.

O Claude Code carrega o ficheiro do seu computador, aguarda a análise e submete os mapeamentos de unidades. O DataCNVS faz a análise e a conversão; os valores analisados nunca são devolvidos à IA.

Ferramentasrequest_uploadwait_for_uploadsubmit_unit_mappings

Anular uma alteração #

Anula as duas últimas alterações que fizeste a esse canvas.

Cada edição de canvas tem um ID de edição que a IA pode anular, desde que nada tenha alterado os mesmos objetos entretanto. Para reversões maiores, restaure uma versão anterior a partir do histórico de versões do canvas.

Ferramentasundo_canvas_edit

Desativar o acesso #

Para si: remova ou desligue o DataCNVS no seu cliente (Claude: Settings → Connectors; Claude Code: claude mcp remove datacnvs). Isto elimina os tokens do cliente.
Para um workspace inteiro: um administrador do workspace desativa MCP / clientes de IA externos em Definições → Workspace → Geral → IA. Tem efeito a partir da chamada de ferramenta seguinte, para todos os membros e todos os clientes.
Para dados partilhados: o interruptor pertence ao workspace dono de um canvas ou observação, pelo que desativá-lo abrange também esses dados onde quer que tenham sido partilhados.

Precisa de ajuda? #

Se um cliente não liga, uma ferramenta recusa ou quer credenciais de cliente para algo que não está listado aqui, escreva para support@datacnvs.com indicando o cliente que utiliza e o que lhe pediu.

Nesta página