Važnost izrade API-a kao temelja za agentic sustave (MCP)

Godinama smo tvrdili da je dobro izgrađen API preduvjet za svaki moderan softverski sustav. Integracije, mobilne aplikacije, dashboardi — sve to ovisi o čistom sučelju prema podacima i logici. Danas postoji još jedan, možda i važniji razlog: AI agenti.

Agentic AI sustavi — softver koji ne samo odgovara na pitanja nego samostalno izvršava zadatke — postaju stvarnost u poslovnom softveru. I oni trebaju isto što i svaki drugi klijent: jasan, siguran, predvidljiv API. Sustavi koji ga nemaju, za AI agente su zatvorene kutije.

Što je Model Context Protocol (MCP)?

MCP je otvoreni standard koji definira kako AI agenti komuniciraju s vanjskim alatima i sustavima. Umjesto da svaki agent mora znati poseban način spajanja na svaki sustav, MCP standardizira taj protokol — jednako kao što HTTP standardizira komunikaciju između preglednika i web servera.

Svaki sustav koji izlaže MCP sučelje postaje alat kojeg AI agent može koristiti. Može čitati podatke, pokretati akcije, dohvaćati kontekst. Sve to bez ljudskog posrednika u petlji.

Svaki MCP server u biti je omotač oko postojećeg API-a. Ako API postoji — izlaganje kroz MCP je relativno brz posao. Ako API ne postoji, nema prečaca.

Zašto sustav bez API-a nije spreman za budućnost

Legacy sustavi su često izgrađeni kao monoliti — sve je unutra, ništa nije izloženo van. Baza podataka se čita direktno, poslovna logika je zakopana u aplikacijskom kodu, nema standardiziranog sučelja prema vanjskom svijetu.

Ovo nije teorijska budućnost. Tvrtke već danas postavljaju interne AI agente koji automatiziraju rutinske zadatke — generiranje izvještaja, obrada zahtjeva, provjera statusa narudžbi, eskalacija problema. Sve to funkcionira samo ako sustavi imaju API.

API kao arhitekturni temelj, ne kao dodatak

Čest pogrešan pristup kod modernizacije je tretirati API kao feature koji se dodaje na kraju. "Napravimo sustav, pa ćemo izložiti API ako zatreba." To je recept za probleme.

API-first pristup znači da se arhitektura sustava dizajnira oko jasnog, dobro definiranog sučelja od samog početka. Poslovna logika je iza tog sučelja, a sve — web aplikacija, mobilna aplikacija, integracije, i sutra AI agent — komunicira s njom na isti, standardiziran način.

Ovdje se savršeno uklapa Clean Architecture jezgra: kad je poslovna logika izolirana i neovisna, izlaganje kroz API je prirodan sljedeći korak. Isti use case koji poziva web sučelje može pozvati i AI agent — jer je sučelje standardizirano, a logika nije razasuta po sustavu.

Modernizacija danas = AI-readiness sutra

Modernizacija legacy sustava oduvijek je imala jasne poslovne razloge: niži troškovi održavanja, bolji performance, manji rizik. Ali sada postoji i strateški razlog koji nije bio dostupan prije tri godine.

Tvrtke koje danas grade sustave s čistim API slojevima, Clean Architecture jezgrom i Repository Patternom — one sutra mogu relativno brzo postaviti MCP server i uvesti AI agente u svakodnevne operacije. Tvrtke čiji sustavi nemaju API morat će to riješiti kao preduvjet, a to je dugotrajan i skup posao.

Pitanje više nije "trebamo li API?" — pitanje je "koliko dugo si možemo priuštiti da ga nemamo?"

U Butterfly Designu, svaki modernizacijski projekt gradimo s API-jem kao prvom klasom, ne kao naknadnom pomišlju. Ne zato što je to moderno, nego zato što znamo što dolazi.