Jak používat Claude pro 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í vytváření dotazů jen proto, abyste zodpověděli jednoduchou otázku jako „proč je tohle pole null?“ nebo „která objednávka je zaseknutá?“. Co kdybyste se prostě mohli jen zeptat?

DbGate Central obsahuje vestavěný server MCP (Model Context Protocol), 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ým způsobem 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 pár minut nastavit a pak použít Claude k ladění všech tří typů připojení.

Otevřít DbGate Central →

Proč ladit API pomocí Claude?

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

„Jak vlastně vypadá schéma této entity?“
„Najdi záznamy, kde je tohle pole null, a ukaž mi, co mají společného.“
„Která objednávka postrádá fulfillment a proč?“

Problém popíšete běžným jazykem; Claude introspektuje schéma, spustí dotazy a vyhodnotí výsledky – aniž byste museli opustit konverzaci.

Co budete potřebovat

DbGate Central workspace s připojeními, která chcete ladit – GraphQL endpoint, oData endpoint (jako příklad použijeme Microsoft Dynamics 365 Business Central) a/nebo Shopify obchod. Pokud je ještě nemáte přidané, podívejte se na Připojení k API endpointům.
Účet Claude, který podporuje vlastní konektory.

Krok 1 – Vytvořte MCP profil v DbGate Central

Otevřete záložku Settings (ikona ozubeného kola dole v panelu aktivit) a vytvořte nový MCP profil. Profil vám poskytne tři hodnoty, které budete za chvíli potřebovat:

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

Všechny tři zkopírujte. Každý workspace může mít více MCP profilů, každý s vlastní URL, přihlašovacími údaji a oprávněními k jednotlivým připojením – takže můžete předávat úzce vymezený přístup (například profil, který vidí jen jedno připojení v režimu pouze pro čtení).

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

V claude.ai přidejte custom connector s použitím Server URL z předchozího kroku spolu s Client ID a Client Secret jako OAuth přihlašovacími údaji.

Claude poté provede handshake OAuth 2.1 s PKCE: budete vyzváni k přihlášení do DbGate a udělení souhlasu, čímž se konektor sváže s daným MCP profilem a workspace. Client secrety jsou šifrované v klidu a dokud tento krok nedokončíte, nic z vašich dat se nesdílí.

Konfigurace vlastního konektoru DbGate Central v 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 stavu má MCP profil ke všemu No access – samotné připojení profilu tedy nic nesdílí. U každého připojení, ke kterému chcete Claude pustit, otevřete jeho editor a nastavte úroveň MCP access:

No access (výchozí) – připojení je pro agenta neviditelné.
Read-only – agent může vypisovat, prohlížet a dotazovat, ale nic nemůže měnit.
Writable – agent může také aktualizovat řádky (pouze Shopify, viz níže).

Rozumný výchozí bod pro ladění je Read-only pro vaše GraphQL a Business Central připojení a Writable pro Shopify jen tehdy, pokud opravdu chcete, aby Claude mohl provádět změny.

Co Claude umí

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

List connections – připojení, která tento profil smí používat.
List entities – tabulky, pohledy nebo katalogové entity.
Inspect the schema – názvy a typy sloupců.
Query rows – filtrování, stránkování a výběr dat.
Update rows – pouze Shopify a jen tehdy, když udělíte přístup Writable.

Ladění jednotlivých typů API

Takto vypadá reálné ladicí sezení pro každý typ připojení. Prompty jsou v běžné angličtině – volání nástrojů kurzívou jsou to, co Claude spouští na pozadí.

GraphQL

Flexibilita GraphQL je zároveň to, co ztěžuje ladění: dotaz tiše vrátí null a vy tápete, jestli je problém ve schématu, argumentech nebo datech. Nechte schéma projít Claude.

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

Claude spustí list_entities, aby zjistil dostupné pohledy, get_schema nad orders, aby ověřil pole a typy, a poté query_rows, aby načetl problematické záznamy – a nad výsledkem se zamyslí, aby našel 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 oData V4 službu, kterou DbGate Central bere jako běžnou sadu tabulek. Díky tomu jsou ERP data – zákazníci, faktury, účetní zápisy – dotazovatelná běžným jazykem.

Vy: V mém Business Central připojení 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 váš požadavek přeloží na oData query options na pozadí – $filter pro omezení na zákazníka a časové období, $select pro výběr sloupců a $top/$skip pro stránkování – a pak za vás částky sečte.

Shopify

Pro Shopify obchod 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č je její fulfillment zaseknutý.

Claude spustí query_rows nad vaším Shopify připojením, aby objednávku našel a zkontroloval její fulfillment a stav položek.

Pokud – a pouze pokud – jste udělili přístup Writable, může Claude provést i nápravu:

Vy: Přidej k té objednávce tag needs-review.

Claude použije update_rows, který je k dispozici pouze pro Shopify a vyžaduje Writable přístup. Najde záznam podle cíle a hodnoty pro shodu a pak aplikuje vaši změnu. U připojení v režimu Read-only tento nástroj vůbec není k dispozici, takže agent nikdy nemůže měnit data, která jste nechtěli zpřístupnit.

Kontrolu máte vy

MCP server je navržen tak, aby sdílení vašeho workspace s AI asistentem nikdy neznamenalo ztrátu kontroly:

Nic se nesdílí ve výchozím stavu – každé připojení začíná s No access.
Oprávnění pro jednotlivá připojení – přesně určíte, která připojení jsou Read-only a která Writable, pro každý MCP profil zvlášť.
Zápisy jsou dobrovolné a úzce vymezené – update_rows existuje jen pro Shopify a jen s Writable přístupem.
Bezpečné už z principu – autentizace používá OAuth 2.1 s PKCE a client secrety jsou šifrované v klidu.
Nikdy víc než vy – agent používá stejný engine jako mřížka, takže vidí přesně ta data a možnosti, které vidíte vy.

Závěr

S MCP profilem v DbGate Central a vlastním konektorem v claude.ai se z Claude stane praktický partner pro ladění vašich GraphQL, Business Central (oData) a Shopify API – pro inspekci schémat, spouštění dotazů a tam, kde to dovolíte, i pro aplikaci oprav. Nastavte to jednou, udělte jen nezbytná oprávnění a začněte se ptát místo toho, abyste dotazy psali.