mcp-bling

@codespar/mcp-bling

面向 Bling 的 MCP 服务——提供产品、订单、联系人、发票和库存管理的 ERP

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bling"],
      "env": {
        "BLING_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add bling -- npx @codespar/mcp-bling

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bling"],
      "env": {
        "BLING_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

工具（28 个）

工具	用途
list_products	列出 Bling 中的产品
create_product	在 Bling 中创建产品
list_categories	列出 Bling 中的产品类别
create_category	在 Bling 中创建产品类别
list_orders	列出 Bling 中的销售订单
create_order	在 Bling 中创建销售订单
list_purchase_orders	列出 Bling 中的采购订单（pedidos de compras）
create_purchase_order	在 Bling 中创建采购订单（pedido de compra）
list_contacts	列出 Bling 中的联系人（客户/供应商）
create_contact	在 Bling 中创建联系人
get_contact	按 ID 获取单个联系人
update_contact	更新现有联系人
list_invoices	列出 Bling 中的财政发票（NF-e）
create_invoice	根据订单在 Bling 中创建财政发票（NF-e）
send_invoice	将已创建的 NF-e 发送/开具至 SEFAZ
create_service_invoice	在 Bling 中创建服务发票（NFS-e）
get_stock	获取产品库存
update_stock	更新产品在某个仓库的库存
create_stock_movement	登记产品的入库或出库变动（等同于 update_stock，但明确指定方向）
list_warehouses	列出 Bling 中的仓库（depósitos）
create_warehouse	在 Bling 中创建仓库（depósito）
list_accounts_receivable	列出应收账款（contas a receber）
create_account_receivable	创建应收账款（conta a receber）
list_accounts_payable	列出应付账款（contas a pagar）
create_account_payable	创建应付账款（conta a pagar）
list_payment_methods	列出付款方式（formas de pagamento）
subscribe_webhook	注册 webhook（notificação）以接收 Bling 事件
unsubscribe_webhook	移除之前注册的 webhook

身份验证

Bling 使用 OAuth2 Bearer 令牌进行身份验证。

沙盒 / 测试

Bling 通过 OAuth 流程提供沙盒。开发时请使用测试凭据。

获取凭据

1. 前往 Bling Developer Portal
2. 创建账户
3. 注册 OAuth 应用并获取访问令牌
4. 设置 BLING_ACCESS_TOKEN 环境变量

环境变量

变量	必需	说明
BLING_ACCESS_TOKEN	是	OAuth2 访问令牌

路线图

v0.3（计划中）

• production_management — 管理生产订单
• multi_store — 多店铺库存（Mercado Livre、Shopee、Amazon 集成）
• list_nfce / create_nfce — 消费者发票（NFC-e）辅助工具
• 为 list_accounts_* 增加更丰富的筛选条件（按付款状态、联系人筛选）

想要参与贡献？提交 PR 或请求添加工具。

链接

• Bling 网站
• Bling API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款设置治理、预算上限和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

许可证

MIT