ShopSynch

Conecte assistentes de IA ao ShopSynch para que lojistas possam trabalhar com produtos, pedidos, clientes, inventário, pagamentos e análises da loja.

Ver em shopsynch.comExperimente este MCPPatrocinado

Documentação

Conector MCP

O ShopSynch expõe um servidor público de Model Context Protocol para assistentes de IA, construtores de agentes e ferramentas de desenvolvimento.

O conector permite que clientes de IA aprovados ajudem comerciantes a trabalhar com sua loja ShopSynch por meio de uma conexão segura baseada em permissões. Casos de uso típicos incluem insights da loja, fluxos de produtos, suporte a pedidos, contexto do cliente, verificações de inventário e relatórios operacionais.

Perfil Oficial do Conector

Use este perfil ao configurar um cliente MCP compatível ou ao preparar uma submissão de conector do ShopSynch.

{
  "name": "shopsynch",
  "displayName": "ShopSynch",
  "description": "Connect AI assistants to ShopSynch so merchants can work with products, orders, customers, inventory, payments, and store analytics.",
  "mcpUrl": "https://api.shopsynch.com/mcp",
  "transport": "streamable-http",
  "authentication": {
    "type": "oauth2",
    "authorizationServerMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-authorization-server",
    "protectedResourceMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-protected-resource",
    "pkce": true,
    "defaultScope": "mcp:store"
  },
  "privacyPolicyUrl": "https://www.shopsynch.com/privacy",
  "termsOfServiceUrl": "https://www.shopsynch.com/terms",
  "supportUrl": "https://www.shopsynch.com/contact"
}

Compatibilidade

O ShopSynch funciona com clientes MCP que suportam MCP remoto via Streamable HTTP.

Tipo de cliente	Status
Clientes MCP remotos com suporte a OAuth	Suportado
Conectores Claude Desktop ou Claude.ai	Suportado quando MCP remoto e OAuth estão habilitados no cliente
Cursor, Antigravity, VS Code e IDEs de agentes	Suportado quando o cliente aceita URLs de servidor MCP remoto
Aplicativo nativo ChatGPT	Requer um pacote de aplicativo ChatGPT e revisão do marketplace

A instalação nativa no marketplace é separada da compatibilidade com MCP. Um cliente pode suportar o servidor MCP do ShopSynch diretamente antes de aparecer como um aplicativo de marketplace instalável com um clique.

Autenticação

O ShopSynch MCP usa OAuth para aplicativos de IA de terceiros e fluxos oficiais de conectores.

Comerciantes fazem login no ShopSynch, revisam o acesso solicitado e aprovam a conexão antes que um cliente de IA possa acessar os dados da loja. O acesso via OAuth não ignora as permissões da conta ShopSynch, o escopo do locatário ou as verificações de permissão por ferramenta.

O ShopSynch não recomenda compartilhar chaves de API privadas diretamente com ferramentas de IA de terceiros.

Áreas de Ferramentas Disponíveis

As ferramentas MCP do ShopSynch são expostas por área de capacidade. A disponibilidade exata das ferramentas pode variar conforme conta, permissão, ambiente e suporte do cliente.

Área	Exemplos
Analytics	Métricas de receita, pedidos, clientes e produtos
Produtos	Listagem de produtos, detalhes de produtos, fluxos de catálogo, verificações de SKU
Pedidos	Consulta de pedidos, status de pedidos, histórico de pedidos, contexto de atendimento
Clientes	Consulta de clientes e contexto de comportamento de pedidos
Inventário	Verificações de estoque, status de inventário, contexto de estoque baixo
Pagamentos	Consulta de pagamentos, status de pagamentos, contexto de links de pagamento
Categorias	Categorias da loja e classificação de produtos
Promoções e Anúncios	Contexto de promoções e campanhas
Avaliações	Contexto de avaliações da loja e de produtos
Operações da Loja	Perfil da loja, armazéns, zonas de entrega e contexto operacional

Regras de Segurança

Ao usar o ShopSynch com um assistente de IA:

Revise o que o assistente deseja fazer antes de aprovar alterações.
Não compartilhe chaves de API privadas, senhas ou credenciais do painel no chat.
Conecte apenas clientes em que você confia.
Revogue o acesso nas configurações da sua conta ShopSynch quando um cliente não for mais necessário.
Trate dados da loja, clientes, pedidos e pagamentos como confidenciais.

Início Rápido

Use as configurações abaixo para conectar o ShopSynch diretamente à sua ferramenta de IA. O servidor MCP usa OAuth por padrão — sua ferramenta abrirá uma janela do navegador para autorizar o acesso à sua loja na primeira conexão.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "shopsynch": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.shopsynch.com/mcp"]
    }
  }
}

Reinicie o Claude Desktop após salvar. O ShopSynch aparecerá na lista de ferramentas.

Cursor

Crie ou edite .cursor/mcp.json na raiz do seu projeto (ou ~/.cursor/mcp.json globalmente):

{
  "mcpServers": {
    "shopsynch": {
      "url": "https://api.shopsynch.com/mcp"
    }
  }
}

O Cursor solicitará que você autentique com o ShopSynch no primeiro uso.

Antigravity / VS Code (MCP Remoto)

Qualquer cliente MCP que aceite uma URL de servidor remoto pode conectar diretamente:

https://api.shopsynch.com/mcp

Transporte: streamable-http. Nenhum processo local é necessário.

Claude Code (CLI)

claude mcp add --transport http shopsynch https://api.shopsynch.com/mcp

Autenticação por Chave de API (Sem OAuth)

Se sua ferramenta ou script não suporta OAuth, você pode usar um cabeçalho de chave de API:

X-MerchantApiKey: pk_live_<your-key>

As chaves de API estão disponíveis no seu painel do comerciante ShopSynch. Isso ignora o fluxo de consentimento OAuth e autentica diretamente a loja proprietária da chave.

Descoberta Legível por Máquina

Hosts de agentes de IA e indexadores MCP podem descobrir automaticamente o ShopSynch buscando:

GET https://api.shopsynch.com/.well-known/mcp.json

Isso retorna um documento JSON com a URL do endpoint MCP, tipo de transporte, ponteiros de metadados OAuth e opções de autenticação — sem exigir credenciais.

{
  "name": "shopsynch",
  "displayName": "ShopSynch",
  "description": "Connect AI assistants to ShopSynch...",
  "mcpUrl": "https://api.shopsynch.com/mcp",
  "transport": "streamable-http",
  "authentication": {
    "type": "oauth2",
    "authorizationServerMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-authorization-server",
    "protectedResourceMetadataUrl": "https://api.shopsynch.com/.well-known/oauth-protected-resource",
    "pkce": true,
    "defaultScope": "mcp:store",
    "alternativeHeader": "X-MerchantApiKey"
  },
  "documentationUrl": "https://docs.shopsynch.com/mcp"
}