Conexão

Conectar o Claude Code

Um comando declara o servidor e o /mcp faz seu login pelo navegador, como no Claude. Para a máquina que não tem navegador, existe uma chave estática.

OAuth 2.1Chave estática para CISomente leituraGrátis

Passo a passo

Quatro minutos do início ao fim

  1. No painel, abra as configurações da sua loja, depois Conectores, e copie a URL do bloco Acesso LLM externo. O ID que aparece nela é o ID da loja, e não o slug da URL do seu painel.

  2. Rode o comando abaixo. Para compartilhar o servidor com a equipe, versione o .mcp.json que aparece logo depois: ele contém a URL e nenhum segredo.

  3. No Claude Code, rode /mcp, escolha boostecom e faça a autenticação. O navegador abre na tela de consentimento da BoostEcom: aprove os escopos que você quer dar a este cliente.

  4. Pergunte pela loja: o getStoreContext devolve plano, moeda, mercados, idiomas, temas e os escopos liberados, tudo numa só chamada.

O que colar

Troque <STORE_ID> pelo ID da sua loja. O painel mostra a mesma URL já preenchida, ao lado da chave.

Claude Codebash

OAuth 2.1

claude mcp add --transport http boostecom https://www.boostecom.app/api/mcp/v1/<STORE_ID>

# Then, in Claude Code: /mcp, pick boostecom, authenticate.

# Or commit it with the project, in .mcp.json. Only the URL is
# committed: each developer signs in with their own account.
# {
#   "mcpServers": {
#     "boostecom": { "type": "http", "url": "https://www.boostecom.app/api/mcp/v1/<STORE_ID>" }
#   }
# }

# Headless (CI, no browser): a static key, read from the environment.
# claude mcp add --transport http boostecom https://www.boostecom.app/api/mcp/v1/<STORE_ID> \
#   --header "Authorization: Bearer ${BOOSTECOM_MCP_KEY}"
Armadilhas

Onde costuma dar errado

  • Cada desenvolvedor entra com a própria conta BoostEcom, então quem sai da organização perde o acesso na chamada seguinte, sem nenhuma chave para trocar.
  • Uma chave estática nunca passou por uma tela de consentimento, então ela abre o relay e mais nada: as 15 ferramentas Shopify somente leitura, dentro do que você concedeu ao app BoostEcom. As ferramentas de documentação, o Studio e a ficha de inteligência da sua loja exigem o login via OAuth. Use uma chave para CI e execuções sem navegador, lida de uma variável de ambiente e nunca escrita num arquivo versionado.
  • Se uma ferramenta que você esperava não aparece, ela foi barrada por uma de duas portas: os escopos que você aprovou ou o que você concedeu ao app BoostEcom. Chame a ferramenta mesmo assim e a recusa diz qual das duas foi.

A documentação oficial do Claude Code

Outros clientes

E depois

Mais 3 clientes, testados de ponta a ponta

A referência completa: ferramentas, escopos, descoberta

Pergunte ao @Atlas sobre a loja que você conectou

A mesma loja que o Claude Code lê está aqui, a uma pergunta de distância. Pergunte do seu jeito.