Trade BridgeNEO
API

Anleitung: Die eigene KI per MCP anschließen

Schritt für Schritt Claude, Cursor oder eine andere KI mit Trade Bridge NEO verbinden: Anmeldung ohne Token, Einrichtung je Programm, optionales Token, Freigaben, Kosten, Protokoll und Hilfe bei Fehlern.

Über MCP arbeitet die eigene KI direkt mit Trade Bridge NEO: Man fragt im gewohnten Chat, die KI holt sich die Daten und schlägt Änderungen vor. Was MCP ist und was die KI darf, steht im Artikel MCP-Server. Hier geht es um die Einrichtung.

So funktioniert es

  • Die KI spricht mit dem MCP-Server von Trade Bridge NEO. Das ist eine Adresse, die sie bei jeder Frage über das Internet aufruft.
  • Beim ersten Verbinden meldest du dich mit deinem Trade-Bridge-Zugang an. Die KI arbeitet danach in deinem Namen und darf genau das, was du darfst. Ein Token ist dafür nicht nötig, es gibt ihn nur noch als Möglichkeit für Programme ohne Anmeldung.
  • Die KI wählt selbst passende Werkzeuge: Bestellung suchen, Umsatz rechnen, Anlieferung anlegen, Produkt ändern … Es sind dieselben Werkzeuge, die auch A.KI in Trade Bridge NEO benutzt.
  • Lesen passiert sofort. Ändern passiert erst, wenn man im Chat ausdrücklich zustimmt. Ist die Freigabe eingeschaltet, muss die Änderung zusätzlich in Trade Bridge NEO freigegeben werden.
  • Zu jedem Datensatz nennt die KI den Link in Trade Bridge NEO, damit man das Ergebnis direkt prüfen kann.

1. Voraussetzungen

  • Das Modul MCP ist unter Einstellungen → Module eingeschaltet.
  • Der Nutzer ist in einem Team, das Zugriff auf den Bereich MCP hat (Einstellungen → Nutzer & Anmeldung).
  • Für eigene Auswertungen mit SQL braucht der Nutzer zusätzlich das Sonderrecht SQL-Abfragen. Ohne dieses Recht rechnet die KI mit den fertigen Auswertungswerkzeugen.

2. Adresse holen

Die Adresse des MCP-Servers steht unter MCP → Zugang ganz oben, mit Knopf zum Kopieren. Sie sieht so aus:

https://<deine-installation>.mcp.tbneo.app

Kunden auf tbneo.app können auch die gemeinsame Adresse nehmen; bei der Anmeldung gibt man dann die eigene Unternehmens-ID ein:

https://mcp.tbneo.app

3. Verbinden

Ein Token ist nicht nötig. Beim ersten Verbinden öffnet die KI die Anmeldung von Trade Bridge NEO im Browser:

  1. Mit Google oder per Anmelde-Link per Mail anmelden, mit der Adresse, mit der man auch Trade Bridge NEO nutzt.
  2. Zugriff erlauben klicken.
  3. Fertig. Die KI bleibt bis zu 30 Tage angemeldet und erneuert die Anmeldung selbst. Unter MCP → Zugang steht sie in der Liste Deine Zugänge und lässt sich dort jederzeit widerrufen.

Claude: als Connector im Konto (ohne Terminal, empfohlen)

  1. Auf claude.ai (oder in Claude Desktop) unter Einstellungen → Connectors auf „Add custom connector“ bzw. „Eigenen Connector hinzufügen“ klicken.
  2. Einen Namen eintragen, z. B. „Trade Bridge NEO“, und als URL die Adresse aus MCP → Zugang.
  3. Verbinden klicken. Es öffnet sich die Anmeldung von Trade Bridge NEO: anmelden, dann Zugriff erlauben.
  4. Fertig. Der Connector gilt für das ganze Claude-Konto: im Web, in Claude Desktop und in der App. Im Chat lässt er sich über das Werkzeug-Menü ein- und ausschalten.

Von der KI einrichten lassen (z. B. Claude Code)

