Assistentes de IA (Claude, ChatGPT, Copilot)
O Hashdata pode ser usado direto de um assistente de IA, como o Claude, o ChatGPT ou o Microsoft 365 Copilot. Depois de conectado, você pede em linguagem natural e o assistente consulta ou altera os dados da sua conta, sempre com as mesmas permissões que você tem no portal.
Exemplos de pedidos
Quem cria formulários
- "Crie um checklist de inspeção de máquinas a partir de um modelo e exija foto quando a resposta for Não conforme."
- "Torne obrigatórias todas as perguntas da seção EPI."
- "Mostre a pergunta 'Descreva o desvio' só quando a anterior for Não."
- "Gere 20 respostas de teste para eu conferir as notas antes de publicar."
Quem analisa resultados
- "Compare a nota média das inspeções mês a mês nos últimos 3 meses."
- "Quais perguntas tiveram mais Não conforme em outubro?"
- "Gere um PDF com as auditorias da semana passada da fábrica ABC."
- "Corrija a data da inspeção enviada pelo João ontem para 10/11."
Quem acompanha ações
- "Liste as ações atrasadas, agrupadas por responsável."
- "Abra o plano de ação 'Corrigir vazamento na linha 3', com a Maria como responsável e prazo de 30 dias."
- "Adie para 15/12 o prazo da ação 'Trocar o extintor do galpão 2'."
- "Registre a verificação de eficácia dessa ação com a data de hoje."
Peça o resultado no formato que você vai usar: uma tabela, um resumo para a reunião ou o rascunho de um e-mail.
Antes de começar
| O que | Quem faz |
|---|---|
| Ter um plano com acesso via IA. Se o seu plano não o inclui, entre em contato com o atendimento | O responsável pela área de trabalho |
| Deixar a opção Acesso via IA / MCP, no menu Integrações, em Acesso habilitado. Ela já vem habilitada quando o plano inclui o recurso | Quem gerencia as integrações da área de trabalho |
| Liberar o Hashdata no assistente da empresa, quando for o caso: o conector no Claude Team ou Enterprise, os servidores MCP personalizados no ChatGPT Business ou Enterprise, o agente Hashdata no Microsoft 365 | O administrador do assistente na empresa |
| Ter uma conta no assistente e uma conta no Hashdata | Você |
As respostas dos formulários podem conter dados pessoais. Os dados que o assistente consulta são enviados ao fornecedor do assistente (Anthropic, no Claude; OpenAI, no ChatGPT; Microsoft, no Microsoft 365 Copilot) para que ele possa responder. Quem decide se a área de trabalho pode fazer isso é quem gerencia as integrações: se não puder, desabilite o Acesso via IA / MCP.
Conectar
Cada assistente dá um nome diferente para essa ligação: o Claude chama de conector, o ChatGPT de plugin e o Microsoft 365 Copilot de agente. O endereço do Hashdata, quando for pedido, é:
https://mcp.hashdata.app/mcp
- Claude
- ChatGPT
- Microsoft 365 Copilot
Vale para o claude.ai, o Claude Desktop e o app do Claude para celular.
- No claude.ai, abra Configurações (Settings) e entre em Conectores (Connectors).
- Procure Hashdata no diretório de conectores e clique em Conectar (Connect). Se o Hashdata não aparecer,
clique em Adicionar conector personalizado (Add custom connector), informe o nome
Hashdatae o endereço acima e clique em Adicionar (Add). Deixe em branco as opções avançadas. - Entre com a sua conta Hashdata, se for pedido, e autorize o acesso.
- Em uma conversa, ative o conector Hashdata no menu de ferramentas da caixa de mensagem.
A configuração é feita no chatgpt.com, pelo navegador. Se a opção de adicionar um servidor MCP não aparecer, o seu plano do ChatGPT ou o administrador da sua empresa no ChatGPT não a permite.
- Abra chatgpt.com/plugins, clique em + e escolha Add custom MCP server.
- Informe o nome
Hashdatae, em Server URL, o endereço acima. - Em autenticação, escolha OAuth: é o login com a sua conta Hashdata.
- O ChatGPT mostra um aviso de risco, que aparece para qualquer servidor que não seja da própria OpenAI. Leia e confirme em I understand and want to continue.
- Clique em Create as a plugin, instale o plugin, entre com a sua conta Hashdata e autorize o acesso.
- Em uma conversa, escolha o plugin Hashdata.
O Hashdata é um agente do Microsoft 365 Copilot. Ele funciona no Copilot Chat, inclusive no Teams, e não exige licença do Microsoft 365 Copilot.
- Administrador da empresa: no Microsoft 365 admin center, libere o agente Hashdata para a organização ou para os grupos que vão usá-lo.
- Você: no Copilot Chat, abra a lista de agentes e escolha Hashdata. Se ele não aparecer, procure por Hashdata em Obter agentes (Get agents).
- No primeiro pedido, clique em Sign in to Hashdata, entre com a sua conta Hashdata e autorize o acesso, mantendo todas as permissões marcadas.
Autorizar o acesso
Na primeira conexão, abre-se a página Autorizar acesso do Hashdata (my.hashdata.app/connect), com o aplicativo
que pede acesso e as Permissões solicitadas. Confira se o aplicativo é o que você está conectando e clique em
Autorizar; para recusar, clique em Negar.
Primeira conversa
Faça um pedido simples para testar: "Em quais áreas de trabalho do Hashdata eu colaboro?". Se a lista aparecer, a conexão funcionou. Se você colabora em várias áreas de trabalho, diga em qual quer trabalhar. O assistente pode chamar a área de trabalho de space.
O que esperar na prática
| Claude | ChatGPT | Microsoft 365 Copilot | |
|---|---|---|---|
| Permissões | Pede as de leitura na conexão e as de escrita quando você pede uma alteração | Pede na conexão; se faltar alguma, pede de novo ou mostra um erro | Pede todas de uma vez |
| Confirmação de alterações | Pede antes de cada alteração, a menos que você escolha Sempre permitir (Always allow) | Pede antes de cada alteração; a escolha pode valer só até o fim da conversa | Pede antes de cada alteração |
| Desconectar | Configura ções > Conectores | Página de plugins do ChatGPT | Chat settings > Agents |
- Ao pedir um PDF, o assistente solicita a permissão Enviar e editar respostas. Isso é esperado: ele não altera nada sem a sua confirmação.
- Se o assistente não encontrar um formulário, informe o nome exato e a área de trabalho.
- Uma conexão que fica 30 dias sem uso expira, e toda conexão expira depois de 180 dias. Nesses casos, basta conectar de novo.
O que o assistente consegue fazer
| Área | O que o assistente faz |
|---|---|
| Áreas de trabalho | Lista as áreas de trabalho em que você colabora, mostra o plano, as cotas e as pastas, lista os colaboradores e os modelos de formulário disponíveis |
| Formulários | Busca e lê formulários; cria formulários do zero, a partir de um modelo ou copiando outro; adiciona, edita, move e exclui perguntas, seções e textos; configura comentários, fotos e plano de ação em cada pergunta; ajusta várias perguntas de uma vez; muda o tipo de uma pergunta; define fórmulas, regras de visibilidade e a navegação entre páginas; altera as configurações; publica, despublica, arquiva e exclui formulários |
| Respostas | Busca e lê respostas, calcula totais e a distribuição das respostas de cada pergunta e gera PDFs com uma ou várias respostas; envia, edita, complementa e exclui respostas; cria verificações coletivas; gera respostas simuladas em formulários em rascunho |
| Planos de ação | Lê a configuração do plano de ação, busca ações (por exemplo, atrasadas ou de um responsável) e lê um plano de ação completo; cria e edita planos de ação, inclusive reprogramando prazos; registra a execução, a verificação e o cancelamento de ações; exclui planos de ação |
O assistente só vê e altera o que você pode ver e alterar no Hashdata. Se você não tem acesso a uma pasta ou não pode editar um formulário pelo portal, também não consegue fazer isso pelo assistente.
Permissões
Estas são as permissões mostradas na página de autorização:
| Permissão | O que libera |
|---|---|
| Ler seus formulários | Buscar e ler formulários, áreas de trabalho, colaboradores e modelos |
| Criar e editar seus formulários | Criar, editar, publicar, arquivar e excluir formulários |
| Ler as respostas dos seus formulários | Buscar, ler e totalizar respostas |
| Enviar e editar respostas | Enviar, editar, complementar, excluir, verificar e simular respostas e gerar PDFs com respostas |
| Ler seus planos de ação | Ler a configuração, as ações e os planos de ação |
| Criar e editar seus planos de ação | Criar, editar e excluir planos de ação e registrar a execução, a verificação e o cancelamento de ações |
Essas permissões limitam o que o assistente pode fazer em seu nome, mas nunca ampliam o seu acesso: as permissões de colaborador da área de trabalho continuam valendo.
Limitações
- O assistente não vê o conteúdo de fotos e anexos, apenas o nome dos arquivos.
- O assistente não trabalha com workflows, rotinas, convites, tabelas auxiliares nem análises avançadas.
- Em análises com muitas respostas, informe o período, a unidade ou outros filtros.
- Modelos de formulário não podem ser criados nem alterados pelo assistente, apenas usados como ponto de partida.
- Enquanto um recálculo de fórmulas estiver em andamento, o formulário não pode ser editado pelo assistente.
- Alguns tipos de pergunta ainda não podem ser criados pelo assistente; ele informa quais são suportados.
- Os PDFs de respostas são gerados em segundo plano. O assistente acompanha o processamento e entrega o link quando o arquivo fica pronto. Cada PDF tem até 500 respostas e não inclui o plano de ação.
- O assistente exclui até 100 respostas por vez, sempre indicadas uma a uma, e nunca "todas as respostas" de um formulário.
- Respostas simuladas só podem ser geradas em formulários em rascunho, até 50 por vez, e substituem as simuladas anteriores.
- O assistente não envia respostas a formulários que limitam o número de respostas por endereço IP.
- Um plano de ação com ações já concluídas não pode ser excluído.
- Criar e excluir planos de ação segue as mesmas permissões de perfil do portal.
Segurança e boas práticas
- Confirme as alterações: não escolha "sempre permitir" para as ações que excluem dados, como excluir formulários, perguntas, respostas ou planos de ação. Uma exclusão não pode ser desfeita.
- Atenção a ações sensíveis: mudar o tipo de uma pergunta converte as respostas já coletadas, e publicar um formulário cria um link público.
- Peça uma prévia: antes de alterar um formulário, uma resposta ou um plano de ação, o assistente pode mostrar o resultado sem salvar nada. Peça "mostre a prévia antes de salvar" quando quiser revisar.
- Registro das ações: as alterações que o assistente faz em formulários e respostas ficam no Log de modificações (na lista de formulários, opção Visualizar logs do formulário, conforme o plano), com a indicação via IA e o nome do aplicativo. Nesses registros, o endereço IP é o do fornecedor do assistente, não o seu.
- O Hashdata não vê a sua conversa: o Hashdata recebe apenas os pedidos que o assistente faz ao servidor (por exemplo, "buscar as respostas do formulário X") e devolve os dados pedidos.
Desconectar
- De qualquer assistente, pelo Hashdata: no menu do seu perfil, abra Conta e Credenciais > Aplicativos conectados e clique em Revogar (ou Revogar todos). O acesso é cortado na hora.
- Pelo assistente: veja a linha Desconectar em O que esperar na prática.
- Para toda a área de trabalho: no menu Integrações do Hashdata, desabilite o Acesso via IA / MCP. Nenhum assistente consegue mais acessar os dados da área de trabalho até que o acesso seja habilitado de novo.
Problemas comuns
O assistente pode reescrever as mensagens abaixo com outras palavras.
| Mensagem ou sintoma | O que fazer |
|---|---|
| AI/MCP access is turned off for this space. | O Acesso via IA / MCP está desabilitado nessa área de trabalho. Peça a quem gerencia as integrações para habilitá-lo |
| AI/MCP access is not available for this space's plan. | O plano da área de trabalho não inclui o recurso. Entre em contato com o atendimento |
| The user did not grant this permission to the assistant. | Você não autorizou a permissão necessária. Desconecte e conecte o Hashdata de novo, autorizando a permissão pedida |
| A página de autorização mostra Não foi possível concluir | Feche a aba e comece de novo pelo assistente. A página de autorização expira depois de alguns minutos |
| Uma área de trabalho ou um formulário não aparece | Confira se você tem acesso a ele no portal do Hashdata com a mesma conta usada na autorização |
Para desenvolvedores: Claude Code
No terminal, adicione o servidor:
claude mcp add --transport http hashdata https://mcp.hashdata.app/mcp
Depois, dentro do Claude Code, digite /mcp, escolha hashdata e siga a autorização no navegador.
A conexão usa o MCP (Model Context Protocol), um padrão aberto para ligar assistentes de IA a outros sistemas.