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 Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Bling in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
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 + Microsoft Copilot
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 Microsoft Copilot hinzu
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Bling-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
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
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.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?