摘要
Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。
引导式设置
2 分钟将 Bling 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Bling,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
Bling 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Bling,粘贴你的 Bling 应用的 Client ID 和 Client Secret,点击 Authorize with Provider 并在 Bling 中允许访问,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Bling + ChatGPT
Bling ERP API v3(巴西):产品和类别、库存余额和变动、仓库、销售订单和状态、联系人、NF-e 读取和草稿、应收账款和应付账款(只读)。发放 NF-e 已关闭。使用你自己的 Bling 应用进行 OAuth 2 登录。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
BLING_CLIENT_ID, BLING_CLIENT_SECRET
第 1 步 — 获取凭证
设置大约需要 10 分钟。
- 在 Bling 中打开 Central de Extensoes, Area do Integrador 并点击 Criar aplicativo。选择可见性 Privado(这样仅适用于你自己的 Bling 账户,无需 Bling 的审核)。
- 填写名称和联系数据。作为 Link de redirecionamento 输入
https://cloud.anythingmcp.com/api/mcp-oauth/callback(在 AnythingMCP Cloud 上),或者<your AnythingMCP URL>/api/mcp-oauth/callback(当你自己托管 AnythingMCP 时)。 - 选择此连接器所需的 scopes:产品、库存、仓库、销售订单、联系人、NF-e、应收账款和应付账款、支付方式、状态和公司数据。保存。稍后更改 scopes 会使每个用户注销。
- 在 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 步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Bling。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
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 应该使用它们时在连接器页面上开启。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?