Unter MCP → Zugang steht ein fertiger Text mit der richtigen Adresse. Ihn mit Text kopieren übernehmen und in den Chat von Claude Code oder einer anderen KI einfügen, die selbst Server einrichten kann. Wer Trade Bridge NEO schon als Connector im Claude-Konto hat, braucht das nicht zusätzlich. Der Text lautet sinngemäß:

Richte mir bitte den MCP-Server von Trade Bridge NEO ein.
Adresse: <Adresse aus MCP → Zugang>
Name: trade-bridge
Transport: Streamable HTTP (Remote-MCP über HTTPS)
Anmeldung: OAuth über Trade Bridge NEO, kein Token und kein API-Schlüssel nötig.
Richte ihn für alle meine Projekte ein und sag mir danach, wie ich mich anmelde.

In Claude Code danach /mcp eingeben, „trade-bridge“ wählen und Authenticate.

Selbst eintragen

KISo geht es
Claude (Web, Desktop, App)Als Connector im Konto, siehe oben.
Claude CodeText von oben in den Chat geben, dann /mcp → „trade-bridge“ → Authenticate.
ChatGPT, Cursor, VS Code, Gemini und andereDort, wo man MCP-Server oder Connectors hinzufügt, die Adresse eintragen, als Transport HTTP bzw. Streamable HTTP und als Anmeldung OAuth wählen (Token-Feld leer lassen).

Grundsätzlich klappt es mit jeder KI, die MCP über HTTP mit Anmeldung (OAuth) unterstützt. Die Bezeichnungen der Menüs heißen je nach Programm etwas anders.

4. Optional: mit Token

Ein Token braucht nur, wer sich nicht im Browser anmelden kann, etwa ein Skript oder ein älteres Programm. Es gilt, bis man es widerruft. Deshalb sparsam einsetzen.

  1. Unter MCP → Zugang bei Token (optional) einen Namen eintragen, z. B. „Skript Lagerabgleich“, und Token erstellen klicken.
  2. Das Token sofort kopieren. Es wird nur dieses eine Mal angezeigt.
  3. Im Programm zusätzlich den Header Authorization: Bearer <Token> setzen, in Claude Code so:
claude mcp add --transport http trade-bridge <Endpunkt> --scope user \
  --header "Authorization: Bearer <Token>"

5. Erste Fragen

Ein guter Einstieg sind Fragen, deren Antwort man selbst kennt:

  • „Wie viele Bestellungen sind heute reingekommen?“
  • „Zeig mir die Bestellung #10245 mit Sendungsstatus.“
  • „Welche Anlieferungen sind überfällig?“
  • „Was hat sich beim Umsatz im September gegenüber August geändert?“
  • „Setz den Preis von SH-KNIT-NAV-M auf 104,00 €.“ Die KI zeigt vorher, was sich ändert, und wartet auf das Ja.

Zu Beginn eines Gesprächs nennt die KI offene oder überfällige Aufgaben aus dem Task-Center.

6. Freigabe vor Änderungen

Unter MCP → Einstellungen lässt sich festlegen, dass Änderungen von KI-Clients eine Freigabe brauchen. Dann:

  1. Die KI stellt die Änderung nur ein und sagt, dass sie auf Freigabe wartet.
  2. Unter MCP → Freigaben erscheint sie mit allen Werten. Die Zahl im Menü zeigt, wie viele warten.
  3. Ein Mensch gibt einzeln oder gesammelt frei („Alle offenen freigeben“) oder lehnt ab. Freigegebenes wird in der Reihenfolge des Eingangs ausgeführt.
  4. Die KI kann den Stand der Freigabe abfragen und berichtet das Ergebnis.

Das lohnt sich, wenn mehrere Personen mit MCP arbeiten oder eine KI selbstständig größere Mengen ändern soll.

7. Kosten und Wochenlimit

