Zusammenfassung
Bling ERP API v3 (Brasilien): Produkte und Kategorien, Bestandsbestände und Bewegungen, Lagerhäuser, Verkaufsaufträge und -status, Kontakte, NF-e-Abfragen und -Entwürfe, Forderungen und Verbindlichkeiten (lesen). Die Ausstellung von NF-e ist deaktiviert. OAuth 2-Anmeldung mit deiner eigenen Bling-App.
Geführte Einrichtung
Bling in 2 Minuten mit Claude verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Bling in der geführten Einrichtung und trag deine MCP-URL in Claude ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.
Frag einfach
Beispiel-Prompts für Bling
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Bling, füge die Client-ID und das Client Secret deiner Bling-App ein, klicke auf Authorize with Provider und erlaube den Zugriff in Bling, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Bling + Claude
Bling ERP API v3 (Brasilien): Produkte und Kategorien, Bestandsbestände und Bewegungen, Lagerhäuser, Verkaufsaufträge und -status, Kontakte, NF-e-Abfragen und -Entwürfe, Forderungen und Verbindlichkeiten (lesen). Die Ausstellung von NF-e ist deaktiviert. OAuth 2-Anmeldung mit deiner eigenen Bling-App.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
BLING_CLIENT_ID, BLING_CLIENT_SECRET
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 10 Minuten.
- Öffne in Bling Central de Extensoes, Area do Integrador und klicke auf Criar aplicativo. Wähle die Sichtbarkeit Privado (es funktioniert dann nur mit deinem eigenen Bling-Konto, ohne Blings Überprüfung).
- Fülle den Namen und die Kontaktdaten aus. Gib als Link de redirecionamento
https://cloud.anythingmcp.com/api/mcp-oauth/callbackauf AnythingMCP Cloud ein oder<deine AnythingMCP URL>/api/mcp-oauth/callback, wenn du AnythingMCP selbst hostest. - Wähle die Scopes, die dieser Connector benötigt: Produkte, Bestand, Lagerhäuser, Verkaufsaufträge, Kontakte, NF-e, Forderungen und Verbindlichkeiten, Zahlungsmethoden, Status und Unternehmensdaten. Speichern. Änderungen an den Scopes melden alle Benutzer ab.
- Kopiere im Tab Informacoes do app die Client-ID und das Client Secret in
BLING_CLIENT_IDundBLING_CLIENT_SECRET, speichere den Connector und klicke auf Authorize with Provider, melde dich dann bei Bling an und erlaube den Zugriff.
Zugriffstoken halten 6 Stunden und werden mit dem Refresh-Token erneuert, das 30 Tage hält: Ein Connector, der länger als das nicht verwendet wird, benötigt erneut Authorize with Provider. Bling blockiert eine Adresse für eine Stunde nach 20 Token-Anfragen in einer Minute, also versuche nicht, die Anmeldung in einer Schleife zu wiederholen.
Wo du anfangen kannst: bling_get_company überprüft die Verbindung. Dann bling_list_orders (nach Datum oder Status filtern) und bling_get_order, oder bling_list_products und bling_get_product.
Produkte und Bestand: 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 ist standardmäßig deaktiviert. saldoVirtual ist der physische Bestand minus das, was offene Bestellungen reservieren.
Verkaufsaufträge: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Status-IDs unterscheiden sich je nach Konto: Lies sie mit bling_list_status_modules (Modul Vendas) und bling_list_statuses. bling_delete_order ist standardmäßig deaktiviert. Kein Tool verbucht Forderungen oder begleicht Zahlungen.
Kontakte: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (ersetzt den gesamten Kontakt: lies ihn zuerst).
NF-e: bling_list_invoices, bling_get_invoice (mit DANFE- und XML-Links), bling_generate_invoice_from_order (erstellt nur einen ausstehenden Entwurf). bling_send_invoice, das die NF-e an SEFAZ überträgt, ist standardmäßig deaktiviert: Eine autorisierte NF-e ist ein Steuerdokument. Schalte es nur absichtlich ein.
Finanzen (nur lesen): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. Der Connector bewegt niemals Geld: keine Abrechnung (baixa), boleto oder Pix-Aktion ist enthalten.
Feldnotizen: IDs sind Zahlen. Beträge sind in BRL mit einem Dezimalpunkt. Daten sind YYYY-MM-DD; ein Datumsbereich kann höchstens ein Jahr umfassen. CPF und CNPJ sind Ziffern. Antworten sind in data eingewickelt; Fehler tragen error.type, error.message, error.description und error.fields, die das ungültige Feld benennen.
Paging und Limits: Listen nehmen pagina von 1 und limite bis zu 100; eine leere data-Liste ist das Ende. Bling erlaubt 3 Anfragen pro Sekunde und 120.000 pro Tag und Konto (429 darüber hinaus); 300 Fehler oder 600 Anfragen innerhalb von 10 Sekunden blockieren die Adresse für 10 Minuten, also wiederhole keine fehlgeschlagenen Aufrufe in einer Schleife.
Schritt 2 — Installiere den 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
Schritt 3 — Füge den Connector in Claude hinzu
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector ist, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Verwende sie überall, wo dieser LeitfadenYOUR_SERVER_IDanzeigt.
Empfohlener Pfad: funktioniert auf claude.ai web ohne Bearbeitung einer Konfigurationsdatei.
- Öffne in Claude Plugins (in manchen Plänen noch Customize) → Connectors.
- Klicke auf + Add, dann auf Add custom connector.
- Gib einen Namen ein, z.B.
Bling, und die URL des Remote-MCP-Servershttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, und klicke dann auf Continue, übernimm die erkannten Einstellungen und klicke erneut auf Continue. - Wähle Sign in now, klicke auf Add und melde dich bei AnythingMCP (OAuth) an, um den Zugriff zu erlauben.
Alle Tools unten erscheinen in deinem Chat: beginne, Eingabeaufforderungen einzugeben.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
bling_get_company | Erhalte die Basisdaten des Bling-Kontos, bei dem der Connector angemeldet ist: id, nome (Firmenname), cnpj, email und dataContrato. Ein günstiger Aufruf… |
bling_list_products | Liste Produkte auf: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (virtueller Bestand), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Erhalte ein Produkt mit allen Details: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Erstelle ein Produkt oder eine Dienstleistung. nome, tipo, situacao und formato sind erforderlich. Gibt data.id des neuen Produkts (und seiner Varianten) zurück. Steuer… |
bling_update_product | Ändere ein Produkt (PATCH: nur die gesendeten Felder ändern): name, SKU, preis, status, einheit, GTIN, marke, kurze beschreibung, gewichte oder kategorie.… |
bling_delete_product | Lösche ein Produkt dauerhaft. Produkte, die in Bestellungen oder Rechnungen verwendet werden, können abgelehnt werden; bevorzuge es, situacao I zu setzen. Standardmäßig deaktiviert |
bling_list_product_categories | Liste Produktkategorien auf: id, descricao und categoriaPai (Eltern). Bis zu 100 pro Seite |
bling_get_stock_balances | Erhalte Bestandsbestände von Produkten über alle Lagerhäuser hinweg: pro Produkt saldoFisicoTotal (physisch), saldoVirtualTotal (physisch minus reserviert… |
bling_get_warehouse_stock_balances | Erhalte Bestandsbestände von Produkten in einem Lagerhaus (deposito): saldoFisico und saldoVirtual pro Produkt |
bling_create_stock_movement | Zeichne eine Bestandsbewegung für ein Produkt in einem Lagerhaus auf: E entrada (rein), S saida (raus) oder B balanco (setze den Bestand auf die Menge). Gibt… |
bling_list_warehouses | Liste Lagerhäuser (depositos): id, descricao, situacao, padrao (Standard) und desconsiderarSaldo |
bling_list_orders | Liste Verkaufsaufträge (pedidos de venda): id, numero, numeroLoja (Marktplatz-Bestellnummer), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Erhalte einen Verkaufsauftrag: numero, numeroLoja, daten, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Erstelle einen Verkaufsauftrag. Erforderlich: contato (id), data, dataSaida, dataPrevista, itens und parcelas. Gibt data.id zurück. Die Erstellung des Auftrags… |
bling_update_order_status | Ändere den Status (situacao) eines Verkaufsauftrags, zum Beispiel auf Em andamento oder Atendido. Gültige Status-IDs stammen von bling_list_statuses für… |
bling_delete_order | Lösche einen Verkaufsauftrag dauerhaft. Kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert |
bling_list_status_modules | Liste die Bling-Module auf, die Status (situacoes) haben: id, nome und descricao, zum Beispiel Vendas (Verkaufsaufträge). Verwende die ID mit… |
bling_list_statuses | Liste die Status eines Moduls auf: id, nome, cor und idHerdado (der Standardstatus, von dem er abgeleitet ist). Die IDs sind das, was bling_list_orders und… |
bling_list_contacts | Liste Kontakte (Kunden, Lieferanten und andere) auf: id, nome, codigo, situacao, numeroDocumento (CPF oder CNPJ), telefone und celular. Suche nach… |
bling_get_contact | Erhalte einen Kontakt: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral und… |
bling_create_contact | Erstelle einen Kontakt (Kunde oder Lieferant). nome, tipo und situacao sind erforderlich. Gibt data.id zurück |
bling_update_contact | Ersetze einen Kontakt (PUT: der gesamte Kontakt wird neu geschrieben, ausgelassene Felder können geleert werden). Lies ihn zuerst mit bling_get_contact, ändere was… |
bling_list_invoices | Liste NF-e (elektronische Rechnungen) auf: id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Erhalte eine NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens mit Steuern, transporte, parcelas, valorNota, xml (Link)… |
bling_generate_invoice_from_order | Erstelle einen ausstehenden NF-e-Entwurf aus einem Verkaufsauftrag (situacao pendente). Es wird nicht an SEFAZ gesendet: die Ausstellung ist ein separater Schritt, der in Bling oder… |
bling_send_invoice | Stelle eine NF-e aus: übertrage sie an SEFAZ zur Genehmigung. Eine autorisierte NF-e ist ein rechtliches Steuerdokument, das nur innerhalb der… |
bling_list_receivables | Liste Forderungen (contas a receber) auf: id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (die Bestellung oder… |
bling_get_receivable | Erhalte eine Forderung: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto und Pix… |
bling_list_payables | Liste Verbindlichkeiten (contas a pagar) auf: id, situacao, vencimento, valor, contato und origem. Nur lesen. Bis zu 100 pro Seite |
bling_list_payment_methods | Liste Zahlungsmethoden (formas de pagamento) auf: id, descricao, tipoPagamento und situacao. Die ID geht in die parcelas einer Bestellung |
Beispielaufforderungen
- "Welche Verkaufsaufträge von heute sind noch offen?"
- "Wie hoch ist der Bestand des Produkts SKU CAM-PRETA-M in jedem Lager?"
- "Erstelle einen Entwurf für eine NF-e aus dem Verkaufsauftrag 15873."
- "Welche Forderungen sind diese Woche fällig und wie viel in BRL?"
- "Bewege den Auftrag 15873 in den Status Em andamento."
FAQ
Funktioniert es sowohl mit Claude Code als auch mit Claude Desktop? Ja, weise beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID hin.
Wie meldet es sich an? Mit deiner eigenen privaten Bling-App aus Central de Extensoes, Area do Integrador: füge die Client-ID und das Client Secret ein, klicke dann auf Authorize with Provider und erlaube den Zugriff in Bling. Tokens werden automatisch erneuert.
Kann es NF-e ausstellen? Es liest NF-e und erstellt Entwürfe aus Bestellungen, aber bling_send_invoice, das die NF-e an SEFAZ überträgt, ist standardmäßig deaktiviert: Eine autorisierte NF-e ist ein Steuerdokument. Forderungen und Verbindlichkeiten sind nur lesbar.
Welche Tools sind standardmäßig deaktiviert? bling_send_invoice, bling_delete_product und bling_delete_order. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Nächste Schritte
- Connector-Startseite
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?