Conecte o Shopify ao Claude com o MCP.

MCP · Shopify para Claude

Perguntar Claude sobre sua conta Shopify, em inglês simples

Connect claude.ai, Claude Desktop, ChatGPT, Cursor or any MCP client to Query Streams once. Your AI client asks; the Agent that already sits with your Shopify account, its partner inside your network, does the heavy lifting: it runs the SQL read-only, and on paid plans it also sizes, profiles and holds results so follow-ups need no second query. No database password ever reaches the AI. About ten minutes, and the Free plan covers it.

Cerca de 10 minutos Claude, ChatGPT, Cursor + 11 outros clientes As credenciais permanecem com você. Somente leitura, sempre

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

Um Claude que pode responder a perguntas sobre sua conta Shopify 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 shopify.orders Na minha conta Shopify? 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 da tabela shopify.orders:

nome	situação_financeira	preço_total
1042	Comerciantes do Northwind	Seattle
1057	Equipamentos Alpinos	Denver
1063	Alimentos do Porto	Halifax

nome identifica a linha. situação_financeira e preço_total estão descritos no seu modelo de Inteligência Semântica, então posso filtrá-los por nome.

Quais três preço_total 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 shopify.orders 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:

preço_total	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 is the assistant built into Query Streams itself. It uses the same Agent toolset your AI client gets here, plus what an outside client does not: it drafts and validates the SQL against your Semantic Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

A Shopify mantém seus dados protegidos por 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 da Shopify para um servidor MCP de código aberto. O Query Streams funciona de forma diferente: o Agente que já está associado à sua conta da Shopify 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.

A Shopify conectou-se através do Agente.

O agente é instalado em qualquer computador que esteja sempre ligado, com a conexão do Shopify adicionada em Agentes de Dados. Ainda não terminou? Conecte-se primeiro ao ShopifyLeva 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

Chat apps such as claude.ai, Claude Desktop and ChatGPT connect with no key. Claude Code, Cursor, VS Code and about ten other tools use a key; the Portal’s Connect an AI client guide sets up each one.

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, Context, Ferramentas e, para administradores, Atividade. Check the Semantic Intelligence panel on Conexões while you are here: it lists your Shopify connector and whether Semantic Intelligence has run on it. Complete coverage is what lets Claude write correct Shopify SQL on the first try.

   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

   In claude.ai and Claude Desktop, open the Query Streams listing in Anthropic’s Connectors Directory, click Conectar and approve. Adding it by URL, https://mcp.querystreams.com/mcp, is the fallback. In ChatGPT you add Query Streams from the app (developer mode for now) and sign in with Query Streams. Either way a Query Streams page opens: pick the organization and the permissions and click Aprovar conexão. Nothing to copy. The connection appears on the Conexões tab and can be revoked there.

   Ferramentas de desenvolvedor · uma chave

   Claude Code, Cursor, VS Code e amigos

   On the MCP page click Connect an AI client. The guide asks How will your AI client connect?: choose Use a key in a config file, pick your tool, then Generate a key for it: a Nome da chave, Ler e Run queries ticked, an Validade (Never, 30 days, 90 days or 1 year). Set it up shows the snippet with the key filled in, and Check the connection waits for the first call.

   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.

   Run queries

   Run read-only SQL and saved queries through your Agent and return the rows. Without it your AI client can describe your data but not answer from it.

   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? It is listed on the Conexões tab: Reveal full key shows it again and 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 Query Streams listing in Anthropic’s Connectors Directory and click Conectar. In Desktop it then sits under + → Conectores.
   2. Fallback, if your organization hides directory connectors: Settings → Connectors → Add custom connector, name Fluxos de consulta, URL https://mcp.querystreams.com/mcp, OAuth fields empty, Adicionar; then in a chat + → 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 Run queries, 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

   One command, with your key from the Connections tab:

   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? The Portal’s Connect an AI client guide 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 Shopify:

   “Quais dados tenho na minha conta Shopify?”

   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 da página shopify.orders e explique cada coluna.”

   Claude reads the table structure first (Read), then runs one SELECT through your Agent (Run queries) and describes what financial_status and total_price mean.

   “Quantas linhas existem em shopify.orders para cada total_price? Qual total_price tem o maior número de linhas?”

   Claude escreve o GROUP BY no dialeto do Shopify, 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, the Portal guide’s Check the connection step says Conectado, and the key or app on the Conexões tab shows its Último uso time within a few seconds.

O que Claude pode fazer quando estiver conectado

Your AI client sees the Query Streams tools; it picks the right one for your question. The Portal’s Ferramentas guia lists all 38 tools and modes with what your plan includes. On every plan, Free included:

The Analytic toolset. On paid plans the Agent does the groundwork where your Shopify account lives, so your AI client spends its attention on the thinking. Free works as it always has.

The defaults live on the Context guia: text cell limit, schema view, result size, analysis defaults and held results.

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

MCP is on every plan, including Free, with no separate fee. What each plan sets is how many keys or connected apps you can hold and how many calls a minute your AI client may make:

A connected app counts as a key. On top of the per-minute figure, any one key may run at most 10 queries a minute. A query runs for up to 60 seconds unless your AI client asks for more, up to five minutes. Your plan also sets how many rows one query returns and, with the Analytic toolset, how long and how large a held result may be; the full MCP guide lists every plan. The rows your AI client receives count against your Data Realm allowance, the same pool your Excel and Sheets queries use, and MCP is measured the same way as your spreadsheet queries. Semantic Intelligence runs started from Claude spend Nova AI credits, exactly as they do from the 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 Shopify 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 HubSpot 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 Shopify ao Google Sheets
• Todos os guias MCP