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 Configurações → Integrações 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

Configurações → Conectores → Adicionar conector personalizado → cole o endereço acima → Conectar. Na tela do Sinapse, entre e clique em Autorizar.

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 Integrações → Assistentes de IA, 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”

• 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: Integrações → Desconectar Bling 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