Ako používať Claude na ladenie vašich API

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

Ladenie API zvyčajne znamená žonglovanie s Postman kolekciami, písanie jednorazových skriptov alebo ručné vytváranie dopytov len na to, aby ste si odpovedali na jednoduchú otázku ako “prečo je toto pole null?” alebo “ktorá objednávka zasekla?”. Čo keby ste sa mohli jednoducho opýtať?

DbGate Central obsahuje vstavaný MCP (Model Context Protocol) server, ktorý sprístupňuje vaše API pripojenia pre AI asistentov ako Claude. Po pripojení môže Claude preskúmavať a dopytovať vaše živé pripojenia GraphQL, Business Central (oData) a Shopify rovnako ako vy - priamo z chatu, s prístupom, ktorý zostáva pod vašou kontrolou.

Táto príručka vám ukáže, ako to nastaviť za pár minút a potom použiť Claude na ladenie všetkých troch.

Otvoriť DbGate Central →

Prečo ladiť API pomocou Claude?

Keďže čítanie a zápisy využívajú rovnaký engine ako mriežka DbGate Central, Claude vidí presne tie isté dáta a možnosti ako vy - nikdy viac než prístup, ktorý udelíte. To z neho robí prirodzeného spoločníka pri ladení:

“Ako vlastne vyzerá schéma tejto entity?”
“Nájdi záznamy, kde je toto pole null, a ukáž mi, čo majú spoločné.”
“Ktorej objednávke chýba plnenie a prečo?”

Problém opíšete v bežnom jazyku; Claude preskúma schému, spustí dopyty a uvažuje nad výsledkami - bez toho, aby ste opustili konverzáciu.

Čo budete potrebovať

Pracovný priestor DbGate Central s už pridanými pripojeniami, ktoré chcete ladiť - GraphQL endpoint, oData endpoint (ako príklad použijeme Microsoft Dynamics 365 Business Central) a/alebo obchod Shopify. Pozrite si Pripojenie k API endpointom, ak ste ich ešte nepridali.
Účet Claude, ktorý podporuje vlastné konektory.

Krok 1 - Vytvorte MCP profil v DbGate Central

Otvorte kartu Nastavenia (ikona ozubeného kolieska v spodnej časti panela aktivít) a vytvorte nový MCP profil. Profil vám poskytne tri hodnoty, ktoré budete o chvíľu potrebovať:

URL servera - vo formáte https://central.dbgate.cloud/mcp/{profileId}
Client ID
Client Secret

Skopírujte všetky tri. Každý pracovný priestor môže mať viacero MCP profilov, každý s vlastnou URL, prihlasovacími údajmi a oprávneniami pre jednotlivé pripojenia - takže môžete udeliť úzko vymedzený prístup (napríklad profil, ktorý vidí len jedno pripojenie iba na čítanie).

Krok 2 - Pridajte vlastný konektor v claude.ai

V claude.ai pridajte vlastný konektor pomocou URL servera z predchádzajúceho kroku spolu s Client ID a Client Secret ako OAuth prihlasovacími údajmi.

Claude potom vykoná handshake OAuth 2.1 s PKCE: budete požiadaní o prihlásenie do DbGate a udelenie súhlasu, čo naviaže konektor na daný konkrétny MCP profil a pracovný priestor. Client secrets sú šifrované v pokoji a nič o vašich dátach sa nezdieľa, kým nedokončíte tento krok.

Configuring the DbGate Central custom connector in claude.ai
Pridanie vlastného konektora DbGate Central v claude.ai

Krok 3 - Udeľte prístup pre jednotlivé pripojenia

V predvolenom nastavení má MCP profil Žiadny prístup ku všetkému - takže samotné pripojenie profilu nezdieľa nič. Pre každé pripojenie, ku ktorému má mať Claude prístup, otvorte jeho editor a nastavte úroveň MCP prístupu:

Žiadny prístup (predvolené) - pripojenie je pre agenta neviditeľné.
Iba na čítanie - agent môže vypisovať, kontrolovať a dopytovať, ale nemôže nič meniť.
Zapisovateľné - agent môže tiež aktualizovať riadky (iba Shopify, pozri nižšie).

Rozumným východiskom pre ladenie je Iba na čítanie pre vaše pripojenia GraphQL a Business Central a Zapisovateľné pre Shopify iba vtedy, ak naozaj chcete, aby Claude vykonával zmeny.

Čo Claude dokáže

