LaunchMyStore

Execute uma loja online LaunchMyStore a partir de qualquer assistente de IA: produtos, pedidos, clientes, cupons, análises, temas, envio e planos. Mais de 190 ferramentas com login via OAuth ou token.

Ver em launchmystore.io

Servidor MCP hospedado

npx add-mcp 'https://api.launchmystore.io/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP

Use assistentes de IA para gerenciar sua loja LaunchMyStore via Model Context Protocol

Integração Model Context Protocol (MCP)

A LaunchMyStore inclui um servidor MCP integrado para que assistentes de IA — Claude Desktop, Claude Code, Cursor, OpenAI Codex e qualquer outro cliente compatível com MCP — possam operar sua loja por meio de linguagem natural.

O servidor suporta ambos os transportes MCP no mesmo hostname:

HTTP+SSE legado (especificação MCP 2024-11-05) em /mcp/sse — Claude Desktop, Claude Code, Cursor.
HTTP Streamable (especificação MCP 2025-03-26) em /mcp — OpenAI Codex e outros clientes mais novos baseados em SDK.

Escolha o transporte que corresponde ao seu cliente; ambos expõem exatamente as mesmas ferramentas, recursos e autenticação.

Nota

Usando Claude na web ou no celular (claude.ai)? Conectores personalizados autenticam com OAuth em vez de um token colado — veja Claude.ai Custom Connector.

Nota

Nova AI e MCP compartilham as mesmas ferramentas. Ambas as interfaces usam as mesmas definições de ferramentas, então qualquer capacidade disponível no Nova AI também está disponível via MCP. Este documento cobre a configuração do MCP — para detalhes das ferramentas, veja Nova AI Tools.

O que é MCP?

O Model Context Protocol é um padrão aberto que permite que assistentes de IA chamem ferramentas externas e leiam recursos externos. Com o MCP conectado à sua loja, você pode:

Pedir à IA para atualizar preços de produtos ou inventário
Criar e gerenciar códigos de desconto por meio de conversa
Obter análises de vendas e painéis
Gerenciar pedidos e entregas
Atualizar configurações da loja, conteúdo e temas

Início Rápido

1. Gere um token MCP

Abra o admin da sua LaunchMyStore.
Navegue até Configurações → AI Connector (MCP).
Clique em Gerar token.
Copie o token exibido — é uma string opaca longa válida por 1 ano.

Aviso

Trate o token MCP como uma senha. Qualquer pessoa com ele pode chamar o servidor MCP como você. Nunca cole em repositório público, captura de tela ou chat.

Para revogar um token, altere a senha da sua conta — todo token MCP emitido antes da alteração de senha para de funcionar imediatamente. Ainda não expomos revogação por token; isso está no roadmap.

2. Adicione o servidor ao seu cliente MCP

Escolha o trecho que corresponde ao seu cliente. A página de admin (Configurações → AI Connector (MCP)) gera cada um já preenchido com seu token — clique no botão Copiar na aba relevante.

Claude Desktop / Claude Code / Cursor (SSE)

Claude Desktop, Claude Code e Cursor usam o transporte SSE legado, então todos compartilham o mesmo trecho JSON apontando para /mcp/sse:

