So nutzen Sie Claude zum Debuggen Ihrer APIs

Published: 2026-07-14 | Jan Procházka

Das Debuggen einer API bedeutet meist, mit Postman-Sammlungen zu jonglieren, Wegwerf-Skripte zu schreiben oder Abfragen von Hand zu basteln, nur um eine einfache Frage zu beantworten wie „Warum ist dieses Feld null?" oder „Welche Bestellung hängt fest?". Was wäre, wenn Sie einfach fragen könnten?

DbGate Central bringt einen integrierten MCP-Server (Model Context Protocol) mit, der Ihre API-Verbindungen für KI-Assistenten wie Claude verfügbar macht. Sobald die Verbindung steht, kann Claude Ihre laufenden GraphQL-, Business-Central- (oData) und Shopify-Verbindungen genauso erkunden und abfragen wie Sie - direkt aus dem Chat, mit einem Zugriff, über den Sie jederzeit die Kontrolle behalten.

Diese Anleitung zeigt Ihnen, wie Sie das in wenigen Minuten einrichten und Claude anschließend zum Debuggen aller drei APIs nutzen.

DbGate Central öffnen →

Warum APIs mit Claude debuggen?

Da Lese- und Schreibzugriffe dieselbe Engine wie das Grid von DbGate Central verwenden, sieht Claude genau dieselben Daten und Möglichkeiten wie Sie - nie mehr als den Zugriff, den Sie gewähren. Das macht es zu einem natürlichen Debugging-Begleiter:

„Wie sieht das Schema dieser Entität eigentlich aus?"
„Finde die Datensätze, in denen dieses Feld null ist, und zeige mir, was sie gemeinsam haben."
„Welcher Bestellung fehlt eine Erfüllung (Fulfillment), und warum?"

Sie beschreiben das Problem in einfacher Sprache; Claude untersucht das Schema, führt die Abfragen aus und schlussfolgert über die Ergebnisse - ohne dass Sie die Unterhaltung verlassen.

Was Sie benötigen

Einen DbGate Central-Workspace mit den zu debuggenden Verbindungen, die bereits hinzugefügt sind - einen GraphQL-Endpunkt, einen oData-Endpunkt (wir verwenden Microsoft Dynamics 365 Business Central als Beispiel) und/oder einen Shopify-Store. Siehe Mit API-Endpunkten verbinden, falls Sie diese noch nicht hinzugefügt haben.
Ein Claude-Konto, das Custom Connectors unterstützt.

Schritt 1 - Ein MCP-Profil in DbGate Central erstellen

Öffnen Sie den Tab Einstellungen (das Zahnradsymbol unten in der Aktivitätsleiste) und erstellen Sie ein neues MCP-Profil. Das Profil liefert Ihnen drei Werte, die Sie gleich benötigen:

Server-URL - in der Form https://central.dbgate.cloud/mcp/{profileId}
Client-ID
Client-Secret

Kopieren Sie alle drei. Jeder Workspace kann mehrere MCP-Profile haben, jedes mit eigener URL, eigenen Anmeldedaten und eigenen Berechtigungen pro Verbindung - so können Sie eng begrenzten Zugriff vergeben (zum Beispiel ein Profil, das nur eine einzige schreibgeschützte Verbindung sieht).

Schritt 2 - Den Custom Connector in claude.ai hinzufügen

Fügen Sie in claude.ai einen Custom Connector hinzu, indem Sie die Server-URL aus dem vorherigen Schritt zusammen mit der Client-ID und dem Client-Secret als OAuth-Anmeldedaten verwenden.

Claude führt dann den OAuth-2.1-mit-PKCE-Handshake aus: Sie werden aufgefordert, sich bei DbGate anzumelden und einzuwilligen, wodurch der Connector an genau dieses MCP-Profil und diesen Workspace gebunden wird. Client-Secrets werden verschlüsselt gespeichert, und bis Sie diesen Schritt abschließen, wird nichts über Ihre Daten weitergegeben.

Configuring the DbGate Central custom connector in claude.ai
Hinzufügen des Custom Connectors von DbGate Central in claude.ai

Schritt 3 - Zugriff pro Verbindung gewähren

Standardmäßig hat ein MCP-Profil Keinen Zugriff auf alles - allein durch das Verbinden des Profils wird also nichts geteilt. Öffnen Sie für jede Verbindung, die Claude erreichen soll, deren Editor und legen Sie die MCP-Zugriffsstufe fest:

Kein Zugriff (Standard) - die Verbindung ist für den Agenten unsichtbar.
Schreibgeschützt - der Agent kann auflisten, untersuchen und abfragen, aber nichts ändern.
Beschreibbar - der Agent kann außerdem Zeilen aktualisieren (nur Shopify, siehe unten).

Ein sinnvoller Ausgangspunkt für das Debuggen ist Schreibgeschützt für Ihre GraphQL- und Business-Central-Verbindungen und Beschreibbar nur für Shopify, wenn Sie tatsächlich möchten, dass Claude Änderungen vornimmt.

Was Claude kann

