API | Bling
MCP Server Bem-vindo Seja bem-vindo ao MCP Server do Bling. Aqui você aprende a conectar o seu assistente de IA favorito diretamente à sua operação no Bling. O Bling oferece um servidor MCP (Model Context Protocol) hospedado que dá a assistentes de IA acesso direto à sua conta Bling. Em vez de abrir o painel e navegar entre telas, você pergunta em linguagem natural e o assistente consulta e opera o Bling em seu nome, com dados reais e atualizados da sua conta. Com o MCP conectado, você pode:
  • Consultar pedidos de venda, notas fiscais, contatos, estoque e contas a pagar/receber sem sair da conversa
  • Criar e atualizar cadastros, pedidos de venda, pedidos de compra e realizar lançamentos de estoque
  • Montar relatórios e panoramas sob demanda (financeiro, vendas, operação do dia), cruzando várias consultas de uma vez
  • Diagnosticar situações comuns, como uma NF-e rejeitada ou um produto perto de zerar no estoque
O acesso respeita os limites de permissão da sua conta no painel Bling. Esta página é organizada em duas partes: Para todos (assistentes de chat e produtividade, com detalhamento para ChatGPT e Claude) e Para desenvolvedores (IDEs e CLIs). No final, você também encontra exemplos detalhados de uso no formato prompt, comportamento esperado e resultado. Visão geral Um fluxo típico de uso é assim:
  1. Entender sua conta: o assistente identifica como sua empresa está organizada: módulos liberados, situações de pedidos e notas, entre outros
  2. Consultar: liste pedidos, NF-e, contatos, contas a pagar/receber
  3. Criar: registre contatos, pedidos de venda, pedidos de compra, lançamentos de estoque
  4. Continuar a conversa: faça novas perguntas sobre o que já foi respondido, sem precisar repetir o contexto
Ferramentas disponíveis Ferramentas são as ações que o assistente pode executar no Bling: consultar um pedido, listar o estoque, criar um contato, entre outras. Elas ficam organizadas por área do negócio. A tabela acima mostra as principais operações por categoria. Depois de conectar, você pode pedir ao próprio assistente a lista completa e atualizada de ferramentas disponíveis (ex.: "quais ferramentas você tem para consultar o Bling?"). Além das ferramentas, o servidor expõe Recursos, que fornecem contexto adicional para a IA entender a estrutura da API. URL do servidor MCP Verifique o status do servidor em https://mcp.bling.com.br/health. Permissões e acesso Conectar não exige nenhuma configuração técnica: qualquer pessoa com uma conta Bling ativa pode fazer login e autorizar o acesso diretamente no cliente de IA escolhido, sem lidar com senhas de API, chaves ou configurações à parte.
  • O acesso não passa das permissões que a sua conta já tem no painel Bling
  • Você só vê e opera os módulos liberados para sua empresa (Cadastros, Vendas, Compras, Fiscal, Financeiro, Estoque, etc.)
  • Não há exposição de dados de outras empresas
  • Você pode revogar o acesso a qualquer momento (veja Gerenciar suas conexões MCP)
Conectando seu assistente de IA Escolha o cliente que você já usa. Se o seu não está listado, veja Outros clientes ou a seção para desenvolvedores. Para todos (assistentes de chat e produtividade) ChatGPT Configure a conexão via Custom Connector no Developer Mode:
  1. Habilite o Developer Mode em Settings → Apps & Connectors → Advanced settings → Developer mode
  2. Clique em Create
  3. Preencha:
    • Name: Bling
    • Description: Conecte o ChatGPT ao Bling para consultar pedidos, NF-e, estoque e financeiro
    • Connector URL: https://mcp.bling.com.br/mcp
    • Authentication: OAuth
  4. Complete o fluxo OAuth com sua conta Bling
Os nomes exatos dos menus podem mudar conforme o ChatGPT é atualizado. Se não encontrar algum desses itens, procure por "Connectors" ou "MCP" nas configurações. Consulte os planos do ChatGPT que suportam Custom Connectors na documentação da OpenAI. Claude Configure a conexão via Custom Connector: Claude.ai (web e mobile)
  1. Acesse Settings → Connectors → Add Custom Connector
  2. Cole https://mcp.bling.com.br/mcp
  3. Complete o fluxo OAuth
Claude Desktop
  1. Abra Settings → Connectors e clique em Add Connector
  2. Cole https://mcp.bling.com.br/mcp
  3. Complete o fluxo OAuth
