Ugrás a tartalomhoz

API és MCP

Vibe Coding · API és MCP

Amikor a szoftvered más szoftverekkel beszélget

Az API és az MCP arra való, hogy egy szoftver vagy AI-rendszer – amit te írsz vagy promptolsz – beszélgetni tudjon egy másik szoftverrel. Az API-t a programod kódja használja: előre megírt módon, egy titkos kulccsal kér valamit a másik szoftvertől. Az MCP-t az AI-ügynök használja: elkéri a lehetőségek listáját, és maga dönti el, melyikre van szüksége.

Szemléltetés
Szemléltetés

API · Application Programming Interface

Az API a szoftver kapuja a többi program felé

Egy szoftver az API-n keresztül engedi meg, hogy más programok kérjenek tőle valamit. Három dolog kell hozzá.

  • API-kulcs

    A belépőkártya

    Titkos karaktersor, amivel a másik szoftver felismeri a programodat, és engedélyt ad neki a használatra. Úgy bánj vele, mint egy jelszóval.

  • API-dokumentáció

    A használati útmutató

    Leírja, milyen programkóddal lehet kapcsolódni a szoftverhez, mit lehet kérni tőle, milyen formában, és milyen válasz érkezik vissza.

  • A kapcsolódó kód

    A te programod része

    Az a kódrészlet a programodban, ami felveszi a kapcsolatot a másik szoftverrel. Vibe Codingnál ezt a coding agent írja meg a dokumentáció alapján.

Ismert példák:OpenAI – szöveget ír, képet készítResend – e-mailt küldMailchimp – hírlevél-listát kezelStripe – bankkártyás fizetést fogad

Így működik, két fázisban

Először egyszer megteremtjük a kapcsolatot a kódból. Utána a program annyiszor hívja az API-t, ahányszor szüksége van rá.

Melyik szoftverhez kapcsolódsz?

Használat · 9 / 9

Létrejön az eredmény

A másik szoftver elvégzi a munkát: megírja az AI-választ, elküldi a levelet, felveszi a feliratkozót. Az eredményről választ küld a programodnak.

MCP · Model Context Protocol

Az MCP tolmács az AI és a szoftverek között

Az MCP server egy köztes program. Ha elkészül egy szoftver elé, az AI-ügynök rajta keresztül beszélgetni tud a szoftverrel, és működtetni tudja a saját feladatához, a részletek ismerete nélkül.

  • Köztes rendszer

    Az AI-ügynök és a célszoftver között áll. Az egyik felé az AI nyelvén beszél, a másik felé a szoftver saját nyelvén.

  • Közös szabvány

    Bármilyen szoftver elé megépíthető, és minden MCP-t ismerő AI ugyanúgy tudja használni. Nem kell minden AI-hoz külön csatlakozó.

  • Bemutatja magát

    Az MCP serveren van egy lista arról, mire és hogyan használható. Az AI ezt olvassa el, így a szoftver részleteit nem kell ismernie.

Itt is van fejlesztés és használat

Az MCP servert egyszer kell elkészíteni. Utána az AI minden alkalommal maga nézi meg, mire használhatja.

Mit használ az AI?

Használat · 10 / 10

A válasz visszaér

Az eredmény az MCP-n át visszajut az AI-ügynökhöz. Az folytatja a munkát, vagy szól neked, hogy kész.

Melyik kell neked?

Ha mindig ugyanaz kell: API. Ha az AI dönt: MCP.

A két megoldás nem verseny. Egy projektben sokszor mindkettő előfordul.

APIMCP
Ki használja?A programod kódjaAz AI-ügynök
Mikor dől el, mit kér?Fejlesztéskor: bele van írva a kódbaHasználat közben: az AI választja ki
Honnan tudja, mit lehet?A fejlesztő elolvassa a dokumentációtAz AI elkéri a szervertől a listát
Hogyan kap engedélyt?API-kulccsalBejelentkezéssel vagy kulccsal, amit egyszer állítasz be
Mire való?Állandó funkcióra a saját programodbanRugalmas feladatokra, ahol az AI dönt a lépésekről
PéldaAz űrlap elküldése után a programod mindig visszaigazoló levelet küld„Nézd meg a naptáram, és keress közös időpontot Annával”

Próbáld ki

Így használd Vibe Coding közben

Négy lépés mindkettőhöz. A kódot a coding agent írja, neked a szándékot és a hozzáférést kell megadnod.