Sobald eine Verbindung geteilt ist, erhält Claude diese Werkzeuge für oData-, GraphQL- und Shopify-Verbindungen:

Verbindungen auflisten - die Verbindungen, die dieses Profil verwenden darf.
Entitäten auflisten - Tabellen, Views oder Katalogentitäten.
Das Schema untersuchen - Spaltennamen und -typen.
Zeilen abfragen - Daten filtern, paginieren und auswählen.
Zeilen aktualisieren - nur Shopify und nur, wenn Sie Beschreibbar-Zugriff gewähren.

Jeden API-Typ debuggen

So sieht eine echte Debugging-Sitzung für jeden Verbindungstyp aus. Die Prompts sind einfaches Deutsch - die kursiv gesetzten Tool-Aufrufe sind das, was Claude im Hintergrund ausführt.

GraphQL

Die Flexibilität von GraphQL macht es zugleich schwer zu debuggen: Eine Abfrage gibt stillschweigend null zurück, und Sie rätseln, ob es am Schema, an den Argumenten oder an den Daten liegt. Lassen Sie Claude das Schema für Sie durchgehen.

Sie: Liste in meiner GraphQL-Verbindung die verfügbaren Entitäten auf, zeige mir das Schema von orders, finde dann alle Bestellungen, bei denen total null ist, und sage mir, was sie gemeinsam haben.

Claude führt list_entities aus, um die Views zu ermitteln, get_schema für orders, um die Felder und Typen zu bestätigen, dann query_rows, um die betroffenen Datensätze abzurufen - und schlussfolgert über das Ergebnis, um das Muster zu erkennen (zum Beispiel, dass ihnen allen ein zugehöriger payment-Node fehlt).

oData - Business Central

Microsoft Dynamics 365 Business Central stellt seine Daten als oData-V4-Dienst bereit, den DbGate Central wie eine gewöhnliche Menge von Tabellen behandelt. Dadurch werden ERP-Daten - Kunden, Rechnungen, Buchungsposten - in einfacher Sprache abfragbar.

Sie: Finde in meiner Business-Central-Verbindung die Verkaufsrechnungen für den Kunden „Contoso" vom letzten Monat und summiere ihre Beträge.

Claude verwendet query_rows und übersetzt Ihre Anfrage im Hintergrund in die oData-Abfrageoptionen - $filter, um auf den Kunden und den Datumsbereich einzugrenzen, $select, um die Spalten auszuwählen, und $top/$skip für die Paginierung - und summiert dann die Ergebnisse für Sie.

Shopify

Für einen Shopify-Store verbindet sich DbGate Central über die Shopify Admin API und stellt Produkte, Bestellungen, Kunden, Metafelder und mehr bereit.

Sie: Finde Bestellung #1043 und sage mir, warum ihre Erfüllung (Fulfillment) feststeckt.

Claude führt query_rows gegen Ihre Shopify-Verbindung aus, um die Bestellung zu finden und ihren Fulfillment- und Positionsstatus zu prüfen.

Wenn - und nur wenn - Sie Beschreibbar-Zugriff gewährt haben, kann Claude auch die Korrektur vornehmen:

Sie: Füge dieser Bestellung das Tag needs-review hinzu.

Claude verwendet update_rows, das nur für Shopify verfügbar ist und Beschreibbar-Zugriff erfordert. Es findet den Datensatz anhand eines Abgleichsziels und -werts und wendet dann Ihre Aktualisierung an. Bei schreibgeschützten Verbindungen ist dieses Werkzeug schlicht nicht verfügbar, sodass ein Agent niemals Daten ändern kann, deren Freigabe Sie nicht beabsichtigt haben.

Sie behalten die Kontrolle

Der MCP-Server ist so gebaut, dass das Teilen Ihres Workspace mit einem KI-Assistenten niemals bedeutet, die Kontrolle abzugeben:

Standardmäßig wird nichts geteilt - jede Verbindung startet bei Kein Zugriff.
Berechtigungen pro Verbindung - Sie entscheiden pro MCP-Profil genau, welche Verbindungen schreibgeschützt und welche beschreibbar sind.
Schreibzugriffe sind optional und eng begrenzt - update_rows existiert nur für Shopify und nur mit Beschreibbar-Zugriff.
Sicher konzipiert - die Authentifizierung nutzt OAuth 2.1 mit PKCE, und Client-Secrets werden verschlüsselt gespeichert.
Nie mehr als Sie - der Agent verwendet dieselbe Engine wie das Grid und sieht daher genau die Daten und Möglichkeiten, die auch Sie sehen.

Fazit

Mit einem MCP-Profil in DbGate Central und einem Custom Connector in claude.ai wird Claude zu einem praktischen Debugging-Partner für Ihre GraphQL-, Business-Central- (oData) und Shopify-APIs - er untersucht Schemas, führt Abfragen aus und wendet, wo Sie es erlauben, Korrekturen an. Richten Sie es einmal ein, gewähren Sie nur, was Sie brauchen, und beginnen Sie, Fragen zu stellen, statt sie zu schreiben.