{
  "mcpServers": {
    "launchmystore": {
      "type": "sse",
      "url": "https://api.launchmystore.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Claude Desktop — edite claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cole o trecho, salve e reinicie o Claude Desktop.

Claude Code — crie um .mcp.json na raiz do seu projeto (ou adicione a ~/.claude.json para escopo do usuário), cole o trecho e execute /mcp dentro do Claude Code para confirmar a conexão.

Cursor — abra as configurações do Cursor (Cmd+, / Ctrl+,), procure por MCP e cole o trecho na configuração de servidores MCP.

OpenAI Codex (HTTP Streamable)

O Codex fala o transporte HTTP Streamable mais novo, então ele aponta para /mcp (não /mcp/sse) e usa TOML em vez de JSON. O token é carregado de uma variável de ambiente em vez de embutido.

Edite ~/.codex/config.toml e adicione:

[mcp_servers.launchmystore]
url = "https://api.launchmystore.io/mcp"
bearer_token_env_var = "LAUNCHMYSTORE_MCP_TOKEN"
startup_timeout_sec = 30

Exporte o token no shell onde você inicia o Codex:

export LAUNCHMYSTORE_MCP_TOKEN="YOUR_MCP_TOKEN"

Reinicie o Codex.

Aviso

Não aponte o Codex para /mcp/sse — esse é o handshake SSE legado de dois endpoints e o Codex falhará com Deserialize error: data did not match any variant of untagged enum JsonRpcMessage. O Codex deve usar /mcp.

3. Experimente alguns comandos

"Mostre meus produtos mais vendidos neste mês"
"Crie um código de desconto de 20% para novos clientes"
"Atualize o preço de 'Camiseta Clássica' para $29,99"
"Quais pedidos precisam de entrega hoje?"

Ferramentas Disponíveis

O servidor MCP expõe as mesmas ferramentas do Nova AI, organizadas por categoria:

Listar, criar, atualizar e excluir produtos e variantes Visualizar pedidos, criar pedidos manuais, atualizar status, reembolsos Organizar produtos com categorias Visualizar e gerenciar dados de clientes Relatórios de vendas, dados de tráfego, análises de produtos Criar e gerenciar códigos de desconto Gerenciamento de conteúdo para blogs e páginas personalizadas Configurações de tema, seções e blocos Gerenciamento de menu de navegação Envio, checkout e configuração da loja

Para uma lista completa de ferramentas com parâmetros, veja a Referência de Ferramentas.

Endpoints

Método	Caminho	Finalidade
`GET`	`/mcp/info`	Descoberta pública. Retorna informações do servidor, capacidades e o mapa de endpoints.
`POST`	`/mcp/token`	Emite um token MCP de 1 ano para o comerciante autenticado.
`GET`	`/mcp/config`	Retorna um trecho de configuração pronto para colar (`?client=claude\|claudeCode\|cursor\|codex`). Se nenhuma consulta `token` for fornecida, emite um novo.
`GET`	`/mcp/sse`	Transporte SSE legado. Abre o fluxo de eventos MCP. O primeiro evento entregue é `endpoint`, cujos dados são a URL de mensagens para a qual o cliente deve fazer POST.
`POST`	`/mcp/sse/message?sessionId=…`	Transporte SSE legado. Envia uma solicitação JSON-RPC vinculada a uma sessão SSE aberta. Retorna 202 Accepted; a resposta é enviada de volta pelo fluxo SSE como um `event: message`.
`POST`	`/mcp`	Transporte HTTP Streamable. JSON-RPC sobre HTTP. Solicitações retornam 200 com `application/json`. Notificações retornam 202 Accepted sem corpo. Suporta arrays em lote.
`GET`	`/mcp`	Transporte HTTP Streamable. Usado por clientes que querem um fluxo iniciado pelo servidor. A LaunchMyStore é stateless e não envia nada, então isso retorna 405 (permitido pela especificação).
`DELETE`	`/mcp`	Transporte HTTP Streamable. Gancho de encerramento de sessão. A LaunchMyStore não emite `Mcp-Session-Id`, então isso é um no-op que sempre retorna 200.
`GET`	`/mcp/tools`	Lista todas as ferramentas que a IA pode chamar.
`GET`	`/mcp/resources`	Lista recursos somente leitura.
`GET`	`/mcp/docs`	Retorna o catálogo completo de ferramentas como markdown.

Verificando o servidor

curl https://api.launchmystore.io/mcp/info

Resposta:

{
  "name": "launchmystore-mcp",
  "version": "1.0.0",
  "protocolVersion": "2025-03-26",
  "serverUrl": "https://api.launchmystore.io",
  "capabilities": {
    "tools": { "listChanged": false },
    "resources": { "subscribe": false, "listChanged": false },
    "prompts": { "listChanged": false },
    "logging": {}
  },
  "endpoints": {
    "jsonrpc": "/mcp",
    "sse": "/mcp/sse",
    "token": "/mcp/token",
    "config": "/mcp/config"
  },
  "documentation": "https://docs.launchmystore.io/mcp/overview"
}

Detalhes do transporte

HTTP+SSE legado (Claude Desktop, Claude Code, Cursor)

O transporte SSE segue a especificação MCP 2024-11-05:

O cliente abre GET /mcp/sse com Authorization: Bearer ….
O servidor emite imediatamente event: endpoint\ndata: /mcp/sse/message?sessionId=<id>\n\n.
O cliente faz POST de cada solicitação JSON-RPC para essa URL de mensagens com o mesmo cabeçalho Bearer. Cada POST retorna 202 Accepted sem corpo.
O servidor envia a resposta JSON-RPC correspondente de volta pelo fluxo SSE original como event: message\ndata: <json>\n\n.
Heartbeats (: heartbeat <ts>) impedem que proxies encerrem a conexão por inatividade.

HTTP Streamable (OpenAI Codex)

O Codex (e qualquer outro cliente que implemente o transporte HTTP Streamable MCP 2025-03-26) fala com o único endpoint /mcp:

O cliente faz POST de solicitações JSON-RPC para /mcp com Authorization: Bearer …. Solicitações que têm um id recebem uma resposta 200 com Content-Type: application/json contendo a resposta JSON-RPC. Arrays em lote são suportados.
Notificações (mensagens JSON-RPC sem id, como notifications/initialized) recebem 202 Accepted sem corpo — de acordo com a especificação JSON-RPC 2.0, o servidor NÃO DEVE responder a uma notificação.
initialize negocia a versão do protocolo: o servidor ecoa a versão solicitada pelo cliente quando é uma de 2024-11-05, 2025-03-26 ou 2025-06-18, caso contrário, volta ao padrão.
GET /mcp retorna 405 (somos stateless e não enviamos mensagens iniciadas pelo servidor — explicitamente permitido pela especificação).
DELETE /mcp retorna 200 (não emitimos Mcp-Session-Id, então não há nada para liberar).

Você pode acessar qualquer um dos transportes com curl. Solicitação/resposta simples com o endpoint HTTP Streamable:

curl -X POST https://api.launchmystore.io/mcp \
  -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list",
    "params": {}
  }'

Segurança

Tokens são limitados a uma única conta de comerciante e herdam o papel e as permissões dessa conta.
Chamadas de ferramentas respeitam o mesmo modelo de autorização das APIs REST subjacentes — se um papel não pode excluir produtos no admin, a IA também não pode excluí-los.
Alterar a senha da conta invalida todos os tokens MCP emitidos de uma só vez.
Todas as chamadas de ferramentas MCP entram no seu log de auditoria com source: "mcp".

Solução de Problemas

Cliente mostra "Conectando…" para sempre (Claude Desktop / Claude Code / Cursor)

Certifique-se de que seu trecho inclui "type": "sse" e aponta para /mcp/sse (não /mcp). O endpoint /mcp do HTTP Streamable não abrirá um fluxo de eventos para esses clientes — eles esperam o handshake SSE legado de dois endpoints.

Codex: `Deserialize error: data did not match any variant of untagged enum JsonRpcMessage`

Você apontou o Codex para /mcp/sse. O handshake SSE legado envia um frame event: endpoint como primeira mensagem, que o parser HTTP Streamable do Codex não consegue interpretar. Altere url em ~/.codex/config.toml de https://api.launchmystore.io/mcp/sse para https://api.launchmystore.io/mcp.

Codex: `Transport channel closed, when send initialized notification`

Seu backend está em uma versão mais antiga que retorna uma resposta JSON-RPC para notificações. O endpoint /mcp agora retorna 202 Accepted sem corpo para qualquer payload sem id, que é o que o Codex espera. Se você está hospedando por conta própria, atualize para o backend mais recente.

"Não autorizado" / 401

Seu token é inválido ou expirou. Gere um novo em Configurações → AI Connector (MCP).

Ferramentas não aparecem

Confirme que a conexão está aberta no seu cliente (Claude Code: /mcp).
Tente curl https://api.launchmystore.io/mcp/info para verificar se o servidor está acessível.
Certifique-se de que seu papel tem acesso às ferramentas que você espera.

Permissão negada em uma ferramenta específica

O papel vinculado ao seu token MCP não tem permissão para essa operação. Use uma conta de admin ou conceda a permissão relevante.