Jak používat Claude k ladění vašich API

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

Ladění API obvykle znamená žonglování s kolekcemi v Postmanu, psaní jednorázových skriptů nebo ruční sestavování dotazů jen kvůli zodpovězení jednoduché otázky jako „proč je toto pole null?“ nebo „která objednávka uvízla?“. Co kdybyste se mohli prostě zeptat?

DbGate Central obsahuje vestavěný MCP (Model Context Protocol) server, který zpřístupňuje vaše API připojení AI asistentům, jako je Claude. Jakmile je připojený, může Claude prozkoumávat a dotazovat vaše živá připojení GraphQL, Business Central (oData) a Shopify stejně jako vy - přímo z chatu, s přístupem, který zůstává pod vaší kontrolou.

Tento návod vám ukáže, jak vše během několika minut nastavit a poté použít Claude k ladění všech tří.

Otevřít DbGate Central →

Proč ladit API pomocí Claude?

Protože čtení i zápisy využívají stejný engine jako mřížka v DbGate Central, Claude vidí přesně stejná data a možnosti jako vy - nikdy víc než přístup, který udělíte. Díky tomu je přirozeným společníkem pro ladění:

„Jak vlastně vypadá schéma této entity?“
„Najdi záznamy, kde je toto pole null, a ukaž mi, co mají společného.“
„Které objednávce chybí vyřízení a proč?“

Popíšete problém běžným jazykem; Claude prozkoumá schéma, spustí dotazy a nad výsledky uvažuje - aniž byste opustili konverzaci.

Co budete potřebovat

Pracovní prostor DbGate Central s již přidanými připojeními, která chcete ladit - koncový bod GraphQL, koncový bod oData (jako příklad použijeme Microsoft Dynamics 365 Business Central) a/nebo obchod Shopify. Pokud jste je ještě nepřidali, podívejte se na Připojení ke koncovým bodům API.
Účet Claude, který podporuje vlastní konektory.

Krok 1 - Vytvořte MCP profil v DbGate Central

Otevřete kartu Nastavení (ikona ozubeného kola v dolní části lišty aktivit) a vytvořte nový MCP profil. Profil vám poskytne tři hodnoty, které za chvíli budete potřebovat:

URL serveru - ve tvaru https://central.dbgate.cloud/mcp/{profileId}
Client ID
Client Secret

Zkopírujte všechny tři. Každý pracovní prostor může mít více MCP profilů, každý s vlastní URL, přihlašovacími údaji a oprávněními pro jednotlivá připojení - takže můžete rozdávat úzce vymezený přístup (například profil, který vidí pouze jediné připojení jen pro čtení).

Krok 2 - Přidejte vlastní konektor v claude.ai

V claude.ai přidejte vlastní konektor pomocí URL serveru z předchozího kroku spolu s Client ID a Client Secret jako přihlašovacími údaji OAuth.

Claude poté provede handshake OAuth 2.1 s PKCE: budete požádáni, abyste se přihlásili do DbGate a udělili souhlas, což naváže konektor na konkrétní MCP profil a pracovní prostor. Client secrets jsou šifrovány v klidovém stavu a dokud tento krok nedokončíte, nic o vašich datech se nesdílí.

Configuring the DbGate Central custom connector in claude.ai
Přidání vlastního konektoru DbGate Central v claude.ai

Krok 3 - Udělte přístup pro jednotlivá připojení

Ve výchozím nastavení má MCP profil Žádný přístup ke všemu - takže samotné připojení profilu nesdílí nic. U každého připojení, ke kterému chcete Claude umožnit přístup, otevřete jeho editor a nastavte úroveň MCP přístupu:

Žádný přístup (výchozí) - připojení je pro agenta neviditelné.
Jen pro čtení - agent může vypisovat, kontrolovat a dotazovat, ale nemůže nic měnit.
Zapisovatelné - agent může také aktualizovat řádky (pouze Shopify, viz níže).

Rozumným výchozím bodem pro ladění je Jen pro čtení pro vaše připojení GraphQL a Business Central a Zapisovatelné pro Shopify jen tehdy, pokud opravdu chcete, aby Claude prováděl změny.

Co Claude dokáže

Jakmile je připojení sdílené, získá Claude tyto nástroje pro připojení oData, GraphQL a Shopify:

