Integração · Dados de empresas

Conecte Claude e ChatGPT ao Hex

Peça à sua IA para reexecutar o projeto de receita semanal, buscar os resultados mais recentes de uma célula SQL ou fazer perguntas sobre dados à própria IA do Hex. Ela pode listar e executar projetos, acompanhar execuções, ler células, saídas e gráficos, adicionar ou alterar células SQL, código e markdown, e pesquisar coleções, usuários e conexões de dados no seu workspace.

Ligar Hex gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Execute o projeto de receita semanal com a região definida como Nórdicos.”
A IA executa a versão mais recente publicada com esse valor de entrada e retorna um ID de execução que ela pode verificar.
“A última execução do painel de churn terminou?”
Ela lista as execuções do projeto e lê o status da mais recente, como EXECUTANDO, ERROU ou CONCLUÍDO.
“Mostre-me o resultado da célula SQL de inscrições mensais.”
Ela localiza a célula no projeto e lê sua saída mais recente.

O que a sua IA pode fazer

Projetos e execuções

Liste, crie e exporte projetos, execute a versão publicada com valores de entrada, acompanhe o status da execução e cancele uma execução.

Células e saídas

Leia células, resultados SQL e imagens de gráficos, e adicione ou altere células SQL, código e markdown.

IA do Hex e workspace

Faça perguntas à IA do Hex e sequências de perguntas, e pesquise coleções, usuários, grupos e conexões de dados.

“Envie-me o gráfico de receita como uma imagem.”
Ela busca a célula do gráfico como uma imagem, com largura e altura que você escolher se desejar.
“Adicione uma célula SQL ao projeto Marketing que conte pedidos por semana.”
Ela anexa uma célula SQL com o query ao projeto. Você também pode anexar uma conexão de dados a ela.
“Pergunte ao Hex quais clientes tiveram a maior queda de uso no último mês.”
Ela inicia um thread da IA do Hex com a pergunta e lê a resposta do Hex do thread quando estiver pronto.

58 ferramentas para Hex

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

