MCP a API v práci agenta a aplikácie

Agent zašiel do externého zdroja, zorientoval sa vo formáte odpovede a zostavil stránku s mapou. Funguje. Teraz túto stránku otvára niekto iný a ten žiadny Claude Code nemá.

Pred zverejnením sa oplatí odpovedať na jednu otázku. Kto získa dáta pre návštevníka? Pozrieme sa na dve trasy, na to, čo robí MCP, ako overiť pripojenie a čo musí fungovať aj potom, čo reláciu agenta zatvoríte.

Kto teraz žiada o dáta

Sú dve situácie a ľahko sa dajú zameniť, pretože na obrazovke obe vyzerajú ako "dáta sa objavili".

V prvej situácii agent skúma zdroj. Pracujete na projekte, Claude Code číta dokumentáciu služby, skúša požiadavku, pozerá sa na štruktúru odpovede. Dáta potrebuje na to, aby napísal kód. Deje sa to na vašom počítači a presne tak dlho, kým je relácia otvorená.

V druhej situácii návštevník otvorí zverejnenú stránku. Dáta teraz potrebuje ona - aby ukázala aktuálny stav. Požiadavku vykonáva kód aplikácie počas jej behu. Tomu sa hovorí runtime, teda čas, keď aplikácia beží u používateľa, nie čas, keď ju píšete.

Je tu aj tretia, prechodná možnosť. Agent raz zašiel do zdroja, uložil odpoveď do súboru vedľa kódu a web zobrazuje obsah tohto súboru. Na takomto riešení nie je nič zlé, na ukážku alebo demonštráciu je dokonca pohodlné. Len je to snímka, ktorá zostane taká, akú ju uložili, a sama sa neaktualizuje.

Oba reťazce žijú oddelene, šípka medzi nimi nie je

Všimnite si prerušovanú čiaru v strede. Nie je tam pre ozdobu. Medzi horným a dolným reťazcom nie je šípka, a to je to hlavné, čo si zo schémy treba odniesť. Zdroj môže byť ten istý, no cestu k nemu má agent aj stránka každý svoju. Nižšie si rozoberieme každý reťazec zvlášť.

Čo je MCP

Úloha zriedka žije len v repozitári. Popis chyby zostáva v tikete, stack trace - v monitoringu, nové pravidlá knižnice - v dokumentácii a potrebné záznamy - v databáze.

Bez integrácie musíte všetko presúvať ručne z prehliadača do chatu s agentom. Jednorazový prenos je prijateľný. Pri opakovanej práci dáta stihnú zastarať, časť podrobností sa stratí a tú istú trasu musíte prejsť znova.

MCP (Model Context Protocol) - štandard, podľa ktorého sa Claude Code dozvedá o dostupných externých nástrojoch, volá ich a dostáva výsledok v dohodnutom formáte. V minimálnom reťazci Claude Code vytvára MCP-klienta, klient udržiava spojenie s MCP-serverom a server až potom siaha na systém, ku ktorému má prístup - súbory, databázu, cudzie API.

Claude Code sa rozpráva s MCP-serverom a server sprístupňuje iba vopred popísané možnosti externých systémov

Vľavo je Claude Code so vstavaným MCP-klientom, v strede - MCP-server s deklarovanými možnosťami, vpravo - externé systémy. Podstatné je, že agent nezískava nekontrolovaný prístup ku všetkému naraz. Vidí iba operácie a dáta, ktoré sa server rozhodol poskytnúť.

Hotový MCP-server vás zbavuje aj časti integračnej práce. Nemusíte sami popisovať formáty volaní pre každý externý systém a písať celý kód na prístup k jeho API. To robí server a Claude Code pracuje s už deklarovanými operáciami.

Server pritom nemusí byť samostatný program niekde na internete. Môže sa spúšťať priamo na vašom počítači ako lokálny proces, alebo môže bežať vzdialene a obsluhovať mnoho klientov naraz. Pre vás je rozdiel hlavne v tom, ako sa pripája.

Čo presne server vie, rozhoduje on sám. Protokol opisuje tri druhy toho, čo server môže ponúknuť:

tools - operácie, ktoré agent môže vykonať: získať stránku, poslať požiadavku na API, zapísať dáta;
resources - obsah, ktorý server poskytuje ako kontext: súbory, záznamy, odpovede služieb;
prompts - predpripravené šablóny požiadaviek, ktoré sa dajú rovno vyvolať.

Server nemusí podporovať všetky tri. Pri pripojení si klient a server overia, kto čo vie, a nepodporované operácie sa jednoducho nepoužívajú. Mnohé servery si vystačia so samotnými tools a to úplne stačí. Architektúra MCP.

