连接器指南阅读约 4 分钟30 个 MCP 工具7 种语言

用 Gemini CLI 连接 Bling MCP:订单与库存

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

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.

个工具

30

区域

BR

类别

ERP

身份验证

OAuth 2.0

所需环境变量

BLING_CLIENT_IDBLING_CLIENT_SECRET
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

引导式设置

2 分钟将 Bling 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Bling,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Bling 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Bling · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Bling,粘贴你的 Bling 应用的 Client ID 和 Client Secret,点击 Authorize with Provider 并在 Bling 中允许访问,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Bling + Gemini

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

BLING_CLIENT_ID, BLING_CLIENT_SECRET

第 1 步 — 获取凭证

设置大约需要 10 分钟。

  1. 在 Bling 中打开 Central de Extensoes, Area do Integrador 并点击 Criar aplicativo。选择可见性 Privado(这样仅适用于你自己的 Bling 账户,无需 Bling 的审核)。
  2. 填写名称和联系数据。作为 Link de redirecionamento 输入 https://cloud.anythingmcp.com/api/mcp-oauth/callback(在 AnythingMCP Cloud 上),或者 <your AnythingMCP URL>/api/mcp-oauth/callback(当你自己托管 AnythingMCP 时)。
  3. 选择此连接器所需的 scopes:产品、库存、仓库、销售订单、联系人、NF-e、应收账款和应付账款、支付方式、状态和公司数据。保存。稍后更改 scopes 会使每个用户注销。
  4. 在 Informacoes do app 标签上,将 Client ID 和 Client Secret 复制到 BLING_CLIENT_ID 和 BLING_CLIENT_SECRET,保存连接器并点击 Authorize with Provider,然后登录 Bling 并允许访问。

访问令牌有效期为 6 小时,并通过刷新令牌续期,刷新令牌有效期为 30 天:未使用超过此时间的连接器需要再次 Authorize with Provider。在一分钟内请求 20 次令牌后,Bling 会阻止该地址一个小时,因此请不要在循环中重试登录。

从哪里开始:bling_get_company 检查连接。然后使用 bling_list_orders(按日期或状态过滤)和 bling_get_order,或 bling_list_products 和 bling_get_product。

产品和库存: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 默认关闭。saldoVirtual 是物理库存减去未完成订单保留的数量。

销售订单:bling_list_orders、bling_get_order、bling_create_order、bling_update_order_status。状态 ID 在每个账户中不同:使用 bling_list_status_modules(模块 Vendas)和 bling_list_statuses 读取它们。bling_delete_order 默认关闭。没有工具可以发布应收账款或结算付款。

联系人:bling_list_contacts、bling_get_contact、bling_create_contact、bling_update_contact(替换整个联系人:先读取它)。

NF-e:bling_list_invoices、bling_get_invoice(带有 DANFE 和 XML 链接)、bling_generate_invoice_from_order(仅创建待处理草稿)。bling_send_invoice,用于将 NF-e 传输到 SEFAZ,默认关闭:授权的 NF-e 是税务文件。仅在必要时开启。

财务(只读):bling_list_receivables、bling_get_receivable、bling_list_payables、bling_list_payment_methods。连接器从不移动资金:不包括结算(baixa)、boleto 或 Pix 操作。

字段说明:ID 为数字。金额以 BRL 为单位,使用小数点。日期格式为 YYYY-MM-DD;日期范围最多可跨越一年。CPF 和 CNPJ 以数字形式表示。答案被包裹在 data 中;错误包含 error.type、error.message、error.description 和 error.fields,命名无效字段。

分页和限制:列表使用 pagina 从 1 开始,limite 最多为 100;空的 data 列表表示结束。Bling 每个账户允许每秒 3 次请求和每天 120,000 次请求(超出限制为 429);在 10 秒内出现 300 个错误或 600 次请求会阻止该地址 10 分钟,因此请不要在失败的调用上循环。

第 2 步 — 安装适配器

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

第 3 步 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 Bling 的工具。

可用工具

工具功能
bling_get_company获取连接器登录的 Bling 账户的基本数据:id、nome(公司名称)、cnpj、email 和 dataContrato。一次便宜的调用…
bling_list_products列出产品:id、idProdutoPai、nome、codigo(SKU)、preco、precoCusto、estoque(虚拟余额)、tipo、situacao、formato、descricaoCurta…
bling_get_product获取一个产品的所有详细信息:nome、codigo、preco、tipo、situacao、formato、unidade、gtin、marca、pesos、dimensoes、categoria、estoque…
bling_create_product创建一个产品或服务。nome、tipo、situacao 和 formato 是必需的。返回新产品的 data.id(及其变体)。税…
bling_update_product更改产品(PATCH:仅发送的字段更改):name、SKU、price、status、unit、GTIN、brand、short description、weights 或 category.…
bling_delete_product永久删除一个产品。已在订单或发票中使用的产品可能会被拒绝;建议设置 situacao 为 I。默认关闭
bling_list_product_categories列出产品类别:id、descricao 和 categoriaPai(父级)。每页最多 100 个
bling_get_stock_balances获取所有仓库中产品的库存余额:每个产品 saldoFisicoTotal(物理)、saldoVirtualTotal(物理减去保留…
bling_get_warehouse_stock_balances获取一个仓库(deposito)中产品的库存余额:每个产品的 saldoFisico 和 saldoVirtual
bling_create_stock_movement记录一个产品在仓库中的库存变动:E entrada(入库)、S saida(出库)或 B balanco(将余额设置为数量)。返回…
bling_list_warehouses列出仓库(depositos):id、descricao、situacao、padrao(默认)和 desconsiderarSaldo
bling_list_orders列出销售订单(pedidos de venda):id、numero、numeroLoja(市场订单号)、data、dataSaida、dataPrevista、totalProdutos…
bling_get_order获取一个销售订单:numero、numeroLoja、日期、contato、situacao、loja、itens(produto、codigo、descricao、quantidade、valor、desconto)…
bling_create_order创建一个销售订单。必需:contato(id)、data、dataSaida、dataPrevista、itens 和 parcelas。返回 data.id。创建订单不会…
bling_update_order_status更改销售订单的状态(situacao),例如更改为 Em andamento 或 Atendido。有效的状态 ID 来自 bling_list_statuses…
bling_delete_order永久删除一个销售订单。无法撤销。默认关闭
bling_list_status_modules列出具有状态(situacoes)的 Bling 模块:id、nome 和 descricao,例如 Vendas(销售订单)。使用 ID 与…
bling_list_statuses列出一个模块的状态:id、nome、cor 和 idHerdado(它派生的标准状态)。这些 ID 是 bling_list_orders 和…
bling_list_contacts列出联系人(客户、供应商等):id、nome、codigo、situacao、numeroDocumento(CPF 或 CNPJ)、telefone 和 celular。按…
bling_get_contact获取一个联系人:nome、fantasia、tipo(F、J、E)、numeroDocumento、ie、email、emailNotaFiscal、telefone、celular、endereco(geral 和…
bling_create_contact创建一个联系人(客户或供应商)。nome、tipo 和 situacao 是必需的。返回 data.id
bling_update_contact替换一个联系人(PUT:整个联系人被重写,省略的字段可能会被清空)。先使用 bling_get_contact 读取,然后更改…
bling_list_invoices列出 NF-e(电子发票):id、tipo(0 entrada、1 saida)、situacao、numero、serie、dataEmissao、dataOperacao、chaveAcesso、contato…
bling_get_invoice获取一个 NF-e:numero、serie、situacao、chaveAcesso、dataEmissao、contato、itens 及税、transporte、parcelas、valorNota、xml(链接)…
bling_generate_invoice_from_order从销售订单创建待处理的 NF-e 草稿(situacao pendente)。它不会发送到 SEFAZ:发放是一个单独的步骤,在 Bling 或…
bling_send_invoice发放 NF-e:将其传输到 SEFAZ 以获得授权。授权的 NF-e 是一个合法的税务文件,只能在…
bling_list_receivables列出应收账款(contas a receber):id、situacao、vencimento、valor、saldo、contato、formaPagamento、origem(订单或…
bling_get_receivable获取一个应收账款:situacao、vencimento、valor、saldo、dataEmissao、contato、formaPagamento、categoria、origem、boleto 和 Pix…
bling_list_payables列出应付账款(contas a pagar):id、situacao、vencimento、valor、contato 和 origem。只读。每页最多 100 个
bling_list_payment_methods列出支付方式(formas de pagamento):id、descricao、tipoPagamento 和 situacao。ID 进入订单的 parcelas 中

示例提示

  • "今天有哪些销售订单仍然未完成?"
  • "每个仓库中产品 SKU CAM-PRETA-M 的库存是多少?"
  • "从销售订单 15873 创建一个草稿 NF-e。"
  • "本周到期的应收账款有哪些,金额是多少(BRL)?"
  • "将订单 15873 移动到状态 Em andamento。"

常见问题

它如何登录? 使用你在 Central de Extensoes, Area do Integrador 中的私人 Bling 应用:粘贴其 Client ID 和 Client Secret,然后点击 Authorize with Provider 并在 Bling 中允许访问。令牌会自动续期。

它可以发放 NF-e 吗? 它可以读取 NF-e 并从订单创建草稿,但 bling_send_invoice,用于将 NF-e 传输到 SEFAZ,默认关闭:授权的 NF-e 是税务文件。应收账款和应付账款为只读。

哪些工具默认关闭? bling_send_invoice、bling_delete_product 和 bling_delete_order。仅在 AI 应该使用它们时在连接器页面上开启。

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

2 分钟将 Bling 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Bling,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

相关指南

连接器

Bling MCP 服务器:产品、库存与销售订单

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收和应付账款(读取)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

连接器

用 ChatGPT 连接 Bling MCP:订单与库存

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

连接器

用 Claude 连接 Bling MCP:订单与库存

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

连接器

用 Microsoft Copilot 连接 Bling MCP

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

连接器

用 Cursor 连接 Bling MCP:产品与库存

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。

连接器

用 Meta Muse 连接 Bling MCP:订单与库存

Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。