API a programodba

  1. 1Regisztrálj a szolgáltatónálHozz létre fiókot. Ha fizetős, állíts be költési limitet is.
  2. 2Hozz létre API-kulcsotRögtön másold ki, mert sok helyen csak egyszer mutatják meg.
  3. 3Tedd a .env fájlbaA kulcs a projekt titkos fájljába kerül, nem a kódba és nem a chatbe.
  4. 4Kérd meg az agentetMondd el, mit csináljon a funkció, és add meg a dokumentáció linkjét.
Prompt a coding agentnek

Építsd be a programba a(z) [szolgáltatás neve] API-t. Mit csináljon: [pl. az űrlap elküldése után küldjön visszaigazoló e-mailt]. Dokumentáció: [link] Az API-kulcs a .env fájlban van, [KULCS_NEVE] néven. Ne írd bele a kódba, és ne kerüljön ki a böngészőbe. Készíts hibakezelést arra az esetre, ha a szolgáltatás nem elérhető, és próbáld ki egy teszthívással.

MCP az AI-eszközödbe

  1. 1Keress MCP-t a szoftverhezKeress rá: „szoftver neve + MCP”. Elsőre a szoftver gyártójának hivatalos szerverét válaszd.
  2. 2Add hozzá az AI-eszközödhözA beállítások Connectors vagy MCP részén. A coding agentet is megkérheted, hogy állítsa be.
  3. 3Jelentkezz be, adj engedélytCsak annyi jogot adj, amennyi a feladathoz kell.
  4. 4Kérd természetes nyelvenAz utasítások nevét nem kell tudnod: az AI megkeresi a listából.
Prompt az AI-nak

A csatlakoztatott [szoftver neve] MCP segítségével [a feladat leírása]. Előbb nézd meg, milyen eszközeid vannak hozzá, és mondd el, mit fogsz csinálni. Minden olyan művelet előtt kérdezz rá, ami adatot módosít, töröl vagy üzenetet küld.

A kulcs jelszó. Soha ne másold chatbe, képernyőképre vagy nyilvános helyre. Ha kikerült, töröld a szolgáltatónál, és készíts újat.

Az AI a te nevedben cselekszik. MCP-nél csak megbízható szervert használj, és a törlés, küldés vagy fizetés előtt kérj megerősítést.

Részletesebben: az API-kulcs helyes kezelése a folyamat API-kulcs lépésében, az MCP a tankönyvben.

Gyakori kérdések

Amit a legtöbben kérdeznek

Mi a különbség az API és az MCP között?
Az API-t a programod kódja használja, előre megírt módon: a fejlesztéskor eldől, mit kér és mikor. Az MCP-t az AI-ügynök használja: használat közben elkéri a lehetőségek listáját, és maga választja ki, mire van szüksége.
Az MCP beszélgethet API-n keresztül a másik szoftverrel?
Igen, és nagyon gyakran pontosan ez történik. Az MCP server sokszor egy vékony réteg a szoftver meglévő API-ja fölött: az AI felé egyszerű utasításlistát mutat, a szoftver felé pedig API-hívásokat indít. De kapcsolódhat közvetlenül adatbázishoz, a gépeden lévő fájlokhoz vagy egy asztali programhoz is.
Az MCP kiváltja az API-t?
Nem. Más a feladatuk. Ha a programodnak minden alkalommal ugyanazt kell tennie, az API a jó megoldás. Ha az AI-nak kell kitalálnia, mit csináljon egy másik szoftverben, akkor az MCP.
Kell programoznom tudnom a használatukhoz?
Nem. A kapcsolódó kódot a coding agent megírja, neked azt kell megmondanod, mit csináljon a funkció, és megadnod a dokumentáció linkjét. Az MCP-t pedig általában néhány kattintással hozzá lehet adni az AI-eszközödhöz.
Mi történik, ha kikerül az API-kulcsom?
Aki megszerzi, a te nevedben és a te költségedre használhatja a szolgáltatást. Azonnal töröld a kulcsot a szolgáltató felületén, és készíts újat. Ezért való a kulcs a .env fájlba, és soha nem nyilvános helyre vagy chatbe.
Mennyibe kerül az API és az MCP?
Az MCP maga egy nyílt szabvány, azért nem kell fizetni. A mögötte lévő szoftver viszont lehet fizetős. Az API-k díját a szolgáltató szabja meg: sok helyen van ingyenes keret, utána a felhasználás után fizetsz, ezért érdemes költési limitet beállítani.

Kössük össze a te szoftvereidet

Workshopon vagy közös fejlesztésben a saját projekteden építjük be az API-kat és az MCP-ket.