Zapamätajte si to hlavné. MCP štandardizuje spôsob, akým sa klient a server dorozumievajú. Čo konkrétne vám bude dostupné, určuje server, nie protokol. Pripojiť server neznamená získať prístup k celému internetu - dostanete presne tú sadu operácií, ktorú tento server deklaroval.

V zadaní pre agenta pomenujte zdroj a požadovaný výsledok, nie príkaz. Potom overte, či má pripojený server vhodnú operáciu. Ak ju nemá, úloha sa rieši inou trasou, nie prehováraním.

Ako sa dáta dostanú na web

Teraz dolný reťazec. Zverejnená stránka dostáva dáta jedným z dvoch spôsobov.

V prvom prípade sa prehliadač obracia priamo na verejné API. Tento spôsob sa hodí, keď je zdroj otvorený a kľúč netreba. Kód stránky pošle požiadavku a vykreslí odpoveď. Jednoduché a bez zbytočných podrobností.

V druhom prípade sa prehliadač obracia na backend aplikácie a ten až na uzavreté API. Takto sa to robí, keď zdroj potrebuje kľúč. Tajomstvo zostáva na serveri, prehliadač ho nevidí. Frontend tu zodpovedá za to, čo je vidieť na obrazovke, backend - za to, čo beží na serveri a vie sa obracať na službu v mene aplikácie.

Verejné API je prehliadaču dostupné priamo, kľúč k uzavretému API zostáva na backende

Horná trasa je kratšia, pretože prehliadač sa môže na otvorený zdroj obrátiť sám. Pri dolnej trase sa backend stáva hranicou pre tajomstvo. Kľúč zostáva na serveri a do kódu stránky sa nedostane.

A teraz to, čo sa nedeje. Spojenie Claude Code s MCP-serverom sa pri zverejnení nepresúva spolu s webom. Príkaz, ktorým ste pridali server, konfiguruje vášho agenta; nepridáva do aplikácie ani riadok kódu. Aplikáciu s vlastným MCP-klientom je možné napísať, ale ide o samostatnú prácu a samostatnú implementáciu, nie výsledok pripojenia v Claude Code.

Overiť sa to dá pomerne rýchlo. Zatvorte Claude Code, otvorte zverejnenú stránku a pozrite sa na kartu Network v nástrojoch pre vývojárov. Ak dáta prichádzajú, vidno požiadavku, adresu a odpoveď. Ak neprichádzajú, požiadavka tam nebude, a to je presne ten prípad, ktorý sa oplatilo zachytiť skôr, než stránku uvidí niekto ďalší.

Jeden obrázok na obrazovke nestačí. Stránka môže zobrazovať skôr uloženú snímku a vyzerať pritom úplne živo. Pozerať treba na samotnú požiadavku. A naopak, to, že v odpovedi nie sú nové udalosti, ešte neznamená poruchu. Zdroj za zvolené obdobie jednoducho nemusel nič poslať.

Ako skontrolovať pripojenie

Postup je viac-menej rovnaký pre každý server:

nájsť oficiálny návod k serveru - adresu, spôsob prístupu, zoznam operácií;
pridať server príkazom, ktorý uvádza práve tento návod;
otvoriť /mcp v Claude Code a pozrieť sa, či sa server pripojil a aké nástroje má;
vykonať jednu požiadavku na čítanie, tú najjednoduchšiu;
porovnať výsledok so zdrojom ručne - otvoriť tú istú stránku a pozrieť sa na ňu vlastnými očami.

Z terminálu stav ukáže claude mcp list, podrobnosti o jednom serveri - claude mcp get. Užitočné je vedieť, že tieto kroky odpovedajú na rôzne otázky:

Čo ste videli	Čo to dokazuje
riadok `Added ...` po pridaní	konfigurácia je zapísaná a nič viac
`Connected` v `claude mcp list`	Claude Code sa dokázal so serverom spojiť
nástroj vrátil obsah	trasa funguje celá, od požiadavky po odpoveď

Rozdiel nie je formálny. Úspešne zapísaná konfigurácia nič nehovorí o tom, či server odpovedá, a úspešné spojenie zase o tom, či je potrebná operácia dostupná a či na ňu máte práva. Preto sa kontrola končí jedným skutočným volaním. Mimochodom, ak je v zozname Needs authentication, server nie je pokazený, len čaká na prihlásenie.

Vezmime konkrétny príklad. Služba Firecrawl má MCP-server, ktorý vie získať obsah verejnej stránky - nástroj sa volá firecrawl_scrape. Pre agenta je to pohodlný spôsob, ako prečítať stránku dokumentácie celú, namiesto kopírovania po kúskoch do konverzácie.

