Conecte o HubSpot ao Claude com o MCP.

HubSpotPlano gratuitoFluxos de consultaClaude

Pergunte ao Claude sobre sua conta do HubSpot em inglês simples: o Agent já dentro da sua rede executa o SQL em modo somente leitura, e seu cliente de IA nunca armazena seus dados de login. Leva cerca de dez minutos, e o plano Free cobre isso.

Comece gratuitamente

O resultado final será o que você obterá.

Um Claude que pode responder a perguntas sobre sua conta do HubSpot com consultas SQL em tempo real e somente leitura, explicar o significado das colunas e dar seguimento quando você solicitar mais informações — sem nunca precisar acessar o banco de dados e sem alterar o firewall: o Agente, já presente em sua rede, executa o SQL e envia apenas as linhas de volta. Depois que o Agente estiver instalado, conectar o Claude leva cerca de 90 segundos, caso você se sinta confortável com a tela de configurações. Assim:

Claude ChatGPT Cursor Código Claude VS Code Windsurf Gemini CLI JetBrains Códice+5 maisSomente leitura

O que há em hubspot.promoções Na minha conta do HubSpot? Mostre-me algumas linhas e explique o que cada coluna significa.

qs_get_table_schema qs_executar_consulta inteligência_de_esquema

Primeiro, examinei a estrutura da tabela e, em seguida, executei uma consulta somente leitura por meio do seu agente. Aqui estão três das linhas de hubspot.deals:

nome do acordo	estágio de negócios	quantia
1042	Comerciantes do Northwind	Seattle
1057	Equipamentos Alpinos	Denver
1063	Alimentos do Porto	Halifax

nome do acordo identifica a linha. estágio de negócios e quantia estão descritos no seu modelo de Inteligência Semântica, então posso filtrá-los por nome.

Quais três quantia Quais empresas geraram a maior receita neste trimestre? Como isso se compara ao trimestre anterior? Há algo que eu deva investigar?

qs_get_relacionamentos qs_executar_consulta qs_executar_consulta

Eu entrei hubspot.promoções para pedidos Com base na relação encontrada pela Inteligência Semântica, foi realizada uma agregação para cada trimestre. Ambas as consultas eram somente leitura e retornaram 3 linhas cada:

quantia	Este trimestre	Último trimestre	Mudar
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver A história é a seguinte: a receita aumentou 38% com praticamente o mesmo número de clientes, portanto o valor médio do pedido também aumentou. Halifax Caiu 26%, e essa queda se deve a dois clientes que faziam pedidos todos os meses no trimestre passado e não fizeram nenhum neste trimestre — vale a pena ligar antes do fim do mês. Em Seattle está estável. Quer os nomes das duas contas de Halifax?

Somente SELECIONAR, verificado pelo Agente Acessei a guia Atividade do MCP. 9 linhas retornadas em 3 consultas Mesma conexão em 14 clientes MCP

Prefere não instalar um cliente de IA? No plano de negócios, Nova é o assistente integrado ao próprio Query Streams. Ele usa o mesmo conjunto de ferramentas do Agent que seu cliente de IA obtém aqui, além de recursos que um cliente externo não oferece: ele elabora e valida o SQL com base no seu modelo de Inteligência Semântica, transforma a resposta em um gráfico e salva o resultado como uma consulta que sua equipe pode executar no Excel, Planilhas Google ou na API REST — sem chave, sem conector, sem necessidade de instalação. Use o MCP quando sua equipe já utiliza o Claude, o Cursor ou o ChatGPT; use o Nova quando desejar as respostas dentro do Portal.

O HubSpot armazena seus dados por trás de sua API. O Claude, por outro lado, reside em um navegador ou terminal e não sabe nada sobre isso. A solução usual é colar um esquema no chat e torcer para que funcione, ou fornecer sua senha do HubSpot para um servidor MCP de código aberto. O Query Streams funciona de forma diferente: o Agente que já está associado à sua conta do HubSpot executa o SQL que o Claude escreve, em modo somente leitura, e o servidor MCP verifica, entre as consultas, quem está fazendo a solicitação, o que pode ser feito e com que frequência. O Claude obtém as respostas. Ele nunca obtém as credenciais.