Jeder MCP-Aufruf kostet einen kleinen Betrag, je nach Werkzeug: Lesen ist am günstigsten, Ändern etwas teurer, Aufrufe mit Wirkung nach außen (Mail, Shopify) und Auswertungen per SQL oder Statistik am teuersten. Das teuerste Werkzeug kostet knapp doppelt so viel wie das günstigste. Fehlgeschlagene Aufrufe kosten nichts.

  • Jede Antwort enthält die Kosten dieses einen Aufrufs, z. B. "kosten": "0,33 ct".
  • Mit der Frage „Was haben KI und MCP diese Woche gekostet?“ holt sich die KI die Übersicht: heute, diese und letzte Woche, dieser und letzter Monat, getrennt nach A.KI und MCP, auf Wunsch je Nutzer.
  • Unter MCP → Protokoll steht der Preis an jedem Aufruf, oben die Summen für heute, die Woche und den Monat.
  • Unter Einstellungen → Verbrauch stehen alle Kosten von A.KI und MCP. Dort legt ein Admin ein Wochenlimit für beide zusammen fest. Ist es erreicht, nehmen A.KI-Chat und MCP bis Montag 0 Uhr nichts mehr an; automatische Läufe wie die Inbox-KI laufen weiter.

Alle Preise sind Endpreise in Euro.

8. Protokoll und Widerruf

  • MCP → Protokoll zeigt jeden Aufruf mit Zeit, Nutzer, Token, Werkzeug, Parametern und Ergebnis.
  • Änderungen stehen außerdem im Aktivitätsprotokoll des jeweiligen Datensatzes, mit dem Hinweis „KI über MCP“ und dem Namen des Tokens.
  • Unter MCP → Zugang sieht man je Zugang (angemeldetes Programm oder Token), wann er zuletzt benutzt wurde. Widerrufen sperrt ihn sofort.

Einen Zugang, der in falsche Hände geraten ist, sofort widerrufen.

Grenzen

  • SQL nur lesend, höchstens 5 Sekunden je Abfrage und 200 Zeilen.
  • Keine KI-Läufe in Trade Bridge NEO anstoßen: keine KI-Übersetzung, keine automatische Verarbeitung der Inbox.
  • Löschen und Erstatten bleiben der Oberfläche vorbehalten.

Wenn etwas nicht klappt

MeldungUrsache und Lösung
401 UnauthorizedMit Anmeldung: im Programm neu anmelden (in Claude Code /mcp → Authenticate). Mit Token: Token falsch kopiert oder widerrufen. Neues anlegen und den Header genau so eintragen: Authorization: Bearer <Token>.
Anmeldung meldet „kein Konto“Die Mail-Adresse der Anmeldung hat in Trade Bridge NEO kein aktives Konto. Mit derselben Adresse anmelden, mit der man Trade Bridge NEO nutzt.
403 und Hinweis auf den Bereich MCPDer Nutzer hat keinen Zugriff auf den Bereich MCP. Team-Rechte unter Einstellungen → Nutzer & Anmeldung prüfen.
503 „Modul MCP ist ausgeschaltet“Modul unter Einstellungen → Module einschalten.
405 Method not allowedDas Programm versucht eine dauerhafte Verbindung (GET). Der Server arbeitet ohne Sitzung, nur mit POST. Im Programm Transport „Streamable HTTP“ wählen, nicht „SSE“.
Werkzeug „nicht erlaubt“Dem Nutzer fehlt das Recht für diesen Bereich, z. B. Einkauf bearbeiten oder SQL-Abfragen.
Änderung passiert nichtFreigabe ist eingeschaltet: unter MCP → Freigaben nachsehen.
„Wochenlimit für A.KI und MCP ist erreicht“Ab Montag 0 Uhr geht es weiter, oder ein Admin erhöht das Limit unter Einstellungen → Verbrauch.
Demo und Gespräch

Hol dir die KI in deine Warenwirtschaft.

In der Demo probierst du A.KI 60 Minuten lang selbst aus, im laufenden System mit simulierten Daten. Oder wir zeigen dir Trade Bridge NEO im Gespräch, abgestimmt auf deinen Betrieb.

Demo ansehen