archive_userVisível para outras pessoasDesativar um usuário (id de usuário). Tem efeitos visíveis fora deste sistema. Resumo da API: DeactivateUser.
ask_followupAltera dadosFazer uma pergunta de acompanhamento (`prompt`) em um thread existente do Hex AI por `thread_id`.
ask_questionAltera dadosIniciar um novo thread do Hex AI com uma pergunta de dados em `prompt`, opcionalmente contra um existente `project_id` ou referenciando tabelas, projetos ou uma conexão de dados em `attachments`. O Hex responde assincronamente; leia a resposta com list_thread_messages.
cancel_runElimina dadosParar uma execução de projeto em andamento: passe o projeto como `project_id` e o ID da execução como `project_id_2`.
create_batchVisível para outras pessoasCriar um novo lote. Obrigatório: ids de projetos. Tem efeitos visíveis fora deste sistema. Resumo da API: BatchUpdateComputeProfile.
create_categoryAltera dadosCriar uma nova categoria. Obrigatório: nome.
create_cellAltera dadosAdicionar uma célula a um projeto (`project_id`): `cell_type` SQL, CÓDIGO ou MARKDOWN, com `contents` contendo a fonte correspondente de sqlCell, codeCell ou markdownCell. Anexada ao final a menos que `location` seja fornecido.
create_data_connectionAltera dadosCriar uma nova conexão de dados. Obrigatório: detalhes da conexão, tipo ou nome.
create_groupAltera dadosCriar um novo grupo. Obrigatório: nome.
create_projectAltera dadosCriar um novo projeto vazio com um `title` e descrição opcional.
create_project_ingest_semantic_projectAltera dadosCriar um novo projeto para um projeto.
create_suggestion_reviewAltera dadosCriar uma nova revisão para uma sugestão. Resumo da API: TriggerSuggestionReview.
delete_cellElimina dadosExcluir permanentemente uma célula pelo id da célula. Ação destrutiva; pode exigir aprovação. Resumo da API: DeleteCell.
delete_draftElimina dadosExcluir permanentemente um rascunho pelo id de arquivo do guia org. Ação destrutiva; pode exigir aprovação.
delete_groupElimina dadosApague permanentemente um grupo pelo seu id de grupo. Ação destrutiva; pode exigir aprovação.
export_projectAltera dadosExportar um projeto por `project_id`, seja o rascunho atual ou a versão mais recente publicada (`version`).
get_cellObter uma célula pelo `cell_id`, com o tipo e a fonte.
get_cell_outputObter o resultado mais recente de saída de uma célula SQL pelo `cell_id`.
get_chart_imageObter uma célula de gráfico como imagem pelo `cell_id`, opcionalmente em largura e altura específicas em pixels.
get_collectionObter uma coleção pelo seu ID (`category_id`).
get_current_userObter o utilizador Hex ao qual esta conexão está assinada, com nome, e-mail e função.
get_data_connectionObter uma conexão de dados pelo seu ID. Resumo da API: GetDataConnection.
get_groupObter um grupo por ID de grupo.
get_projectObter um projeto pelo `project_id`, com título, descrição, proprietário, estado e informações de publicação.
get_run_statusObter o estado de uma execução de projeto: passe o projeto como `project_id` e o ID da execução como `project_id_2`.
get_suggestionObter uma sugestão pelo seu ID. Resumo da API: GetSuggestion.
get_threadObter um fio do Hex AI pelo `thread_id`, com o seu estado.
list_cell_images_get_chart_image_from_runListar imagens para uma célula. Filtros opcionais: largura, altura ou incluir título. Resumo da API: GetChartImageFromRun.
list_cellsListar as células (SQL, código, markdown, gráficos) em um projeto pelo `project_id`.
list_collectionsListar as coleções nas quais os projetos estão organizados.
list_data_connectionsListar as conexões de dados (armazéns e bancos de dados) disponíveis no espaço de trabalho.
list_groupsListar grupos de utilizadores no espaço de trabalho.
list_listsListar listas. Filtros opcionais: antes ou fonte externa. Os resultados são paginados. Resumo da API: ListDraftGuides.
list_project_queried_tablesListar tabelas consultadas para um projeto. Filtros opcionais: antes. Os resultados são paginados.
list_project_runsListar execuções passadas e atuais de um projeto pelo `project_id`, opcionalmente filtradas por estado (por exemplo, EXECUTANDO, ERROADO, CONCLUÍDO).
list_projectsListar projetos no espaço de trabalho, opcionalmente filtrados por e-mail do proprietário, estado ou categoria e ordenados por data de criação, edição ou publicação.
list_suggestionsListar sugestões. Filtros opcionais: antes, ordenação por, direção da ordenação ou estado. Os resultados são paginados. Resumo da API: ListSuggestions.
list_thread_messagesListar as mensagens (perguntas e respostas do Hex) em um fio pelo `thread_id`.
list_threadsListar fios do Hex AI (perguntas feitas ao agente do Hex), opcionalmente filtrados por utilizador, fonte, tipo ou últimos dias.
list_topicsListar tópicos. Filtros opcionais: antes. Os resultados são paginados. Resumo da API: ListTopics.
list_usersListar utilizadores no espaço de trabalho, opcionalmente filtrados por grupo ou IDs de utilizador.
run_projectAltera dadosExecutar a versão mais recente publicada de um projeto por `project_id`, opcionalmente com valores `input_params` ou uma visualização salva. Retorna um ID de execução para verificar com get_run_status; use `dry_run` apenas para validar.
set_project_statusAltera dadosDefinir a etiqueta `status` do projeto por `project_id`, ou passar null para removê-la.
submit_guideVisível para outras pessoasPublicar um guia. Tem efeitos visíveis fora deste sistema.
update_categoriesVisível para outras pessoasAtualizar uma categoria existente identificada pelo ID do projeto. Apenas os campos que passa são alterados. Tem efeitos visíveis fora deste sistema.
update_categoryAltera dadosAtualizar uma categoria existente identificada pelo ID da categoria. Apenas os campos que passarão serão alterados.
update_cellAltera dadosAlterar a fonte de uma célula pelo `cell_id` via `contents` (sqlCell, codeCell ou markdownCell), ou anexar uma conexão de dados a uma célula SQL.
update_create_presigned_urlAltera dadosAtualizar um URL presignado de criação existente identificado pelo ID do projeto.
update_data_connectionAltera dadosAtualizar uma conexão de dados existente identificada pelo ID da conexão de dados. Apenas os campos que você passar são alterados.
update_data_connection_schemasVisível para outras pessoasAtualizar um esquema existente identificado pelo ID da conexão de dados. Apenas os campos que você passar são alterados. Os efeitos são visíveis fora deste sistema.
update_draftsVisível para outras pessoasAtualizar um rascunho existente. Os efeitos são visíveis fora deste sistema.
update_groupAltera dadosAtualizar um grupo existente identificado pelo ID do grupo. Apenas os campos que você passar são alterados.
update_groupsVisível para outras pessoasAtualizar um grupo existente identificado pelo ID do projeto. Apenas os campos que você passar são alterados. Os efeitos são visíveis fora deste sistema. Resumo da API: EditProjectSharingGroups.
update_projectAltera dadosAtualizar um projeto existente identificado pelo ID de projeto semântico. Apenas os campos que você passar são alterados.
update_suggestionAltera dadosAtualizar uma sugestão existente identificada pelo ID da sugestão. Resumo da API: UpdateSuggestion.
update_suggestion_changeAltera dadosAtualizar uma alteração existente identificada pelo ID da alteração. Resumo da API: UpdateSuggestionChange.
update_usersVisível para outras pessoasAtualizar um usuário existente identificado pelo ID do projeto. Apenas os campos que você passar são alterados. Os efeitos são visíveis fora deste sistema. Resumo da API: EditProjectSharingUsers.
update_workspace_and_publicsVisível para outras pessoasAtualizar um workspace e público existentes identificados pelo ID do projeto. Apenas os campos que você passar são alterados. Os efeitos são visíveis fora deste sistema. Resumo da API: EditProjectSharingOrgAndPublic.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Hex na lista de aplicações.
2
Cole a sua chave
Cole um token da API do Hex. No Hex, abra Configurações de Usuário > Chaves de API, clique em Novo Token (precisa do papel Editor ou superior), defina uma descrição e expiração e copie o token (começa com hxtp_). Administradores de workspace podem criar um token de workspace (hxtw_) com escopos sob configurações de workspace.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Hex?

A IA pode listar, ler e exportar projetos, executá-los e acompanhar ou cancelar execuções, ler células, saídas SQL e imagens de gráficos, e pesquisar coleções, usuários, grupos e conexões de dados. Ela pode criar projetos, adicionar e alterar células, definir o status de um projeto e fazer perguntas à IA do Hex.

A IA vê meu token da API do Hex?

Não. Seu token da API do Hex está criptografado em repouso e nunca é mostrado para a IA. Após você salvá-lo, ele não é mostrado novamente, nem mesmo para você. A IA só vê os resultados das ferramentas que ela chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, para começar apenas lendo projetos e resultados. Executar um projeto consulta suas conexões de dados e cancelar uma execução o interrompe, então ambos podem exigir sua aprovação antes de rodar. Toda chamada de ferramenta é registrada.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem necessidade de cartão de crédito. Planos pagos cobram por tarefa concluída. Você também precisa de seu próprio workspace do Hex.

Devo usar um token pessoal ou de workspace?

Ambos funcionam. Um token pessoal (hxtp_) age como você, e você precisa da função Editor ou superior para criá-lo. Um administrador de workspace pode criar um token de workspace (hxtw_) e escolher seus escopos, o que limita o que a conexão pode acessar no Hex.