O que você vai precisar

Uma conta do Query Streams

O MCP está disponível em todos os planos, inclusive no plano gratuito. O plano gratuito permite uma chave ou um aplicativo conectado, que é tudo o que este guia precisa. Cadastre-se em my.querystreams.com.

O HubSpot foi conectado através do Agente.

O agente é instalado em qualquer computador que esteja sempre ligado, com a conexão do HubSpot adicionada em Agentes de Dados. Ainda não terminou? Conecte-se primeiro ao HubSpotLeva cerca de dez minutos.

MCP ativado para você

Criadores, proprietários e administradores têm acesso desde o início. Todos os outros precisam de um administrador para ativar o recurso. MCP alterne ao lado do nome deles abaixo Conta → Controle de acessoAté então, a página do MCP exibe a mensagem "O MCP está desativado para sua conta".

Um cliente de IA

Aplicativos de bate-papo como claude.ai, Claude Desktop e ChatGPT se conectam sem chave. Claude Code, Cursor, VS Code e cerca de outras dez ferramentas usam uma chave; o Portal... Conecte um cliente de IA O guia configura cada um deles.

Configure em quatro etapas

1. Abra o MCP no portal.

   Faça login em my.querystreams.com e aberto Transmissões → Ao vivo → MCPA página possui quatro abas: Conexões, Contexto, Ferramentas e, para administradores, AtividadeVerifique o painel de Inteligência Semântica em Conexões Enquanto estiver aqui: ele lista seu conector do HubSpot e se a Inteligência Semântica foi executada nele. A cobertura completa é o que permite que Claude escreva SQL correto para o HubSpot na primeira tentativa.

   MCP aberto

   Está vendo a mensagem “O MCP está desativado para sua conta”? Sua organização possui MCP, mas seu usuário está desativado. Um administrador o ativa com o MCP alterne ao lado do seu nome abaixo. Conta → Controle de acessoCriadores, proprietários e administradores estão presentes desde o início.

2. Escolha como você se conectará.

   Existem duas entradas, e ambas terminam no mesmo lugar:

   Aplicativos de bate-papo · sem chave

   claude.ai, Claude Desktop, ChatGPT

   No claude.ai e no Claude Desktop, abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em Conectar e aprovar. Adicionando por URL, https://mcp.querystreams.com/mcp, é a alternativa. No ChatGPT, você adiciona Fluxos de Consulta a partir do aplicativo (modo desenvolvedor por enquanto) e faz login com Fluxos de Consulta. De qualquer forma, uma página de Fluxos de Consulta será aberta: selecione a organização e as permissões e clique em Aprovar conexãoNada para copiar. A conexão aparece no Conexões aba e pode ser revogada lá.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   Na página MCP, clique Conecte um cliente de IAO guia pergunta Como seu cliente de IA se conectará?: escolher Use uma chave em um arquivo de configuração, escolha sua ferramenta, então Gere uma chave para isso: um Nome da chave, Ler e Executar consultas marcado, um Validade (Nunca, 30 dias, 90 dias ou 1 ano). Configure-o Mostra o trecho com a chave preenchida, e Verifique a conexão Aguarda a primeira chamada.

   Ambas as formas utilizam as mesmas três permissões, que você escolhe na tela de consentimento ou na chave:

   Ler

   Liste conectores, navegue por tabelas e colunas, leia suas consultas salvas e regras de alerta. Nunca retorna dados de linha.

   Executar consultas

   Execute consultas SQL somente leitura e consultas salvas por meio do seu Agente e retorne as linhas. Sem isso, seu cliente de IA pode descrever seus dados, mas não responder com base neles.

   Analisar

   Tabelas de perfil, descoberta de relacionamentos e agendamento de uma execução de Inteligência Semântica. Isso consome créditos de IA e dados do Nova, portanto, a tela de consentimento nunca é marcada previamente.

   Perdeu a chave? Está listado no Conexões guia: Revelar a chave completa mostra isso novamente e Copiar chave completa copia-o. Revogue-o lá se um laptop desaparecer; todos os clientes que o utilizam falham na próxima chamada, em cerca de cinco minutos.

3. Conecte-se com Claude

   Escolha a receita do Claude que você usa. O endereço do servidor é o mesmo em todos os lugares: https://mcp.querystreams.com/mcp.

   Claude na web, Claude para desktop e dispositivos móveis. sem chave

   1. Abra o Listagem de fluxos de consulta No Diretório de Conectores da Anthropic, clique em ConectarNa área de trabalho, ele fica localizado em + → Conectores.
   2. Alternativa, caso sua organização oculte conectores de diretório: Configurações → Conectores → Adicionar conector personalizado, nome Fluxos de consulta, URL https://mcp.querystreams.com/mcp, Campos OAuth vazios, Adicionar; então em um bate-papo + → Fluxos de consulta → Conectar.
   3. Uma aba "Fluxos de Consulta" será aberta. Faça login, se solicitado, selecione a organização e revise. Ler e Executar consultas, opcionalmente Limitar a conectores específicose clique Aprovar conexão.
   4. De volta ao Claude, você vê “Conectado aos Fluxos de Consulta”. Na primeira vez que o Claude usa uma ferramenta, ele pergunta: escolha Permitir sempre.

   Se você adicionar manualmente no Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado opção, que espera um repositório git. Os conectores sincronizam com sua conta Claude, então os aplicativos móveis e o Desktop os reconhecem automaticamente. Os nomes dos menus são da Anthropic e podem ser alterados.

   Código Claude chave

   Um único comando, com a sua chave da aba Conexões:

   terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_COLE_SUA_CHAVE_AQUI"

   Isso descreve o projeto atual. .mcp.json. Adicionar --escopo usuário Para ter fluxos de consulta em todos os projetos. Execute /mcp dentro do Código Claude para ver se está conectado.

   Cursor chave

   Aberto Configurações do cursor → MCP → Adicionar novo servidor MCPou editar .cursor/mcp.json na raiz do seu espaço de trabalho:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_COLE_SUA_CHAVE_AQUI" } } } }

   Reinicie o Cursor ou execute MCP: Reiniciar servidores; um fluxos de consulta O ícone aparece na barra de status do MCP.

   Usar outra coisa? O Portal Conecte um cliente de IA guia Possui receitas prontas para colar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, além de um Colar e mesclar ferramenta que solta o fluxos de consulta entrada em um arquivo de configuração que você já possui. Qualquer cliente que se comunique via MCP sobre HTTP funciona: servidor https://mcp.querystreams.com/mcp, cabeçalho Chave X-MCP (um Autorização: Portador O cabeçalho com a mesma chave também funciona).

4. Faça sua primeira pergunta

   Comece com algo cuja resposta você já saiba, para que possa ver Claude escolher a ferramenta certa. Três opções que funcionam bem com sua conta HubSpot:

   “Quais dados tenho na minha conta do HubSpot?”

   Claude lista as tabelas que consegue visualizar, informa quais possuem Inteligência Semântica e pergunta o que você deseja analisar.

   “Mostre-me dez linhas de hubspot.deals e explique cada coluna.”

   Claude primeiro lê a estrutura da tabela (Ler), depois executa um SELECT através do seu Agente (Executar consultas) e descreve o que significam "dealstage" e "amount".

   Quantas linhas o hubspot.deals tem por valor? Qual valor tem mais linhas?

   Claude escreve o GROUP BY no dialeto do HubSpot, executa-o e responde em uma frase com uma pequena tabela. Continue a conversa no mesmo chat; isso mantém o contexto.

   Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectors, o guia do Portal Verifique a conexão passo diz Conectadoe a chave ou aplicativo no Conexões A aba mostra o seu Último uso tempo em questão de segundos.

