GuiasConectar clientes de IA

Conectar clientes de IA (MCP)

O DataCNVS executa um servidor do Model Context Protocol (MCP), para que você trabalhe nos seus canvases a partir das ferramentas de IA que já usa. Peça ao Claude ou ao Claude Code para encontrar uma observação, montar uma figura com vários painéis, converter um eixo para outras unidades ou refazer o estilo de um canvas, e ele faz as edições no DataCNVS como você, onde você e seus colaboradores as veem ao vivo.

Nesta página

Os valores dos seus dados nunca chegam à IA

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

Antes de começar #

Um plano pago do DataCNVS. O MCP está incluído em todos os planos pagos do DataCNVS. Em um workspace cujo plano não o inclui, cada ferramenta explica isso e não faz nada.
MCP ativado no seu workspace. Os administradores do workspace controlam isso em Configurações → Workspace → Geral → IA → MCP / clientes de IA externos. Desativá-lo também impede que clientes de IA acessem os canvases e as observações desse workspace, onde quer que estejam compartilhados.
Suas próprias permissões. O cliente de IA age como você. Ele pode abrir exatamente os canvases e as observações que você pode abrir e editar apenas onde você pode editar.

Todos os clientes se conectam à mesma URL do servidor:

https://mcp.datacnvs.com/mcp

Listagens em diretórios

O DataCNVS está listado no diretório de conectores do Claude, então você pode conectá-lo de dentro do Claude sem nenhuma configuração. Também estamos enviando o DataCNVS ao diretório do ChatGPT; até ele ser listado lá, use as configurações gerais abaixo.

Claude (web, desktop e celular) #

O DataCNVS está no diretório de conectores do Claude, então conectar leva só alguns cliques. Um conector que você adiciona no claude.ai também fica disponível nos apps do Claude para desktop e celular, na mesma conta. Você não precisa de uma assinatura paga do Claude para usar o conector.

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

Permissões de ferramentas recomendadas #

Por padrã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 aquelas cujo nome começa com a palavra delete. Deixe essas em Needs approval para evitar exclusões acidentais.

Ferramentas de exclusã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 ao vivo para os colaboradores e podem ser desfeitas por 7 dias. Excluir é definitivo, então a palavra final continua sendo sua.

No Claude Team e no Enterprise, um Owner adiciona o conector uma única vez para a organização. Cada membro então o conecta com o próprio login do DataCNVS, de modo que todos trabalham com suas próprias permissões.

Claude Code #

Adicione o servidor pelo 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. Seu navegador abre o login do DataCNVS e o Claude Code guarda o token para você.

Mantenha --callback-port 33418 exatamente como mostrado: o DataCNVS só aceita logins que retornem a essa porta. Se outro programa estiver usando a porta, feche-o e tente de novo.

O comando acima adiciona o DataCNVS apenas ao projeto atual. Para tê-lo 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 roda no seu próprio computador, ele também ganha a ferramenta request_upload, que envia um arquivo da sua máquina direto para o pipeline de upload do DataCNVS. Os apps web, desktop e celular do Claude não conseguem enviar arquivos assim; faça o upload no DataCNVS.

Configurações genéricas de MCP #

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

Configuraçã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 taxa	60 chamadas de ferramenta por usuário por minuto
Janela para desfazer	7 dias após uma edição

O servidor não oferece suporte a registro dinâmico de clientes, então um cliente precisa de um ID de cliente OAuth pré-registrado. O Claude se conecta pelo diretório e o Claude Code como descrito acima. Para conectar outra coisa, escreva para support@datacnvs.com com o nome do cliente e a URL de redirecionamento OAuth dele.

O scope read cobre encontrar e ler canvases, observações, variáveis, temas e uploads. O scope write é necessário para toda edição e ação. Um cliente conectado apenas com o scope read recebe somente as ferramentas de leitura.

Para testar o servidor manualmente, o MCP Inspector (npx @modelcontextprotocol/inspector@latest) funciona com o mesmo ID de cliente do Claude Code: escolha Streamable HTTP, informe a URL do servidor e o ID de cliente e faça login.

Como as ferramentas funcionam #

Algumas coisas valem a pena saber, seja qual for o cliente:

Primeiro, os workspaces. A IA começa listando seus workspaces e canvases e, em seguida, lê a estrutura de um canvas antes de editá-lo. Você pode indicar um canvas pelo título ou colar o link dele.
Links de canvas funcionam em qualquer lugar. Qualquer ferramenta que peça um canvas aceita a URL dele no DataCNVS.
As edições são aplicadas na hora, como você. Elas aparecem ao vivo para qualquer pessoa com o canvas aberto, como qualquer outra edição.
As edições podem ser desfeitas. Toda edição de canvas retorna um ID de edição, e a IA pode desfazê-la por 7 dias. Você também pode restaurar uma versão anterior pelo histórico de versões do canvas no DataCNVS.
Algumas ações não podem ser desfeitas. Excluir um canvas, uma observação ou um tema, revogar um compartilhamento e as etapas do pipeline de upload são definitivos. Os clientes marcam essas ferramentas como destrutivas e perguntam a você antes.
Você continua no controle. O Claude pede sua aprovação antes de ferramentas que alteram algo, a menos que você as tenha permitido (veja as permissões de ferramentas recomendadas); o Claude Code segue suas configurações de permissão.
Os resultados têm link de volta. Resultados que citam um canvas incluem o link dele, para você ir direto a ele.

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