Os nomes exatos dos menus podem mudar conforme o Claude é atualizado. Se não encontrar algum desses itens, procure por "Connectors" ou "MCP" nas configurações. Consulte os planos do Claude que suportam Custom Connectors na documentação da Anthropic. Outros clientes Outros assistentes de chat e produtividade compatíveis com MCP (como Gemini Enterprise, OpenClaw e Notion) também podem conectar. Qualquer cliente compatível com MCP via mcpServers em config JSON pode usar: No primeiro uso, abre o navegador para autorizar com o Bling. Para desenvolvedores (IDEs e CLIs) Se você desenvolve com a Bling API ou quer integrar o MCP ao seu fluxo de código, qualquer IDE ou CLI compatível com MCP (Cursor, VS Code, Claude Code, Codex, Gemini CLI, Windsurf, Zed, entre outros) pode conectar apontando para a URL do servidor na sua configuração: Para clientes que ainda não suportam Streamable HTTP nativo, use o bridge mcp-remote: No primeiro uso, o navegador abre para autorizar com sua conta Bling. Consulte a documentação do seu cliente para o formato e o caminho exatos do arquivo de configuração de MCP. Fluxos comuns Os fluxos abaixo são prontos para usar: basta colar o prompt no seu assistente conectado. Diagnosticar uma NF-e rejeitada Cole a URL ou número da NF-e do painel Bling no chat. O assistente carrega motivo da rejeição, dados do destinatário e produtos para te ajudar a corrigir e reenviar.
"Por que a NF-e número 12345 foi rejeitada? Como corrigir?" "Verifique todas as NF-e dos últimos 7 dias e me mostre as que rejeitaram, com o motivo"
Resumo financeiro do mês Pergunte de qualquer cliente conectado e o assistente cruza contas a pagar, a receber e calcula o saldo projetado, já agrupando por vencimento.
"Quanto vou receber e quanto preciso pagar este mês? Liste os 5 maiores vencimentos do mês" "Quem são os clientes inadimplentes com boleto vencido?"
Estoque crítico antes de comprar Antes de finalizar um pedido de compra, pergunte ao assistente quais produtos estão zerados ou em ruptura. Ele cruza saldo de estoque com vendas médias para sugerir quantidades de reposição.
"Quais produtos estão em ruptura ou prestes a zerar? Sugira quantidade de reposição baseada no giro dos últimos 30 dias" "Crie um pedido de compra para o fornecedor X com os itens críticos"
Mais ideias Entender o negócio
  • "Qual o panorama operacional do dia?"
  • "Quais são meus 5 maiores pedidos de venda este mês?"
Consultar pedidos e notas
  • "Pedidos prontos para envio sem NF-e ou etiqueta gerada"
  • "Visão 360 do pedido 12345: cliente, produtos, NF-e e logística"
Operação de catálogo
  • "Visão completa do produto X: detalhes, estoque por depósito, giro de vendas"
  • "Crie a categoria 'Linha Premium'"
Conferência fiscal
  • "Cruze pedidos com NF-e e identifique vendas sem nota e divergências"
Operações de cadastro
  • "Crie um contato pessoa jurídica chamado Empresa Teste LTDA"
  • "Crie um pedido de venda para o cliente 5678 com 2 unidades do produto 9012"
Exemplos detalhados Os exemplos abaixo seguem o formato prompt → comportamento esperado → resultado, mostrando quais ferramentas o assistente encadeia e como fica a resposta final. Os valores são ilustrativos. Resumo financeiro
Prompt: "Faça um resumo financeiro da empresa: o que tenho a pagar e a receber, o saldo projetado e quais contas vencem nos próximos 7 dias."
Comportamento esperado: listAccountPayables (em aberto) → listAccountReceivables (pendentes) → o assistente calcula totais, saldo projetado (receber − pagar) e filtra vencimentos dos próximos 7 dias. Resultado: tabela de saldo (a pagar / a receber / saldo projetado), lista de contas a pagar dos próximos 7 dias e maiores valores a receber pendentes. Relatório de vendas de um período
Prompt: "Gere um relatório de vendas do mês passado: faturamento, ticket médio, ranking de produtos e quantos pedidos ainda estão em aberto."
Comportamento esperado: descoberta de situações (listStatusModules + listStatusModuleTransitions, pois os IDs de situação são customizáveis por conta) → listSalesOrders filtrando pelas situações concluídas → getSalesOrder por pedido para montar o ranking → segunda consulta com situações em andamento para contabilizar pedidos abertos. Resultado: faturamento total, ticket médio, top 5 produtos e a contagem de pedidos ainda em aberto no período. Panorama operacional do dia
Prompt: "Monte o panorama operacional de hoje: vendas, notas fiscais, estoque crítico, expedição pendente e financeiro do dia."
Comportamento esperado: listSalesOrders (hoje) + listNfes (hoje) + listProducts (filtrando por saldo em estoque zerado/negativo) + listSalesOrders (últimos 7 dias, não finalizados) + listAccountPayables/listAccountReceivables (vencimento hoje), consolidados em um único dashboard. Resultado: dashboard com vendas e NF-e do dia, contagem de estoque crítico e expedição pendente, financeiro do dia e uma lista de ações imediatas. Recursos Recursos fornecem contexto adicional para a IA entender a estrutura da API. Gerenciar suas conexões MCP Você pode ver e revogar a qualquer momento o acesso do MCP à sua conta Bling.
  1. Acesse Aplicativos no painel Bling
  2. Localize o aplicativo MCP Bling autorizado
  3. Clique em Revogar acesso
