MCP beállítása a Claude Code-ban 2026-ban: 7 integráció telepítése

Az Ailoot használatára vonatkozó további útmutatás a dokumentációban található.

Mi az az MCP-szerver, és miért van rá szüksége a Claude Code-nak?#

Az Anthropic 2024. november 25-én jelentette be az MCP-t nyílt szabványként. Egy év alatt a protokoll iparági szabvánnyá vált: az OpenAI, a Google DeepMind és a Microsoft is támogatja. A hivatalos modelcontextprotocol/servers tároló az MCP-projekt saját referencia-szervereit tartalmazza (Filesystem, Memory, Sequential Thinking, Fetch és mások); a gyártók — a GitHub, a Notion, a Stripe, a Linear, a Cloudflare és a Sentry — saját tárolóikban teszik közzé MCP-szervereiket. A közösségi indexekben a szerverek száma több ezerre rúg.

Technikailag az MCP JSON-RPC 2.0-n keresztül működik. Az architektúra egyszerű: az Ön Claude Code-ja a kliens, bármely szolgáltatás lehet szerver, a köztük lévő MCP-szervernek pedig három eleme van: tools (amit az AI meghívhat), resources (amit az AI elolvashat) és prompts (kész sablonok).

Miért fontos ez egy vibe coder számára? Az MCP előtt a Claude és egy külső szolgáltatás közötti minden kapcsolat külön integráció volt, saját wrapperrel. Az MCP-vel a Postgres, a Slack és a GitHub összekapcsolásához három hasonló parancs elég, és a leválasztásuk is ugyanolyan egyszerű, ha már nincs szüksége a szolgáltatásra.

Miben különbözik az MCP a Skills megoldásoktól és a Subagents ágensektől?#

Egy egyszerű táblázat segít megjegyezni a különbségeket:

Gyakorlati tanulság: ha egy feladatot egyszer leírtak, és szövegként ismétlődik, az skill. Ha az AI-nak élő válaszra van szüksége egy külső rendszertől, az MCP. Ha a feladat hosszú, elágazó, és külön „agyra” van szüksége, az subagent.

Bővebben a két kapcsolódó mechanizmusról: Claude Code Skills: Saját könyvtár építése és Claude Code Subagents: 5 kész példa.

MCP beállítása a Claude Code-ban: az első parancs 5 perc alatt#

A hivatalos dokumentáció teljes szintaxisa:

claude mcp add <name> [options] -- <command> [args...]

Három transzport támogatott: --transport stdio (az alapértelmezett, helyi folyamat), --transport http (távoli HTTP) és --transport sse (elavultként van jelölve; csak akkor használja, ha a szerver még nem állt át).

A --scope kapcsolóval három hatókör adható meg:

• local — csak az aktuális projektmappában (alapértelmezett).
• project — a .mcp.json fájlba kerül, a tárolóba commitolódik, és az egész csapat számára elérhető.
• user — a gép összes projektjére érvényes.

Minimális példa az MCP-projekt referencia Filesystem-szerverével. Fél perc alatt elindul:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list

A list után akkor látja a filesystem elemet a listában, ha a parancsban megadott mappa létezik; nélküle a szerver nem indul el. Hozzáférhet a Claude Code munkamappáihoz — vagyis ahhoz a mappához, amelyből elindította. Alább, az 5.2. részben elmagyarázom, miért van ez így, és mikor hasznos valójában ez a szerver.

Az MCP-kapcsolat ellenőrzéséhez futtassa a /mcp parancsot egy Claude Code-munkamenetben. Megjeleníti az összes szervert, azok állapotát és eszközlistáját. Az Ailoot használatára vonatkozó további útmutatás a dokumentációban található. Az adott parancsokért nézze meg a kiválasztott MCP-szerver README-fájlját.

stdio vagy HTTP: melyik transzportot válassza?#

Összehasonlítás a fő szempontok szerint:

Ökölszabály: ami a lemezén vagy egy helyi adatbázisban van, stdio-t használ. Ami a felhőben van, HTTP-t használ. Az SSE hivatalosan elavult; ne válassza.

7 kész MCP-szerver vállalkozóknak#

5.1. GitHub MCP — a GitHub hivatalos szervere

Mire képes: hozzáférést biztosít a Claude Code számára az issue-khoz, pull requestekhez, tárolófájlokhoz és action-futtatásokhoz. A szerver nyílt forráskódú, és több mint 30 000 csillaga van a GitHubon.

Telepítés (HTTP, OAuth-n keresztül):

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Másik lehetőségként használjon stdio-t Dockerrel, ha OAuth helyett PAT-tokenre van szüksége.

Példa: „Olvasd el a bug címkéjű nyitott issue-kat, csoportosítsd őket komponens szerint, és javasolj sorrendet a lezárásukhoz.” Claude meghívja a GitHub MCP-t, elolvassa az összes issue-t, és fontossági sorrendbe rendezett listát ad.

Tároló: github/github-mcp-server.

5.2. Filesystem MCP — az MCP-projekt referencia-szervere

Mire képes: hozzáférést biztosít az AI számára a számítógép fájljaihoz, a jóváhagyott mappákon belül. Magát az MCP-projektet adta ki; az npm registry a Model Context Protocol a Series of LF Projects, LLC-t tünteti fel szerzőként.

Telepítés (stdio), rögzített verzióval:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects

Amikor a Claude Code csatlakozik, továbbítja a munkamappáit a szervernek, amelyek felülírnak mindent, amit a parancsban megadott. A Claude Code munkamappái azok a mappák, amelyekből elindította, valamint az /add-dir paranccsal vagy a --add-dir kapcsolóval hozzáadott mappák. A parancson keresztül nem adhat át külön, maketteket tartalmazó mappát a szervernek. A parancsban szereplő mappának ettől függetlenül léteznie kell, különben a szerver nem indul el.

Ezért a Claude Code-ban ez a szerver nagyrészt megkettőzi a beépített eszközöket. Egy másik mappa fájljainak eléréséhez elegendő az /add-dir: ezután a Claude Code saját eszközei is olvasni tudják a mappát. A szerver olyan programokhoz hasznosabb, amelyeknek nincs saját fájlhozzáférésük. A Claude Desktopban egy másik probléma is előfordulhat: a szerver eszközeit elutasítják, mert a leírásuk egy régi sémát használ; a probléma továbbra is nyitott.

Csak azokhoz a mappákhoz adjon hozzáférést, amelyekre valóban szüksége van, mind a parancsban, mind az /add-dir használatával. Ne adjon hozzáférést a lemez gyökérkönyvtárához — ez az első biztonsági rés.

Példa: először futtassa az /add-dir ~/Documents/design parancsot, majd kérje ezt: „Helyezd át az összes makettet a ~/Documents/design/landing-v3/ mappából az aktuális projektbe, és nevezd át őket a hero-*.png konvenció szerint.”

5.3. Postgres MCP — DBHub (Bytebase)

Mire képes: összekapcsolja Claude-ot a Postgres, MySQL, SQL Server, MariaDB vagy SQLite adatbázissal. Támogatja a csak olvasható módot, így az AI-ágens nem tudja egyetlen paranccsal eldobni az adatbázist. Gyakran használják az Anthropic archivált referencia-szerverének, a server-postgres-nek a helyettesítésére.

Telepítés (HTTP, csak olvasható mód):

claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly

Éles adatbázishoz mindig külön, csak olvasási jogosultságokkal rendelkező felhasználót használjon, és anonimizálja a személyes adatokat egy VIEW-n vagy köztes API-útvonalon keresztül. Ne kapcsoljon éles adatbázishoz írási jogosultsággal.

Példa: „Kérdezd le az elmúlt hónap expired előfizetési állapotú ügyfeleit, és listázd ki a 20 legnagyobb összesített befizetésűt.”

Tároló: bytebase/dbhub.

5.4. Slack MCP — csapatkommunikáció

Mire képes: lehetővé teszi Claude számára a Slack-csatornák olvasását és az üzenetek küldését. Automatizáláshoz hasznos: „Ha sikeres a build, írj a #releases csatornába”; „Állíts össze heti összefoglalót a #engineering csatornából.”

Telepítés (stdio npx wrapperen keresztül, például @modelcontextprotocol/server-slack vagy egy gyártói megfelelő használatával):

claude mcp add slack \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -e SLACK_TEAM_ID=T0... \
  -- npx -y @modelcontextprotocol/server-slack

A hitelesítés Slack Bot Token használatával történik; a hozzáférést a Slack oldalán beállított scope-ok korlátozzák. Az AI-nak csak a chat:read és chat:write:user scope-ot adhatja meg, így nem tudja módosítani a workspace beállításait. Az aktuális parancsokért nézze meg a kiválasztott szerver README-fájlját; az ökoszisztéma gyorsan változik.

Példa: „Minden reggel 9:00-kor küldd el a tegnap merge-ölt PR-ek listáját a #daily csatornába.”

5.5. Notion MCP — tudásbázis

Mire képes: hozzáférést biztosít Claude számára a Notion oldalaihoz és adatbázisaihoz. Ez egy tudásbázis a projekten kívül: ha jegyzeteket, ügyfélnyilvántartást vagy szerkesztési irányelveket tárol ott, az AI el tudja olvasni őket.

Telepítés (HTTP, OAuth-n keresztül):

claude mcp add --transport http notion https://mcp.notion.com/mcp

Másik lehetőségként használja az Anthropic hivatalos @makenotion/claude-code-notion-plugin pluginját.

Példa: „A Notion „Customers” adatbázisában keresd meg az összes olyan embert, akinek az állapota „active”, és akivel több mint két hete nem volt hívás. Készíts mindegyiküknek egy e-mail-tervezetet.”

A Notion útmutatója: developers.notion.com/guides/mcp.

5.6. Sentry MCP — hibakövetés

Mire képes: összekapcsolja Claude-ot az éles rendszer hibáival. Ha egy oldal 500-as hibával leáll, megkérdezheti: „Mutasd meg a projekthez tartozó 10 legutóbbi issue-t a Sentryben, és magyarázd el mindegyik kiváltó okát”, és azonnal elemzést kap.

Telepítés (HTTP):

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

A hitelesítés Sentry OAuth segítségével történik. A hozzáférés egy adott projektre korlátozható.

Példa: „Vedd a leggyakrabban előforduló három issue-t az elmúlt 24 órából. Magyarázd el közérthetően, mi történt, és javasolj megoldást.”

Tároló: getsentry/sentry-mcp.

5.7. Playwright MCP — böngészős munkafolyamatok

Mire képes: böngészőt biztosít Claude számára. Az AI megnyithat egy oldalt, kattinthat, kitölthet egy űrlapot és képernyőképet készíthet. Hasznos a felhasználói felület ellenőrzéséhez, a közzététel utáni manuális teszteléshez és a munkafolyamatok feldolgozásához.

Telepítés (stdio):

claude mcp add playwright -- npx -y @playwright/mcp@latest

A 2026. május 7-én kiadott v0.0.75-ös verziót aktívan karbantartja a Microsoft (több mint 32 000 csillaggal).

Példa: „Nyisd meg a weboldalunk kezdőlapját, ellenőrizd, hogy minden kártya megfelelően jelenik-e meg, és készíts képernyőképet asztali és mobilnézetben.”

Tároló: microsoft/playwright-mcp.

A rögzített verziójú parancsért, az egyidejű munkameneteket engedélyező kapcsolóért és a gyakori telepítési hibákért nézze meg a kiválasztott Playwright MCP-verzió README-fájlját.

Biztonság szabályozása PreToolUse hookkal#

Az SQL-előtagok tiltólistája nem csak olvasási jogosultsági határ: a kisbetűs SQL, megjegyzések, UPDATE, INSERT, ALTER, több utasítás és mellékhatású függvények nem tartoznak három nagybetűs előtag alá. Külön, csak olvasási engedélyű adatbázisszerepet adjon a kapcsolatnak, és eldobható tesztadatbázison igazolja az engedélyeket. A hook kiegészítő eszközhívás-vezérlés, nem e jogosultságok helyettese.

Ez szándékosan szűk karanténpélda: a három megnevezett MCP-szervercsalád minden hívását tiltsa, amíg pontosabb szabályzatot nem vizsgált át és tesztelt. Olvasást is blokkol, nem csak írást. A tényleges szerver-/eszközneveket illessze; átnevezett szerver, beépített Bash vagy más csatlakozó kívül esik e mintákon.

E külön szabályokat a .claude/settings.json fájlba tegye:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}

A szkriptet .claude/hooks/deny-unapproved-mcp.sh néven mentse. A dokumentált PreToolUse döntési szerződést adja vissza, nem a régi felső szintű decision: approve/block alakot:

#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'

A szkript nem értelmez vagy osztályoz SQL-t. Illeszkedő hívást mindig elutasít. Értékes adat csatlakoztatása előtt elkülönített munkamenetben ellenőrizze az illeszkedést és hookeredményt: a SELECT 1, kisbetűs delete, megjegyzéssel kezdődő UPDATE, Slack-olvasó vagy -küldő eszköz és Filesystem .env-olvasás is legyen elutasítva, ha eszközneve illeszkedik. Más szervercsalád eszköze maradjon a példán kívül; ezt a külön határt is igazolja.

Csak olvasási adatbázismunkához igazolt adatbázisjogokat használjon, és a karantént a tényleges eszközök átnézett szabályzatára cserélje. Csak olvasást igénylő Slack-feladathoz küldési jog nélküli hitelesítőt használjon. Fájloknál a szerver engedélyezett gyökereit és a folyamat fájljogait korlátozza. Ne állítsa, hogy e hook más eszközön, shellparancson, promptcsatolmányon vagy az ügynök által szerkeszthető szabályzatfájlon át is megakadályoz hozzáférést.

Ugyanezt a megközelítést részletesebben is bemutatja a Plan Mode Claude Code-ban útmutató — ott is hasonló „végrehajtás előtti ellenőrzés” szerepel.

Mit tegyen, ha több mint 40 eszköze van, és Claude összezavarodik?#

A Claude Code dokumentációja szerint ez most alapértelmezés szerint engedélyezve van, és nem kell kézzel bekapcsolni.

Kivételek, amikor a Claude Code azonnal betölti az összes eszközt: harmadik féltől származó proxyn keresztüli használat (amikor az ANTHROPIC_BASE_URL az Anthropicétól eltérő címre van beállítva), a Google Cloud 4.5-ös generációjánál régebbi modellek, valamint a Microsoft Foundry Azure-beli telepítései. Az ENABLE_TOOL_SEARCH változó módosítja a viselkedést:

• nincs beállítva — az összes MCP-eszköz késleltetve, igény szerint töltődik be;
• true — ugyanez, továbbá a Claude Code megpróbálja proxy-n keresztül engedélyezni a keresést;
• auto — küszöbértékes mód: amíg az eszközleírások összességében a kontextusablak kevesebb mint 10%-át foglalják el, azonnal betöltődnek; efölött késleltetve töltődnek be;
• auto:N — ugyanez, de egyedi százalékos küszöbértékkel, például auto:5;
• false — a korábbi viselkedés; minden eszköz azonnal a kontextusba kerül.

Azoknál a kritikus eszközöknél, amelyeknek mindig láthatónak kell lenniük, a szerver leírása mellett az .mcp.json fájlban használható az alwaysLoad: true kapcsoló. Minden ilyen eszköz már az első perctől foglalja a kontextust, ezért ezt csak olyan eszközöknél használja, amelyekre Claude-nak szinte minden válaszhoz szüksége van.

Ha öt vagy több MCP-szervere van, és Claude összezavarodik, melyik eszközt hívja meg, először ellenőrizze, nincs-e letiltva a keresés: keresse meg az ENABLE_TOOL_SEARCH=false beállítást, és nézze meg, proxyn keresztül dolgozik-e.

Az is segíthet, ha a /compact használatával csökkenti a kontextust.

Mikor nincs szüksége MCP-re: jobb a Skill, a Subagent vagy a CLI?#

Rangsor a tokenköltség és a komplexitás alapján:

1. CLI-parancs Bash-en keresztül — szinte ingyenes. Az AI futtatja a gh pr list, psql -c vagy curl parancsot, és egy átlagos terminálhasználóhoz hasonló választ kap.
2. Skill — olcsó. Kész prompt-sablon utasításokkal arról, mit kell meghívni és hogyan kell feldolgozni az eredményt. A mappa nevében szereplő aktiválási feltétel alapján töltődik be.
3. Subagent — közepes költségű. Külön kontextus egy hosszú feladathoz, saját tokenszekcióval.
4. MCP-szerver — drága. Csak az eszközök neve marad a kontextusban, de az eszköz leírása betöltődik, amikor Claude megtalálja azt egy hívás előtt, a szolgáltatás válaszai pedig terjedelmesek lehetnek: a Claude Code figyelmeztet, ha egy eszköz válasza meghaladja a 10,000 tokent. HTTP esetén ehhez még OAuth-munkamenet is társul.

Ellenintuítív tanács: weboldalak feldolgozásához, git használatához, PDF-ek megnyitásához és nyílt forráskódú segédprogramokhoz válassza a CLI-t, ne az MCP-t. Az AI ugyanolyan jól tud terminálparancsokat futtatni, mint egy ember, a tokeneket pedig csak a parancs és a válasza használja, eszközleírások vagy szervertöbblet nélkül.

Az MCP két esetben indokolt:

• A szolgáltatás zárt: Slack, Notion, Sentry, Linear. CLI-eszközök is léteznek, de az MCP részletesebb hozzáférést biztosít OAuth és scope-vezérlés révén.
• Élő, kétirányú kommunikációra van szükség: az AI csatlakozik a Postgreshez, ellenőrzi a sémát, feltesz egy további lekérdezést, megkapja az adatokat, majd megteszi a következő lépést. CLI-vel ehhez 10 kézi parancsra lenne szükség.

6 MCP-kapcsolati anti-minta#

1. MCP-szekrény. „A biztonság kedvéért” 10 szervert csatlakoztatott; Claude összezavarodik, melyik eszközt hívja meg, válaszaik pedig megtöltik a kontextust. Megoldás: tartson meg 3–5 szervert az aktuális projekthez, a többit pedig távolítsa el a claude mcp remove paranccsal.

2. Írási hozzáférés éles adatbázishoz. A Postgres MCP-t --readonly, külön felhasználó vagy engedélyezési listát ellenőrző hook nélkül csatlakoztatta egy éles adatbázishoz. Egyetlen prompt — „töröld a tesztrekordokat” — és az éles adatok törlődnek. Megoldás: külön adatbázisszerep igazolt csak olvasási engedélyekkel, ahol alkalmazható, a szerver csak olvasási módja és tesztelt eszközhívás-vezérlés. A DROP|TRUNCATE|DELETE előtagtiltólista nem elégséges jogosultsági védelem.

3. PII anonimizálás nélkül. Közvetlenül csatlakoztatott egy adatbázist, amely ügyfelek e-mail-címeit, telefonszámait és útlevéladatait tartalmazza. Claude látja az adatokat, azok pedig az Anthropic naplóiba kerülnek. Megoldás: VIEW vagy köztes API-útvonal, amely maszkolt adatokat ad vissza, például j***@gmail.com.

4. MCP skill helyett. „X formátumú értékesítési jelentést kell készíteni” — ez rutinfeladat, amelyet egy kész prompttal rendelkező skill old meg. Ne hozzon létre hozzá MCP-szervert.

5. MCP nyílt forráskódú CLI helyett. PDF-et kell szöveggé alakítani. Erre ott a pdftotext. Ne építsen „PDF MCP”-t — csak pazarolja a tokeneket.

6. A tokenköltségek nem követése. A csatlakoztatott szervert látja a claude mcp list parancsban, de azt nem, mennyit használ az egyes beszélgetésekben. Egy hét után fogalma sincs arról, hogy „az MCP felhasználta a kontextus 40%-át, és én ezt végig fizettem”. Megoldás: rendszeresen kapcsolja ki a nem használt szervereket, és figyelje, hogyan változik a használat a Claude Code használatilimit-követésével.

MCP-kapcsolati hiba elhárítása#

Lépésről lépésre követhető ellenőrzőlista:

1. Látható a szerver a listában?

   claude mcp list
   

   Ha nem, a claude mcp add nem futott le teljesen. A leggyakoribb ok a --scope: local hatókörrel adta hozzá, és egy másik projektből ellenőrzi.

2. Zöld a szerver állapotjelzője?

   claude mcp status <name>
   

   A piros jelzés azt jelenti, hogy a folyamat nem indult el (stdio esetén), vagy a szerver nem válaszolt (HTTP esetén).

3. Tartalmaz valami hasznosat a szerver naplója?

   claude mcp logs <name>
   

   Ha stack trace-t lát, a probléma általában a csomaggal van (npx nem találta meg, vagy a Node verziója 20 alatti).

4. Nem tér vissza az OAuth callback? A probléma általában a --callback-port vagy egy hálózati szűrő. Továbbítson egy konkrét portot:

   claude mcp add --transport http --callback-port 8765 [name] [url]
   

5. Ütközik az eszköz neve? Két szerver azonos nevű eszközt tesz elérhetővé, Claude pedig a rosszat hívja meg. Használja a Tool Search-t (lásd az előző H2-es részt), vagy kézzel távolítsa el a felesleges szervert a claude mcp remove paranccsal.

6. Nem látja a claude.ai-bővítményeket (csatlakozókat)? Ez ismert probléma: a claude.ai webes felületének bővítményei (csatlakozói) nem érhetők el a Claude Code számára, ha az API-kulcsot használ. Megoldás: az MCP-t CLI-n keresztül csatlakoztassa, ne a webes felületen.

Mi következik: OAuth, saját MCP-szerverek és a Plugin Marketplace#

A Plugin Marketplace felgyorsítja a munkát azoknak, akik nem akarnak telepítési parancsokat megjegyezni. A formátum egy .claude-plugin/marketplace.json manifest, amely egyetlen csomagban ír le szervereket.

Plugin telepítése a marketplace-ről:

claude plugin install <plugin-name>

Egy plugin egyszerre több MCP-szervert, skillt és subagentet tartalmazhat — egy adott helyzetre szabott csomagolt beállítást, például e-kereskedelemhez, marketinghez vagy jogi osztályok számára.

Saját MCP-szerverét a modelcontextprotocol.io specifikációja alapján írja meg. Egy minimális sablon az Anthropic Python vagy TypeScript SDK-ját használja; ezután írja le az eszközöket, és kapcsoljon hozzá egy transzportot. A komplexitás nagyjából egy FastAPI-val készített REST API megírásának felel meg.

Ha projektjében már van beállított CLAUDE.md, és ismeri a kontextusmérnökség alapjait, saját MCP hozzáadása egy napot vesz igénybe. Ha ezek még nincsenek meg, jobb előbb az alapokat elsajátítani.

A modellekkel való munka folytatásához látogasson el az Ailootra.