Dados científicos costumam ser inéditos, confidenciais ou regulados, por isso o DataCNVS foi feito para que uma IA ajude você a montar a figura sem nunca receber os dados que ela contém.

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

O que a IA não pode ver #

Valores dos dados. Valores de séries (cada ponto de cada curva) e valores escalares (medições únicas, 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 retorna valores, e o resultado de qualquer outra ferramenta tem os valores removidos antes de sair do DataCNVS.
Seus arquivos enviados. Nenhuma ferramenta retorna o conteúdo de um arquivo que você enviou.
Tudo que você não pode abrir. A IA trabalha apenas com o que a sua própria conta pode acessar, em workspaces onde o MCP está ativado.

Com o que a IA trabalha #

A estrutura do canvas: painéis, eixos e seus 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 ela devolve ao DataCNVS para indicar quais dados vão onde.

Isso basta para montar e redesenhar o estilo de uma figura, mas significa que títulos, nomes e rótulos ficam visíveis para a IA. Se isso importa para você, não coloque nada sensível neles.

Como as figuras ainda mostram seus dados #

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

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 certas ao desenhar o rótulo. A IA escreve o marcador; ela nunca vê no que ele se transforma.

Você ainda pode pedir dados por valor, como «observações em que a temperatura de recozimento foi acima de 600 °C». O DataCNVS faz essa comparação por conta própria e entrega à IA apenas os IDs das observações correspondentes.

Bom saber #

Seu provedor de IA vê a sua conversa. O que você digita, e os nomes e a estrutura que as ferramentas retornam, são processados pelo provedor de IA que você escolheu, como a Anthropic, conforme o seu contrato com ele.
Agentes locais podem ler arquivos locais. O Claude Code roda no seu computador e pode ler arquivos nele, independentemente do DataCNVS. Se você envia um arquivo com request_upload, o agente já obteve esse arquivo do seu disco; o DataCNVS ainda assim nunca retorna os valores dele.
Valores que você digita são seus para compartilhar. Se você colar números na conversa, a IA os vê, como veria em qualquer outro lugar.

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

Exemplos de uso #

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»? Liste cada painel e o que ele plota.

A IA encontra o canvas nos seus workspaces e descreve o layout dele: painéis, eixos, unidades e as séries de cada um, pelo nome. Ela descreve a figura, não os números dentro dela.

Ferramentaslist_workspaceslist_canvasesread_canvas_model

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

Encontre meus ensaios de tração do lote de amostras B-17 e crie um novo canvas plotando tensão versus deformação, uma linha por corpo de prova.

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

Ferramentassearch_observationscreate_canvasplot_series

Mudar unidades e títulos de eixo #

Em «Corrida do forno 14», mostre 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 exibição, então os valores convertidos nunca passam por ela.

Ferramentasread_canvas_modelset_axis_display_unitset_axis_title

Anotar um gráfico #

Adicione uma linha de limiar tracejada na tensão de escoamento 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. Valores que você informa no prompt, como um limiar, são seus para compartilhar.

Ferramentasread_canvas_modelinsert_threshold_lineinsert_legend

Organizar uma figura com vários painéis #

Transforme isto em uma figura dois por dois: copie o painel superior esquerdo para os outros três.

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

Ferramentasinsert_panelduplicate_panelconfigure_canvas_grid

Refazer o estilo para um periódico #

Aplique nosso tema «Periódico coluna única» a todo canvas com «Nature Paper» no título.

A IA lista os temas do seu workspace e aplica um a cada canvas, para que fontes, tamanhos e cores combinem em todo o artigo.

Ferramentaslist_canvas_themesapply_canvas_theme

Enviar um arquivo (somente Claude Code) #

Envie ./data/run_42.csv ao DataCNVS, associe as colunas às nossas variáveis de sempre e me avise quando estiver pronto para plotar.

O Claude Code envia o arquivo do seu computador, espera 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 retornados à IA.

Ferramentasrequest_uploadwait_for_uploadsubmit_unit_mappings

Desfazer uma alteração #

Desfaça as duas últimas alterações que você fez nesse canvas.

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

Ferramentasundo_canvas_edit

Desativar o acesso #

Para você: remova ou desconecte o DataCNVS no seu cliente (Claude: Settings → Connectors; Claude Code: claude mcp remove datacnvs). Isso exclui os tokens do cliente.
Para um workspace inteiro: um administrador do workspace desativa MCP / clientes de IA externos em Configurações → Workspace → Geral → IA. Vale a partir da próxima chamada de ferramenta, para todos os membros e todos os clientes.
Para dados compartilhados: a chave pertence ao workspace dono de um canvas ou observação, então desativá-la também cobre esses dados onde quer que tenham sido compartilhados.

Precisa de ajuda? #

Se um cliente não conecta, uma ferramenta recusa ou você quer credenciais de cliente para algo que não está listado aqui, escreva para support@datacnvs.com informando o cliente que usa e o que pediu a ele.

Nesta página