mcp-bling

@codespar/mcp-bling

商品、注文、連絡先、請求書、在庫を管理する ERP、Bling 用の MCP サーバー

クイックスタート

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	注文から税務請求書（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	Bling のイベントを受信する Webhook（通知）を登録します
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
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT