Az MCP beállítás a legtöbb kezdőnél ott bukik el, hogy egy rossz elérési út vagy egy elgépelt JSON miatt a Claude egyszerűen nem látja az új eszközt – sokan „2 napot kínlódtak” vele, mire működött. Pedig a Model Context Protocol bekötése néhány tiszta lépésből áll, ha érted a logikáját és ismered a tipikus buktatókat.

Ebben az útmutatóban végigmegyünk azon, mi is az MCP, hogyan kötöd be a Claude Desktopba vagy CLI-be, hogyan csatlakoztatod a WordPress oldaladhoz, és melyik három hiba okozza a legtöbb fejfájást. A cél, hogy a végén magabiztosan állítsd be az elsőt.

Mi az az MCP és milyen problémát old meg az MCP beállítás?

Az MCP (Model Context Protocol) az Anthropic által nyílt szabvánnyá tett kommunikációs protokoll. Univerzális hídként köti össze az AI-asszisztenseket – például a Claude Desktopot, a Cursort vagy a különböző CLI-ket – a helyi vagy távoli adatforrásokkal, adatbázisokkal, a fájlrendszerrel és a webszolgáltatásokkal.

A probléma, amit megold, ismerős: az AI önmagában nem fér hozzá a fájljaidhoz, az adatbázisodhoz vagy a WordPress oldaladhoz. Eddig minden ilyen kapcsolathoz egyedi kódot kellett írni. Az MCP ezt szabványosítja, így egy jól megírt MCP szervert több különböző AI-kliens is azonnal használni tud.

A gyakorlati haszon egyszerű. A megfelelő MCP szerverrel a Claude nemcsak beszél a fájljaidról, hanem tényleg olvassa és írja őket, lekérdezi az adatbázist, vagy közvetlenül vázlatot hoz létre a WordPress oldaladon.

Az MCP három alapfogalma, amit értened kell

Mielőtt bármit beállítanál, érdemes tisztázni a három kulcsszereplőt. Ez a modell teszi átláthatóvá, mi hova tartozik a konfigurációban.

• MCP Host (kliens): az AI-felület, amely a protokollt használja – például a Claude Desktop, a Cursor vagy egy CLI.
• MCP Server (eszköz-kiszolgáló): egy könnyűsúlyú program (Node.js, Python vagy PHP), amely egy adott szolgáltatást nyit meg az AI-nak, például a fájlrendszert, egy SQLite adatbázist vagy a WordPress REST API-t.
• Transport (csatorna): az adatcsere módja. Helyi kapcsolatnál ez a gyors és biztonságos stdio, hálózaton keresztül pedig az SSE (Server-Sent Events / HTTP).

A szerver háromféle dolgot kínálhat fel: Tools (végrehajtható funkciók, mint a wp_create_post vagy a read_file), Resources (passzív adatok, például adatbázis-sémák) és Prompts (előre definiált utasítás-sablonok). A gyakorlatban a legtöbbször a Toolsot fogod használni.

MCP beállítás lépésről lépésre Claude Desktopban

A leggyakoribb belépő a Claude Desktop vagy egy CLI beállítása. Ehhez két előfeltétel kell: telepített Node.js (v18 vagy újabb, npm és npx támogatással), vagy Python (uv vagy pip csomagkezelővel), és maga a kliens alkalmazás.

A konfiguráció egyetlen JSON-fájlban él. A helye platformfüggő:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Ebbe a fájlba az mcpServers kulcs alá kerülnek a szervereid. Egy helyi fájlrendszert és egy SQLite adatbázist megnyitó példa így néz ki:

„mcpServers”: { „filesystem”: { „command”: „npx”, „args”: [„-y”, „@modelcontextprotocol/server-filesystem”, „/Users/felhasznalo/Documents”] } }

A mentés után indítsd újra a klienst – ez a leggyakrabban elfelejtett lépés. Ha minden rendben, a Claude felületén megjelennek az új eszközök, és rákérdez, mielőtt először használná őket.

A 3 leggyakoribb hiba, ami miatt „2 napot kínlódsz”

A magyar közösség visszatérő panaszai szinte mindig ugyanarra a három hibára vezethetők vissza. Ha ezeket előre ismered, órákat spórolsz.

1. Windows elérési út és a JSON escape

Windows alatt a sima visszaper (\) a JSON-ben escape karakter, ezért egy egyszerű útvonal is hibát okoz. A megoldás, hogy dupla visszaperrel (\\) adod meg minden elérési utat, például C:\\Program Files\\nodejs\\node.exe.

2. Az npx vagy node „not found” a GUI appban

A Claude Desktop grafikus appként nem mindig örökli a shell (.bashrc / .zshrc) PATH változóját, ezért command not found hibát ad az npx-re. A biztos megoldás, hogy relatív parancs helyett a bináris teljes abszolút útvonalát írod be, például /usr/local/bin/npx.

3. A stdout szennyezése console.log-gal

Ha saját MCP szervert írsz, egyetlen figyelmetlen console.log() tönkreteszi a stdio csatorna JSON-RPC kommunikációját. Debughoz kizárólag a console.error()-t használd – a stdout maradjon tisztán a protokoll üzeneteié.

Van egy negyedik, gyakran figyelmen kívül hagyott buktató is: a beállítás után elmarad az ellenőrzés. A legegyszerűbb teszt, ha a kliens újraindítása után egyszerűen megkérdezed az AI-t, milyen eszközök állnak rendelkezésére, vagy kérsz tőle egy konkrét műveletet – például egy fájl kilistázását a beállított mappából.

Ha az eszköz nem jelenik meg, szinte biztosan a konfigurációs fájl a hibás. Érdemes egy JSON-validátoron átfuttatni a tartalmát, mert egyetlen felesleges vessző vagy hiányzó zárójel is megakadályozza, hogy a kliens beolvassa a szervert. Ez a lépés perceket vesz igénybe, de a legtöbb „miért nem működik” helyzetet azonnal megoldja.

WordPress bekötése: az Abilities API és az MCP Adapter

Az MCP igazán akkor válik hasznossá, ha a saját eszközeidhez kötöd. A WordPress 6.9-ben bevezetett Abilities API szabványosítja a WordPress-funkciók – poszírás, kategóriakezelés, médiafeltöltés – AI által felfedezhető definícióit.

A WordPress MCP Adapter plugin ezt a képesség-készletet automatikusan MCP szerverként teszi közzé. A bekötés két lépés: telepíted az adapter bővítményt az oldaladon, majd létrehozol egy alkalmazás-jelszót (Application Password) az admin felületen a felhasználódhoz.

Ezután a klienst a WordPress-adatokkal konfigurálod (oldal URL, felhasználónév, alkalmazás-jelszó). Ha kész, a Claude eléri a wp_list_posts, wp_create_post, wp_update_post és wp_upload_media eszközöket – vagyis képes vázlatot létrehozni, kategóriát felvenni és médiát feltölteni közvetlenül a beszélgetésből.

Ez az a pont, ahol az MCP a hírgyártásból a valódi munkafolyamat-automatizálásba lép át. Ha téged is az automatizált tartalom- és weboldal-kezelés érdekel, a WebAIPro gyakorlati útmutatói és eszközei jó kiindulópontot adnak a saját workflow felépítéséhez.

Egy fontos biztonsági megjegyzés a WordPress-bekötéshez: az alkalmazás-jelszó teljes értékű hozzáférést ad a felhasználódhoz kötött jogosultságokkal. Ezért érdemes egy külön, korlátozott jogú felhasználót létrehozni az AI-integrációhoz, és nem a fő adminfiókodat használni. Így ha bármi félremegy, a hatókör kontrollált marad.

MCP kontra hagyományos REST API: miért más?

Jogos a kérdés, miért ne maradnánk a jól bevált REST API-nál. A különbség a rugalmasságban van. A hagyományos integráció statikus és hardkódolt: minden végpontot előre le kell fejleszteni, és az AI-nak külön kell értelmeznie az OpenAPI/Swagger specifikációt.

Az MCP ezzel szemben dinamikusan felfedezhető eszközöket kínál egy beépített JSON-RPC séma alapján. A jogosultságkezelés is finomabb: statikus API-kulcs helyett akciónkénti felhasználói jóváhagyás lehetséges, és ugyanaz a szerver működik helyben (stdio) és távolról (SSE) is.

Az árnyoldalt sem érdemes elhallgatni. Az MCP fiatal szabvány, a hibázenetei néha szűkszavúak, és a kezdeti beállítás – ahogy fentebb láttuk – érzékeny az elgépelésekre. Cserébe egy jól bekötött szerver hosszú távon sokkal kevesebb karbantartást igényel, mint az egyedi integrációk sora.

A jövő: egykattintásos telepítés .mcpb csomagokkal

A JSON-szerkesztés hamarosan opcionálissá válhat. Az Anthropic bevezette az .mcpb (MCP Bundle, korábban .dxt) csomagformátumot, amely egy manifest.json leíró alapján automatikusan telepíti és konfigurálja a szervert.

A gyakorlatban ez azt jelenti, hogy a felhasználónak elég egyetlen .mcpb fájlra kattintania, és a Claude Desktop elvégzi a beállítást helyette. Ez pontosan azt a belépési akadályt szünteti meg, amely miatt sokan feladták a kézi konfigurációt.

Kinek éri meg most belevágnia?

Ha rendszeresen dolgozol AI-asszisztenssel és van saját adatod – fájlok, adatbázis, WordPress oldal –, az MCP beállítás megtérülő befektetés: egyszer állítod be, utána a napi munkádat gyorsítja. A kézi JSON-konfiguráció ma még megkövetel egy kis technikai magabiztosságot, de a hibalista, amit fent átvettünk, a buktatók javát lefedi.

Aki viszont csak alkalmanként használ AI-t, nyugodtan megvárhatja az egykattintásos .mcpb csomagok elterjedését. A hivatalos dokumentáció és a kész szerverek listája a Model Context Protocol oldalán érhető el – innen érdemes az első szervert kipróbálni.

Kapcsolódó eszközös cikkünk: Claude Tag: az Anthropic új Slack-integrált AI-ágense. További AI-eszközös útmutatókért iratkozz fel az AI Hírek hírlevelére.