Bling — REST API skill

Você tem acesso à Bling REST API na MCP.AI.

ERP Bling (gestão de SMB e e-commerce, da Locaweb) via API v3 oficial, pedidos de venda, produtos, contatos (clientes/fornecedores), contas a pagar/receber, NF-e, estoque e cadastros, por OAuth 2.0. Somente leitura. Pareia com o Banco MCP pra conciliar financeiro com o extrato do banco. A plataforma fornece o aplicativo OAuth, você só clica em Autorizar e loga com sua conta Bling.

Base URL

https://api.mcp.ai/api/bling

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/bling/get/contato \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"id":"..."}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/bling/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (16)

#### bling_get_contato

Detalha um contato por id (GET /contatos/{id}). _(POST /api/bling/get/contato)_

#### bling_get_nfe

Detalha uma NFe por id (GET /nfe/{id}). _(POST /api/bling/get/nfe)_

#### bling_get_pedido_venda

Detalha um pedido de venda por id (GET /pedidos/vendas/{id}). _(POST /api/bling/get/pedido/venda)_

#### bling_get_produto

Detalha um produto por id (GET /produtos/{id}). _(POST /api/bling/get/produto)_

#### bling_list_accounts

Lista as contas Bling conectadas a este install — id, label. _(POST /api/bling/list/accounts)_

#### bling_list_categorias_produtos

Lista categorias de produtos (GET /categorias/produtos). _(POST /api/bling/list/categorias/produtos)_

#### bling_list_contas_pagar

Lista contas a pagar (GET /contas/pagar). _(POST /api/bling/list/contas/pagar)_

#### bling_list_contas_receber

Lista contas a receber (GET /contas/receber). _(POST /api/bling/list/contas/receber)_

#### bling_list_contatos

Lista contatos (clientes/fornecedores) (GET /contatos). _(POST /api/bling/list/contatos)_

#### bling_list_depositos

Lista depósitos/almoxarifados (GET /depositos). _(POST /api/bling/list/depositos)_

#### bling_list_estoque_saldos

Lista saldos de estoque por produto (GET /estoques/saldos). _(POST /api/bling/list/estoque/saldos)_

#### bling_list_formas_pagamento

Lista formas de pagamento (GET /formas-pagamentos). _(POST /api/bling/list/formas/pagamento)_

#### bling_list_nfe

Lista notas fiscais eletrônicas (GET /nfe). _(POST /api/bling/list/nfe)_

#### bling_list_pedidos_vendas

Lista pedidos de venda (GET /pedidos/vendas). _(POST /api/bling/list/pedidos/vendas)_

#### bling_list_produtos

Lista produtos (GET /produtos). _(POST /api/bling/list/produtos)_

#### bling_list_vendedores

Lista vendedores (GET /vendedores). _(POST /api/bling/list/vendedores)_

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_bling — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).