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é skladanie dopytov len preto, aby ste zodpovedali jednoduchú otázku ako „prečo je toto pole null?“ alebo „ktorá objednávka je zaseknutá?“. Čo keby ste sa mohli jednoducho spýtať?

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

Tento návod 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?

Pretože čítanie aj zápis používajú rovnaký engine ako mriežka v DbGate Central, Claude vidí presne tie isté dáta a možnosti ako vy – nikdy viac, než aký prístup mu udelíte. Vďaka tomu je prirodzeným partnerom 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é.“
„Ktorá objednávka nemá vybavenie (fulfillment) a prečo?“

Problém opíšete bežným jazykom; Claude preskúma schému, spustí dopyty a premýšľa nad výsledkami – bez toho, aby ste museli opustiť konverzáciu.

Čo budete potrebovať

DbGate Central workspace s už pridanými pripojeniami, ktoré chcete ladiť – GraphQL endpoint, oData endpoint (ako príklad použijeme Microsoft Dynamics 365 Business Central) a/alebo Shopify obchod. Ak ste ich ešte nepridali, pozrite si Connect to API endpoints.
Claude účet, ktorý podporuje custom connectors (vlastné konektory).

Krok 1 – Vytvorte MCP profil v DbGate Central

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

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

Všetky tri skopírujte. Každý workspace môže mať viacero MCP profilov, každý s vlastnou URL, prihlasovacími údajmi a oprávneniami na úrovni pripojení – takže môžete poskytovať úzko zameraný prístup (napríklad profil, ktorý vidí iba jedno pripojenie v režime len na čítanie).

Krok 2 – Pridajte vlastný konektor v claude.ai

V claude.ai pridajte custom connector pomocou Server URL z predchádzajúceho kroku spolu s Client ID a Client Secret ako OAuth prihlasovacími údajmi.

Claude potom spustí handshake OAuth 2.1 with PKCE: budete požiadaní, aby ste sa prihlásili do DbGate a udelili súhlas, čím sa konektor naviaže na konkrétny MCP profil a workspace. Client secrets sú šifrované v pokoji (at rest) a nič z vašich dát sa nezdieľa, kým tento krok nedokončíte.

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

Krok 3 – Udeľte prístup na úrovni pripojení

Predvolene má MCP profil ku všetkému No access – takže samotné pripojenie profilu ešte nič nezdieľa. Pre každé pripojenie, ku ktorému chcete, aby sa Claude dostal, otvorte jeho editor a nastavte úroveň MCP access:

No access (predvolené) – pripojenie je pre agenta neviditeľné.
Read-only – agent môže vypisovať, prezerať a dopytovať, ale nič meniť.
Writable – agent môže tiež aktualizovať riadky (iba Shopify, pozri nižšie).

Rozumný východiskový bod pre ladenie je Read-only pre vaše GraphQL a Business Central pripojenia a Writable pre Shopify iba vtedy, ak skutočne chcete, aby Claude robil zmeny.

Čo Claude dokáže

Keď je pripojenie zdieľané, Claude získa tieto nástroje pre oData, GraphQL a Shopify pripojenia:

List connections – pripojenia, ktoré tento profil smie používať.
List entities – tabuľky, pohľady alebo katalógové entity.
Inspect the schema – názvy a typy stĺpcov.
Query rows – filtrovanie, stránkovanie a výber dát.
Update rows – iba Shopify a len vtedy, keď udelíte prístup Writable.

Ladenie jednotlivých typov API

Takto vyzerá reálne ladenie pre každý typ pripojenia. Prompt je v bežnej angličtine – volania nástrojov v kurzíve sú to, čo Claude spúšťa na pozadí.

GraphQL

Flexibilita GraphQL je zároveň dôvod, prečo sa ťažko ladí: dopyt potichu vráti null a vy hádate, či je problém v schéme, argumentoch alebo dátach. Nechajte schému prejsť Claude.

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

Claude spustí list_entities, aby zistil dostupné pohľady, get_schema na orders, aby si overil polia a typy, potom query_rows, aby vytiahol problematické záznamy – a nad výsledkom hľadá vzor (napríklad že všetkým chýba súvisiaci payment uzol).

oData – Business Central

Microsoft Dynamics 365 Business Central sprístupňuje svoje dáta ako oData V4 službu, ktorú DbGate Central spracúva ako bežnú sadu tabuliek. Vďaka tomu sú ERP dáta – zákazníci, faktúry, účtovné zápisy – dopytovateľné bežným jazykom.

Vy: V mojom Business Central pripojení 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 váš požiadavok preloží do oData query options – $filter na obmedzenie na zákazníka a dátumové obdobie, $select na výber stĺpcov a $top/$skip na stránkovanie – a potom výsledky za vás sčíta.

Shopify

Pre Shopify obchod 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 fulfillment zaseknutý.

Claude spustí query_rows nad vaším Shopify pripojením, aby našiel objednávku a prezrel jej fulfillment a stav položiek.

Ak – a len vtedy – keď ste udelili prístup Writable, môže Claude urobiť aj nápravu:

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

Claude použije update_rows, ktorý je dostupný iba pre Shopify a vyžaduje Writable prístup. Nájde záznam podľa cieľa a hodnoty zhody a potom aplikuje vašu zmenu. Na pripojeniach v režime Read-only tento nástroj jednoducho neexistuje, takže agent nikdy nemôže meniť dáta, ktoré ste nechceli sprístupniť.

Kontrola zostáva u vás

MCP server je navrhnutý tak, aby zdieľanie vášho workspace s AI asistentom nikdy neznamenalo vzdanie sa kontroly:

Nič sa nezdieľa predvolene – každé pripojenie začína s No access.
Oprávnenia na úrovni pripojení – presne určíte, ktoré pripojenia sú Read-only a ktoré Writable, pre každý MCP profil.
Zápisy sú dobrovoľné a úzke – update_rows existuje iba pre Shopify a iba s Writable prístupom.
Bezpečné už z návrhu – autentifikácia používa OAuth 2.1 with 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 isté dáta a možnosti ako vy.

Záver

S MCP profilom v DbGate Central a vlastným konektorom v claude.ai sa Claude stáva praktickým partnerom pri ladení vašich GraphQL, Business Central (oData) a Shopify API – prehliada schémy, spúšťa dopyty a tam, kde to dovolíte, aplikuje opravy. Nastavte to raz, udeľte len potrebné oprávnenia a začnite sa pýtať namiesto toho, aby ste písali dopyty.