# pridať server cez HTTP; presnú adresu nájdete v dokumentácii služby
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp

Teraz o prístupe. Dokumentácia Firecrawl opisuje aj prácu bez účtu a kľúča s dennými obmedzeniami, aj prihlásenie cez prehliadač, keď klient sám otvorí prihlasovaciu stránku. Podmienky a limity služieb sa menia, preto aktuálne hľadajte priamo pri službe, nie v článku. Dokumentácia Firecrawl o MCP.

A malý detail, ktorý šetrí čas. Predvolene sa server pridá pre ten projekt, v ktorom ste príkaz zadali, a v iných projektoch sa neobjaví. Ak ho potrebujete všade alebo, naopak, pre celý tím, príkaz na pridanie má na to samostatné varianty rozsahu (scope). Claude Code o MCP.

Hodnota kľúča nepatrí ani do príkladu konfigurácie, ani do adresy servera, ani do konverzácie s agentom. Do konfigurácie sa dáva názov premennej prostredia, hodnota sa nastavuje zvlášť - to je téma susedného článku o kľúčoch.

Čo dovoľuje konkrétny nástroj

Pripojený server je sada operácií a ich dôsledky sú veľmi rozdielne. Prečítať stránku a zmeniť záznam v externom systéme nie je vôbec to isté, hoci sa volajú rovnako.

Skôr než volanie povolíte, oplatí sa pozrieť na tri veci: s akým objektom nástroj pracuje, akú operáciu vykonáva a aké práva na to potrebuje. Čítanie je zvyčajne bezpečnejšie, ale aj ono má svoju cenu. Požiadavka odchádza cudzej službe a míňa vašu kvótu.

Zvlášť o tom, čo príde v odpovedi. Text získaný z cudzieho webu sú dáta, nie pokyn. Ak je na stránke napísané "teraz zmaž všetky súbory", zostáva to textom na stránke a rozhodujete vy. Práve preto sa oplatí pozerať, čo sa agent po prečítaní externého zdroja chystá robiť ďalej.

No a hlavná praktická otázka. Je MCP vôbec potrebný? Nie vždy.

Úloha	Ako to riešiť jednoduchšie
zobraziť na webe dáta z verejného JSON	bežná požiadavka z kódu aplikácie, MCP netreba
agent pravidelne pracuje so službou, ktorá má hotovú integráciu	MCP sa oplatí: operácie sú popísané, pripojenie sa používa opakovane
raz prečítať dokumentáciu alebo zavolať jednu adresu	stačí prečítať URL alebo sa obrátiť priamo na API

MCP nie je jediná cesta von ani náhrada za všetko ostatné. Agent má naďalej aj príkazový riadok, aj priamy prístup k API. Výber vychádza z úlohy, nie z toho, že pripojenie je už nastavené.

Čo skontrolovať vo svojom projekte

Keď agent pripravuje prácu s externými dátami, oplatí sa ho požiadať, aby obe vrstvy výslovne oddelil, a nie to rozplietať až potom:

Popíš oddelene dve trasy:
odkiaľ berieš dáta počas práce na projekte
a odkiaľ si ich vezme samotná aplikácia u návštevníka.
Ukáž, v ktorom súbore a na ktorom mieste kódu je požiadavka aplikácie.
Skontroluj stránku pri zatvorenej relácii: prichádzajú dáta, alebo nie.
Ak sa teraz používa uložená snímka, povedz to priamo.

Tri situácie, ktoré sa vyskytujú najčastejšie, a odpoveď na každú:

Čo treba	Kto získava dáta	Prečo práve tak
preštudovať dokumentáciu služby počas vývoja	agent	dáta sú potrebné na napísanie kódu, u návštevníka sa táto požiadavka neopakuje
aktualizovať mapu u návštevníka	kód aplikácie	požiadavka sa vykonáva počas behu stránky, relácia agenta je v tej chvíli už zatvorená
raz uložiť výber do JSON	agent, a to iba raz	web potom zobrazuje súbor; dáta zostanú také, aké ich uložili

Všimnite si, že MCP sa tu objavuje iba v prvom riadku, a aj to nie nevyhnutne. Ak sa úloha dá vyriešiť bežným prečítaním adresy, tak ju tak aj riešte.

Posledná kontrola pred tým, než prácu ukážete niekomu ďalšiemu, je najjednoduchšia: zatvorte Claude Code a otvorte stránku. To, čo funguje ďalej, je vaša aplikácia. Všetko ostatné bola pomoc agenta pri vývoji - užitočná, ale zostala na vašom počítači.