Após revogar, o cliente conectado perde acesso imediatamente. Para reconectar, refaça o fluxo OAuth no próprio cliente. Considerações de segurança Você confia ao seu assistente de IA o acesso aos dados da sua conta Bling. Revise a política de privacidade do provedor antes de conectar. Quando conectado, o assistente pode consultar e operar o seu Bling em seu nome. Os dados retornados são também enviados ao provedor de IA (OpenAI, Anthropic, Google, etc.); revise as políticas deles. Controles de acesso
  • A conexão usa OAuth 2.1 com PKCE, e as credenciais não saem do fluxo do Bling
  • Antes de executar uma operação, o cliente de IA pede sua autorização. Dependendo do cliente, você pode aprovar operação por operação ou permitir sempre para as próximas vezes
  • Para revogar acesso a qualquer momento, veja Gerenciar suas conexões MCP
Boas práticas
  • As ações executadas afetam dados reais da sua conta. Ao testar, acompanhe os pedidos de autorização e confira o que cada operação faz antes de aprovar, principalmente em criações e alterações
  • Se você não é o responsável pela conta, alinhe com quem decide na empresa antes de habilitar o acesso
  • Revogue o acesso pelo painel Bling quando parar de usar um cliente
  • O tratamento de dados segue a Política de Privacidade do Bling e a LGPD
Encontrou uma vulnerabilidade? Reporte para [email protected]. Investigamos todo relatório recebido com prioridade e cuidado. Perguntas frequentes FAQ geral Funciona no celular? Sim. Após conectar o Bling em qualquer cliente (web ou desktop), o connector fica disponível automaticamente nos apps mobile do mesmo provedor. Teste primeiro no desktop e depois experimente no celular. Posso ter mais de uma empresa Bling conectada simultaneamente? Cada cliente MCP autoriza uma conta Bling por vez. Se você gerencia várias empresas, troque de empresa no painel Bling antes de iniciar uma sessão no assistente, ou conecte cada empresa em um cliente diferente (ex.: empresa A no ChatGPT, empresa B no Claude). O assistente tem acesso a tudo no meu Bling? Apenas aos módulos liberados para a sua conta (vendas, compras, fiscal, financeiro, estoque, cadastros, conforme o seu plano). Além disso, é o próprio assistente quem realiza cada consulta ou ação, sempre pedindo sua aprovação antes de agir. Onde eu vejo os assistentes que estão conectados? Vá em Gerenciar suas conexões MCP para ver e revogar o acesso. O Bling cobra a mais por isso? Não há cobrança adicional pelo uso do MCP. As requisições feitas pelo assistente em seu nome usam os limites de requisições da API já contratados no seu plano Bling. Veja Limites. FAQ para desenvolvedores Suporta WSL no Windows? Sim. Para clientes que rodam em WSL com mcp-remote, use: O servidor suporta SSE legado ou apenas Streamable HTTP? Hoje suporta apenas Streamable HTTP (/mcp), o transporte atual do protocolo MCP, que substituiu o SSE usado em versões antigas da especificação. Isso não tem relação com criptografia: a conexão sempre acontece via HTTPS. Limites O MCP usa os mesmos limites de requisições da API já contratados no seu plano Bling, sem um limite adicional específico para o MCP. Quando o limite é atingido, o servidor aplica retry automático com backoff exponencial. Verificar o servidor Healthcheck: Retorna {"status":"ok"} se o servidor está operacional. Precisando de ajuda? Dúvidas sobre o MCP ou problemas de conexão: [email protected]. Para reportar uma vulnerabilidade de segurança, veja Considerações de segurança.