Vypsat připojení - připojení, která tento profil smí používat.
Vypsat entity - tabulky, pohledy nebo katalogové entity.
Zkontrolovat schéma - názvy sloupců a typy.
Dotazovat řádky - filtrovat, stránkovat a vybírat data.
Aktualizovat řádky - pouze Shopify a jen tehdy, když udělíte přístup Zapisovatelné.

Ladění jednotlivých typů API

Zde je, jak vypadá skutečná ladicí relace pro každý typ připojení. Zadání jsou v běžné češtině - volání nástrojů v kurzívě jsou to, co Claude spouští na pozadí.

GraphQL

Flexibilita GraphQL je zároveň tím, co ztěžuje jeho ladění: dotaz tiše vrátí null a vy jen hádáte, zda je to schématem, argumenty nebo daty. Nechte Claude, ať schéma projde za vás.

Vy: V mém připojení GraphQL vypiš dostupné entity, ukaž mi schéma orders, poté najdi všechny objednávky, kde je total null, a řekni mi, co mají společného.

Claude spustí list_entities, aby objevil pohledy, get_schema na orders, aby potvrdil pole a typy, poté query_rows, aby vytáhl problematické záznamy - a nad výsledkem uvažuje, aby odhalil vzorec (například že všem chybí související uzel payment).

oData - Business Central

Microsoft Dynamics 365 Business Central zpřístupňuje svá data jako službu oData V4, se kterou DbGate Central zachází jako s běžnou sadou tabulek. Díky tomu jsou data ERP - zákazníci, faktury, položky knihy - dotazovatelná běžným jazykem.

Vy: V mém připojení Business Central najdi prodejní faktury pro zákazníka „Contoso“ z minulého měsíce a sečti jejich částky.

Claude použije query_rows a přeloží váš požadavek na dotazovací možnosti oData v pozadí - $filter pro zúžení na zákazníka a časové období, $select pro výběr sloupců a $top/$skip pro stránkování - a poté vám výsledky sečte.

Shopify

U obchodu Shopify se DbGate Central připojuje přes Shopify Admin API a zpřístupňuje produkty, objednávky, zákazníky, metafields a další.

Vy: Najdi objednávku #1043 a řekni mi, proč její vyřízení uvízlo.

Claude spustí query_rows proti vašemu připojení Shopify, aby objednávku vyhledal a zkontroloval stav jejího vyřízení a jednotlivých položek.

Pokud - a jen pokud - jste udělili přístup Zapisovatelné, může Claude provést i opravu:

Vy: Přidej k té objednávce štítek needs-review.

Claude použije update_rows, který je dostupný pouze pro Shopify a vyžaduje přístup Zapisovatelné. Najde záznam podle cíle a hodnoty shody a poté aplikuje vaši aktualizaci. U připojení jen pro čtení tento nástroj jednoduše není dostupný, takže agent nikdy nemůže změnit data, která jste nezamýšleli zpřístupnit.

Zůstáváte pod kontrolou

MCP server je postaven tak, aby sdílení vašeho pracovního prostoru s AI asistentem nikdy neznamenalo vzdání se kontroly:

Ve výchozím stavu se nesdílí nic - každé připojení začíná na Žádný přístup.
Oprávnění pro jednotlivá připojení - přesně vy rozhodujete, která připojení jsou jen pro čtení a která zapisovatelná, pro každý MCP profil.
Zápisy jsou dobrovolné a úzce vymezené - update_rows existuje pouze pro Shopify a jen s přístupem Zapisovatelné.
Bezpečné již od návrhu - autentizace používá OAuth 2.1 s PKCE a client secrets jsou šifrovány v klidovém stavu.
Nikdy víc než vy - agent používá stejný engine jako mřížka, takže vidí přesně ta data a možnosti jako vy.

Závěr

S MCP profilem DbGate Central a vlastním konektorem v claude.ai se Claude stává praktickým partnerem pro ladění vašich API GraphQL, Business Central (oData) a Shopify - kontroluje schémata, spouští dotazy a tam, kde mu to dovolíte, aplikuje opravy. Nastavte to jednou, udělte jen to, co potřebujete, a začněte otázky pokládat místo toho, abyste je psali.