Connector guide10-minute read30 MCP tools7 languages

Connect Bling to Microsoft Copilot via MCP

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Bling

Bling

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

tools

30

Region

BR

Category

ERP

Authentication

OAuth 2.0

Required env vars

BLING_CLIENT_IDBLING_CLIENT_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Guided setup

Connect Bling to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Bling in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Bling

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Bling · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Bling, paste the Client ID and Client Secret of your Bling app, click Authorize with Provider and allow access in Bling, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Bling + Microsoft Copilot

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

BLING_CLIENT_ID, BLING_CLIENT_SECRET

Step 1 — Get credentials

Setting up takes about 10 minutes.

  1. In Bling open Central de Extensoes, Area do Integrador and click Criar aplicativo. Choose visibility Privado (it then works only with your own Bling account, without Bling's review).
  2. Fill in the name and contact data. As Link de redirecionamento enter https://cloud.anythingmcp.com/api/mcp-oauth/callback on AnythingMCP Cloud, or <your AnythingMCP URL>/api/mcp-oauth/callback when you host AnythingMCP yourself.
  3. Select the scopes this connector needs: products, stock, warehouses, sales orders, contacts, NF-e, accounts receivable and payable, payment methods, statuses and company data. Save. Changing scopes later signs every user out.
  4. On the tab Informacoes do app copy the Client ID and Client Secret into BLING_CLIENT_ID and BLING_CLIENT_SECRET, save the connector and click Authorize with Provider, then sign in to Bling and allow access.

Access tokens last 6 hours and are renewed with the refresh token, which lasts 30 days: a connector unused for longer than that needs Authorize with Provider again. Bling blocks an address for an hour after 20 token requests in a minute, so do not retry the sign-in in a loop.

Where to start: bling_get_company checks the connection. Then bling_list_orders (filter by date or status) and bling_get_order, or bling_list_products and bling_get_product.

Products and stock: bling_list_products, bling_get_product, bling_create_product, bling_update_product, bling_list_product_categories, bling_get_stock_balances, bling_get_warehouse_stock_balances, bling_create_stock_movement, bling_list_warehouses. bling_delete_product is installed switched off. saldoVirtual is the physical stock minus what open orders reserve.

Sales orders: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Status ids differ per account: read them with bling_list_status_modules (module Vendas) and bling_list_statuses. bling_delete_order is installed switched off. No tool posts receivables or settles payments.

Contacts: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (replaces the whole contact: read it first).

NF-e: bling_list_invoices, bling_get_invoice (with DANFE and XML links), bling_generate_invoice_from_order (creates a pending draft only). bling_send_invoice, which transmits the NF-e to SEFAZ, is installed switched off: an authorized NF-e is a tax document. Turn it on only deliberately.

Finance (read-only): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. The connector never moves money: no settlement (baixa), boleto or Pix action is included.

Field notes: ids are numbers. Amounts are in BRL with a decimal point. Dates are YYYY-MM-DD; a date range may span at most one year. CPF and CNPJ go as digits. Answers are wrapped in data; errors carry error.type, error.message, error.description and error.fields naming the invalid field.

Paging and limits: lists take pagina from 1 and limite up to 100; an empty data list is the end. Bling allows 3 requests per second and 120,000 per day per account (429 above); 300 errors or 600 requests within 10 seconds block the address for 10 minutes, so do not loop over failing calls.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Microsoft Copilot

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.

  1. In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
  2. Enter a Server name (for example AnythingMCP), a Server description that says what the connector does, and the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server.
  3. Under authentication, choose API key, set Type to Header and the header name to X-API-Key, then select Create.
  4. In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
  5. Try it in the agent's Test pane: ask for something that needs the Bling tools.
  6. Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.

Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.

Available tools

ToolWhat it does
bling_get_companyGet the basic data of the Bling account the connector is signed in to: id, nome (company name), cnpj, email and dataContrato. A cheap call…
bling_list_productsList products: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (virtual balance), tipo, situacao, formato, descricaoCurta…
bling_get_productGet one product with all details: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque…
bling_create_productCreate a product or service. nome, tipo, situacao and formato are required. Returns data.id of the new product (and of its variations). Tax…
bling_update_productChange a product (PATCH: only the fields sent change): name, SKU, price, status, unit, GTIN, brand, short description, weights or category.…
bling_delete_productDelete a product permanently. Products used in orders or invoices may be refused; prefer setting situacao I. Installed switched off
bling_list_product_categoriesList product categories: id, descricao and categoriaPai (parent). Up to 100 per page
bling_get_stock_balancesGet stock balances of products across all warehouses: per product saldoFisicoTotal (physical), saldoVirtualTotal (physical minus reserved…
bling_get_warehouse_stock_balancesGet stock balances of products in one warehouse (deposito): saldoFisico and saldoVirtual per product
bling_create_stock_movementRecord a stock movement for a product in a warehouse: E entrada (in), S saida (out) or B balanco (set the balance to the quantity). Returns…
bling_list_warehousesList warehouses (depositos): id, descricao, situacao, padrao (default) and desconsiderarSaldo
bling_list_ordersList sales orders (pedidos de venda): id, numero, numeroLoja (marketplace order number), data, dataSaida, dataPrevista, totalProdutos…
bling_get_orderGet one sales order: numero, numeroLoja, dates, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)…
bling_create_orderCreate a sales order. Required: contato (id), data, dataSaida, dataPrevista, itens and parcelas. Returns data.id. Creating the order does…
bling_update_order_statusChange the status (situacao) of a sales order, for example to Em andamento or Atendido. Valid status ids come from bling_list_statuses for…
bling_delete_orderDelete a sales order permanently. Cannot be undone. Installed switched off
bling_list_status_modulesList the Bling modules that have statuses (situacoes): id, nome and descricao, for example Vendas (sales orders). Use the id with…
bling_list_statusesList the statuses of one module: id, nome, cor and idHerdado (the standard status it derives from). The ids are what bling_list_orders and…
bling_list_contactsList contacts (customers, suppliers and others): id, nome, codigo, situacao, numeroDocumento (CPF or CNPJ), telefone and celular. Search by…
bling_get_contactGet one contact: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral and…
bling_create_contactCreate a contact (customer or supplier). nome, tipo and situacao are required. Returns data.id
bling_update_contactReplace a contact (PUT: the whole contact is rewritten, fields left out may be emptied). Read it first with bling_get_contact, change what…
bling_list_invoicesList NF-e (electronic invoices): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato…
bling_get_invoiceGet one NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens with taxes, transporte, parcelas, valorNota, xml (link)…
bling_generate_invoice_from_orderCreate a pending NF-e draft from a sales order (situacao pendente). It is not sent to SEFAZ: issuing is a separate step done in Bling or…
bling_send_invoiceIssue an NF-e: transmit it to SEFAZ for authorization. An authorized NF-e is a legal tax document that can only be cancelled within the…
bling_list_receivablesList accounts receivable (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (the order or…
bling_get_receivableGet one account receivable: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto and Pix…
bling_list_payablesList accounts payable (contas a pagar): id, situacao, vencimento, valor, contato and origem. Read-only. Up to 100 per page
bling_list_payment_methodsList payment methods (formas de pagamento): id, descricao, tipoPagamento and situacao. The id goes into the parcelas of an order

Example prompts

  • "Which sales orders from today are still open?"
  • "What is the stock of product SKU CAM-PRETA-M in each warehouse?"
  • "Create a draft NF-e from sales order 15873."
  • "Which receivables are due this week, and for how much in BRL?"
  • "Move order 15873 to the status Em andamento."

FAQ

How does it sign in? With your own private Bling app from Central de Extensoes, Area do Integrador: paste its Client ID and Client Secret, then click Authorize with Provider and allow access in Bling. Tokens are renewed on their own.

Can it issue NF-e? It reads NF-e and creates drafts from orders, but bling_send_invoice, which transmits the NF-e to SEFAZ, installs switched off: an authorized NF-e is a tax document. Accounts receivable and payable are read-only.

Which tools install switched off? bling_send_invoice, bling_delete_product and bling_delete_order. Switch them on on the connector page only if the AI should use them.

Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.

What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.

The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.

Next steps

Was this guide helpful?

Connect Bling to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Bling in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

Related guides

Connectors

Bling MCP Server: Products, Stock and Sales Orders

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to ChatGPT via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Claude via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Cursor via MCP: Products and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Gemini CLI via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Meta Muse via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.