Po zdieľaní pripojenia získa Claude tieto nástroje pre pripojenia oData, GraphQL a Shopify:

Vypísať pripojenia - pripojenia, ktoré tento profil môže používať.
Vypísať entity - tabuľky, pohľady alebo katalógové entity.
Skontrolovať schému - názvy a typy stĺpcov.
Dopytovať riadky - filtrovať, stránkovať a vyberať dáta.
Aktualizovať riadky - iba Shopify a iba keď udelíte prístup Zapisovateľné.

Ladenie jednotlivých typov API

Takto vyzerá reálna relácia ladenia pre každý typ pripojenia. Výzvy sú v bežnej angličtine - volania nástrojov v kurzíve sú to, čo Claude spúšťa v zákulisí.

GraphQL

Flexibilita GraphQL je aj tým, čo sťažuje jeho ladenie: dopyt potichu vráti null a vy hádate, či ide o schému, argumenty alebo dáta. Nechajte Claude prejsť schému za vás.

Vy: V mojom GraphQL pripojení vypíš dostupné entity, ukáž mi schému orders, potom nájdi objednávky, kde je total null, a povedz mi, čo majú spoločné.

Claude spustí list_entities, aby objavil pohľady, get_schema na orders, aby potvrdil polia a typy, potom query_rows, aby vytiahol problematické záznamy - a uvažuje nad výsledkom, aby odhalil vzor (napríklad všetkým chýba súvisiaci uzol payment).

oData - Business Central

Microsoft Dynamics 365 Business Central sprístupňuje svoje dáta ako službu oData V4, ktorú DbGate Central spracúva ako obyčajnú sadu tabuliek. Vďaka tomu sú dáta ERP - zákazníci, faktúry, účtovné položky - dopytovateľné v bežnom jazyku.

Vy: V mojom pripojení Business Central nájdi predajné faktúry pre zákazníka “Contoso” z minulého mesiaca a spočítaj ich sumy.

Claude použije query_rows a preloží vašu požiadavku na možnosti oData dopytu v zákulisí - $filter na zúženie na zákazníka a rozsah dátumov, $select na výber stĺpcov a $top/$skip na stránkovanie - potom vám výsledky sčíta.

Shopify

Pri obchode Shopify sa DbGate Central pripája cez Shopify Admin API a sprístupňuje produkty, objednávky, zákazníkov, metafields a ďalšie.

Vy: Nájdi objednávku #1043 a povedz mi, prečo je jej plnenie zaseknuté.

Claude spustí query_rows proti vášmu Shopify pripojeniu, aby lokalizoval objednávku a skontroloval stav jej plnenia a položiek.

Ak - a iba ak - ste udelili prístup Zapisovateľné, Claude môže tiež vykonať opravu:

Vy: Pridaj k tej objednávke tag needs-review.

Claude použije update_rows, ktorý je dostupný iba pre Shopify a vyžaduje prístup Zapisovateľné. Nájde záznam podľa cieľa zhody a hodnoty a potom aplikuje vašu aktualizáciu. Pri pripojeniach iba na čítanie tento nástroj jednoducho nie je dostupný, takže agent nikdy nemôže zmeniť dáta, ktoré ste nechceli sprístupniť.

Máte to pod kontrolou

MCP server je postavený tak, aby zdieľanie vášho pracovného priestoru s AI asistentom nikdy neznamenalo vzdanie sa kontroly:

V predvolenom nastavení sa nezdieľa nič - každé pripojenie začína na Žiadny prístup.
Oprávnenia pre jednotlivé pripojenia - vy rozhodujete presne o tom, ktoré pripojenia sú Iba na čítanie a ktoré Zapisovateľné, pre každý MCP profil.
Zápisy sú voliteľné a úzko vymedzené - update_rows existuje iba pre Shopify a iba s prístupom Zapisovateľné.
Bezpečné už od návrhu - autentifikácia používa OAuth 2.1 s PKCE a client secrets sú šifrované v pokoji.
Nikdy viac než vy - agent používa rovnaký engine ako mriežka, takže vidí presne tie dáta a možnosti ako vy.

Záver

S MCP profilom DbGate Central a vlastným konektorom v claude.ai sa Claude stáva praktickým partnerom pri ladení vašich API GraphQL, Business Central (oData) a Shopify - kontroluje schémy, spúšťa dopyty a tam, kde to povolíte, aplikuje opravy. Nastavte to raz, udeľte iba to, čo potrebujete, a začnite otázky klásť namiesto ich písania.