Manual de uso

O Sinapse é um hub de conectores MCP (Model Context Protocol) que expõe as operações das ferramentas do seu negócio — a começar pelo Bling — para assistentes de IA como Claude, ChatGPT, Cursor e Claude Code. Com ele, tarefas que exigiriam navegar pelo painel viram pedidos diretos: “cadastre este produto com NCM 6109.10.00”, “quais pedidos estão em aberto esta semana?”, “emita a nota do pedido 4312”.

1. Crie sua conta em sinapse.origem.digital/register (ou entre, se já tiver).
2. No painel, abra Meus MCPs → Bling ERP e clique em Conectar Bling.
3. Faça login no Bling, revise as permissões e clique em Autorizar.
4. Você volta ao painel com a empresa conectada. A partir daí o Sinapse começa a montar, em segundo plano, um cache dos últimos 12 meses de pedidos e contas a receber — é ele que responde perguntas de faturamento em segundos, sem esbarrar nos limites da API do Bling.

O endereço do conector é o mesmo para todas as integrações da sua conta:

https://sinapse.origem.digital/api/mcp/mcp

Caminho mais simples — OAuth. Claude.ai, Claude Desktop, Claude Code, Cursor e ChatGPT abrem o navegador para você entrar no Sinapse e autorizar. Nada de chave para copiar.

Claude.ai / Claude Desktop

Clique no seu nome, no rodapé da coluna da esquerda, e abra Configurações. Na seção Personalizar, clique em Conectores → Adicionar → Adicionar conector personalizado. Em Nome, escreva Sinapse; em URL do servidor MCP, cole o endereço acima e clique em Continuar. Siga os próximos passos sem mudar as opções: o Claude abre a tela de login do Sinapse, você entra com a sua conta e pronto — a autorização é automática, não existe botão de autorizar.

Os conectores ficam em Personalizar, no fim da coluna da esquerda — não no grupo de cima. É onde a maioria se perde.

Claude Code

claude mcp add sinapse --transport http https://sinapse.origem.digital/api/mcp/mcp

Cursor e outros clientes MCP

No arquivo de servidores MCP (mcp.json):

{
  "mcpServers": {
    "sinapse": { "url": "https://sinapse.origem.digital/api/mcp/mcp" }
  }
}

Clientes sem OAuth (scripts, automações)

Em Meus MCPs → Sua IA → Chaves de acesso, gere uma chave de API e envie-a no cabeçalho Authorization: Bearer SUA-CHAVE. A chave é exibida uma única vez; se perder, revogue e gere outra.

• “Quanto faturei em julho?” — o assistente começa pelo panorama, que diz se nesta conta o faturamento está nos pedidos ou nas contas a receber
• “Quais produtos mais venderam no último trimestre?”
• “Liste os produtos sem estoque”
• “Cadastre o produto Camiseta Preta P, SKU CAM-P-01, R$ 79,90, NCM 6109.10.00, origem nacional”
• “Quais pedidos de venda foram feitos ontem?”
• “Gere a NF-e do pedido 4312 e envie para a SEFAZ”
• “Quanto tenho a receber vencendo esta semana?”
• “Lance entrada de 50 unidades do SKU CAM-P-01 no depósito principal”

Receitas são roteiros prontos de análise: dizem à sua IA o que consultar no Sinapse, em que ordem, e o que entregar no fim — sempre com os números lidos e a conta à vista. Quem faz a análise é a sua IA; a receita já vem ajustada aos canais que a sua conta tem conectados, e deixa de fora (avisando) os que não têm.

• Diagnóstico do período e 3 prioridades (diagnostico_mes): Panorama de vendas, margem e mídia em todos os canais conectados, comparado com o período anterior, e as 3 prioridades de maior impacto em reais.
• Margem real por canal e por produto (margem_por_canal): Quanto sobra de cada venda depois de tarifa, frete, custo do produto, imposto e mídia, por canal e nos produtos que mais vendem. Mostra onde se vende muito e se ganha pouco.
• Risco de ruptura de estoque (ruptura_estoque): Produtos que acabam antes da reposição no ritmo de venda atual, a receita em risco em cada um, e o estoque parado que empata dinheiro.
• Curva ABC de produtos (curva_abc): Produtos A, B e C por faturamento (80/15/5), cruzados com margem e estoque, com o que fazer em cada faixa: proteger os A, testar os B, liquidar ou cortar os C.
• Mídia × margem e estoque (midia_x_margem): Cruza o gasto de anúncios (Meta, Google, Shopee Ads) com a margem e o estoque dos produtos anunciados: o que escalar, o que manter e o que cortar porque vende sem lucro ou vai faltar.
• Caixa das próximas semanas (caixa_proximas_semanas): Entradas e saídas previstas semana a semana: contas a pagar e a receber do Bling, mais o que os marketplaces ainda vão repassar. Mostra as semanas apertadas antes de chegarem.
• Saúde dos anúncios do Mercado Livre (saude_anuncios_ml): Raio-X dos anúncios (visitas, conversão, estoque, ficha técnica, imagens, custos), perguntas sem resposta, promoções abertas com a margem no preço promocional e a concorrência nos anúncios de catálogo.
• Presença no Google (presenca_google): Busca orgânica (Search Console), produtos reprovados no Merchant Center, tráfego e conversão por origem (GA4) e termos de busca que gastam sem converter no Google Ads.

Como usar

• Em qualquer IA: peça pelo nome, por exemplo “Use a receita diagnostico_mes do Sinapse para o mês passado.”. A IA busca o roteiro (ferramenta receita_obter) e segue. Para ver a lista, pergunte “que análises o Sinapse sabe fazer?”.
• No Claude.ai e no Claude Desktop: na caixa de mensagem, clique no + no canto inferior esquerdo, abra Conectores, passe o mouse sobre o Sinapse e escolha a receita. Se ela não aparecer, reconecte o conector.
• No Claude Code: as receitas viram comandos, como /mcp__sinapse__diagnostico_mes (com o nome que você deu ao conector).

No painel, MCPs → Receitas de análise mostra cada receita com os canais que ela usa e um botão para copiar o pedido.

• Cada organização enxerga somente os próprios dados: o isolamento é feito pelo token, em toda operação.
• Tokens do Bling ficam criptografados (AES-256-GCM) e são renovados automaticamente.
• Todo o tráfego usa HTTPS.
• O cache guarda apenas cabeçalhos de pedidos, itens e contas a receber, para análises — não há revenda nem uso fora da sua conta.
• Operações sensíveis — excluir registros, enviar nota à SEFAZ — são marcadas para que o assistente peça sua confirmação antes de executar.
• Tokens de assistentes só-leitura não conseguem alterar nada no Bling.

No Sinapse: Meus MCPs → Bling ERP → Desconectar apaga os tokens; em Assistentes de IA você revoga qualquer chave. No Bling: Central de Extensões → Minhas instalações, localize o Sinapse e desinstale — o acesso é cortado na hora.

Dúvidas, problemas ou sugestões: rogerio@origem.digital.

Problemas comuns