O que Claude pode fazer quando estiver conectado

Seu cliente de IA visualiza as ferramentas de Fluxos de Consulta e seleciona a mais adequada para sua pergunta. O Portal Ferramentas guia lista todas as ferramentas e modos incluídos no seu plano. Query Streams solicita que seu cliente de IA leia as colunas de cada tabela antes de consultá-la, para que use os nomes reais em vez de adivinhar. Em todos os planos, incluindo o Free:

O conjunto de ferramentas analíticas. Nos planos pagos, o Agente realiza o trabalho básico onde sua conta do HubSpot está hospedada, permitindo que seu cliente de IA concentre sua atenção no raciocínio. A versão gratuita funciona como sempre funcionou.

Os valores padrão estão em Contexto guia: limite de células de texto, visualização do esquema, tamanho do resultado, padrões de análise e resultados retidos.

Por que a Inteligência Semântica é importante aqui?

Cada resposta que Claude recebe é etiquetada com a origem da estrutura, e Claude ajusta o grau de confiança que deposita no que vê.

Se um banco de dados for importante, execute a Inteligência Semântica nele uma vez a partir de Nova → Inteligência. O Conexões A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência Semântica.

O que os planos permitem

O MCP está incluído em todos os planos, inclusive no gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas por minuto seu cliente de IA pode fazer:

Um aplicativo conectado conta como uma chave. Além do limite por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta é executada por até 60 segundos, a menos que seu cliente de IA solicite mais tempo, que pode chegar a cinco minutos. Seu plano também define quantas linhas uma consulta retorna e, com o conjunto de ferramentas Analíticas, por quanto tempo e qual o tamanho máximo que um resultado pode ser armazenado. o guia completo do MCP lista todos os planos. O que seu cliente de IA recebe é contabilizado na sua franquia do Data Realm, o mesmo limite usado pelas consultas do Excel e do Sheets: o uso do AI-agent (MCP) contabiliza cada byte entregue ao seu cliente de IA, incluindo resultados, leituras de esquema e páginas de resultados mantidos, antes de qualquer compactação de transporte negociada pelo seu cliente; já as consultas de planilhas contabilizam o resultado compactado entregue pelo seu Network Agent. As execuções do Semantic Intelligence iniciadas pelo seu cliente de IA consomem créditos Nova AI, exatamente como as iniciadas pelo Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Boas próximas jogadas

• Salve as consultas que você considera canônicas. No Construtor de Consultas, Claude prioriza as consultas salvas, portanto, "clientes ativos" significa o que sua equipe define.
• Use um projeto Claude Com o recurso Query Streams integrado, você pode inserir suas regras personalizadas nas instruções: qual banco de dados do HubSpot usar por padrão e quais consultas salvas são as definições oficiais.
• Conceda a função de Analisar quando desejar respostas mais aprofundadas. Analisar o perfil de uma coluna antes de filtrá-la é a diferença entre adivinhar um código de status e usar o correto. Isso consome créditos de IA da Nova, portanto, ficará desativado até que você o desative.
• Peça um gráfico. O claude.ai gera gráficos a partir das linhas que Claude recebe de volta.

Quando algo não funciona

Perguntas que as pessoas fazem

Guias relacionados

• Conecte o Stripe ao Claude com o MCP.
• Conecte o Shopify ao Claude com o MCP.
• Conecte o Google Analytics 4 ao Claude com o MCP.
• Conecte o Google Search Console ao Claude com o MCP.
• Conectar fluxos de consulta ao Claude via MCP: configuração, permissões e solução de problemas
• Como conectar o HubSpot ao Google Sheets
• Todos os guias MCP