CAP
BUILDER TRACK · 2. ALKALOM

MCP — pluginek és külső rendszerek

Bekötjük Claude-ot a külvilághoz

Előadó: Mundweil Zsolt — CAP. Marketing Agency Kft.

RECAP

Múlt heti visszacsatolás

01
Claude Code CLI
claude — telepítve? Napi rutinba beépítve?
02
CLAUDE.md
/init — írtál projekt-szintűt? Tech stack, konvenciók?
03
Skillek
.claude/skills/ — /review, /pr, /test, építettél sajátot?

Interaktív: ki építette meg a saját CLAUDE.md-jét? Ki a saját skilljét?

Builder track / 2. alkalom 2 / 16
PROMPT

Spec-driven dev vs vibe coding

Vibe coding
PROMPTCsinálj egy loginot
  • Claude generikus kódot ír, sok feltevéssel
  • Iterálsz: „na de zod, na de server action, na de error state…”
  • Sok kör mire megvan a kívánt eredmény
Spec-driven
PROMPTLogin form: shadcn/ui Input + Button, zod validáció, server action, loading state, error üzenetek mező alatt
  • Production-ready kód első menetre
  • Kevesebb iteráció
  • A végén tisztább kód
Builder track / 2. alkalom 3 / 16
GYAKORLAT

Claude Code a gyakorlatban

Használati módok
  • plan mode — tervez, te jóváhagyod, nem ír kódot
  • --dangerously-skip-permissions — teljes autonómia, csak megbízható környezetben
  • accepts edits on — elfogadja a külső fájl-módosításokat
Workflow
  • 1. Plan first — kezdd plan mode-ban
  • 2. PRD / dokumentáció — adj minél több kontextust
  • 3. Fázisokra bontás — alap → feature → polish
  • 4. Iteráció + review — minden fázis után feedback

Nagy feladat: plan → fázisok → implementáció. Soha ne ugorj bele egyszerre az egészbe.

Builder track / 2. alkalom 4 / 16
AGENDA

Ma 3 dologgal foglalkozunk

01
Koncept — MCP, mi ez?
Protokoll ami összeköti Claude-ot a külvilággal. Tools, resources, prompts.
02
Használat — kész MCP-k
Filesystem, Brave, Postgres, GitHub, Slack, Drive — bekötjük és használjuk.
03
Építés — saját MCP szerver
Claude Code írja a TypeScript kódot. Te irányítasz, teszteled, bekötöd.
Builder track / 2. alkalom 5 / 16
MCP

Model Context Protocol

KLIENS
Claude Code
Claude Desktop / Code / más kliens
→
PROTOKOLL
MCP
Közös nyelv, stdio vagy SSE
→
SZERVER
MCP Szerver
Kis program, tool-okat biztosít
→
CÉLRENDSZER
Külvilág
DB, API, Slack, fájlok

Analógia: mint a VSCode plugin system. Közös protokoll, amire bárki írhat plugint. Feltelepíted, és Claude új képességeket kap.

Builder track / 2. alkalom 6 / 16
KÉPESSÉGEK

Mit biztosít egy MCP szerver?

T
Tools
Akciók. Claude meghívhatja, paramétert ad át, választ kap. query_db, send_email, create_ticket
R
Resources
Adatok. Olvasható tartalom, amit Claude kontextusba tehet. file://path, db://users/123
P
Prompts
Sablonok. Előre megírt prompt minták, paraméterekkel. analyze_pr, draft_reply
Builder track / 2. alkalom 7 / 16
MARKETPLACE

Claude Code plugin marketplace

01
Plugin ökoszisztéma
Skills, agents, MCP-k, commands.
02
Hivatalos: Anthropic marketplace
claude-plugins-official — GitHub, kurált lista.
03
Közösségi: 2500+ marketplace
claudemarketplaces.com, buildwithclaude.com
04
Telepítés egy paranccsal
/plugin marketplace add <repo> → /plugin install <név>
Builder track / 2. alkalom 8 / 16
PÉLDA

Context7 MCP — friss dokumentáció

01
Probléma: LLM elavult tudás
Modell tanítási cut-off után megjelent API/framework nem ismert.
02
Next.js friss docs
Csinálj Next.js 16 app routert. use context7
03
Verzió-pontos
Supabase auth beállítás. use library /supabase/supabase
04
Új library felfedezés
React Query mutation példát kérek, use context7
Builder track / 2. alkalom 9 / 16
ÖKOSZISZTÉMA

Community MCP-k

postgres
SQL
Lekérdezés, schema introspect, DML.
github
Repo + PR
Repo read, PR/issue create, code search.
slack
Üzenetek
Üzenet küldés, channel olvasás, user info.
google-drive
Drive
Fájl olvasás, keresés, document OCR.
notion
Notion
Page read/write, database query, blocks.
brave-search
Web search
Valós web keresés API kulccsal.

Ne találd fel a kereket. A közösség rengeteg kész MCP szervert írt, lassan több ezer.

Builder track / 2. alkalom 10 / 16
BEKÖTÉS

Claude Code MCP bekötés

1
Szerkeszd
.claude/settings.json (projekt vagy globális)
2
mcpServers szekció
Add meg a szerver nevét, a parancsot, és az env vars-okat
3
Restart Claude Code
claude újraindítás, az új MCP betöltődik
4
Teszt
„Keress: Anthropic Claude 5” — Claude használja a Brave-et
.claude/settings.json — példa: Brave Search
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/
server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "..."
      }
    }
  }
}

Ugyanaz az elv: parancs + args + env.

Builder track / 2. alkalom 11 / 16
SAJÁT

Saját MCP szerver — mikor éri meg?

CRM / ERP
Belső API
get_customer, list_deals, create_note
DB
Proprietary séma
query_users, get_metrics
Docs
Belső tudásbázis
search_docs, get_page
IoT
Hardware vezérlés
trigger_device, read_sensor

Saját domain, saját API. Ha nem létezik kész MCP amit bekötnél — te csinálsz egyet.

Builder track / 2. alkalom 12 / 16
INFRASTRUKTÚRA

Claude Agent SDK + mcp-creator skill

Eszközök
  • Claude Agent SDK — hivatalos TypeScript/Python SDK
  • @anthropic-ai/claude-agent-sdk
  • mcp-creator skill — végigvezet a tervezésen
  • /skill mcp-creator
Munkamegosztás
  • Claude csinálja: scaffold, tool signatures, hibakezelés, tesztek
  • npm init → működő szerver
  • Te csinálod: leírod mit akarsz
  • Szabadszavas utasítás → TypeScript kód

Az infrastruktúra adott. Nem nulláról írsz MCP-t — a Claude Code csinálja, skill vezeti.

Builder track / 2. alkalom 13 / 16
BEST PRACTICE

MCP készítés

1
Tool leírások = prompt
Claude a description mező alapján dönti el mikor hívja. Pontos, rövid, példával. Írd meg mikor NE használja.
2
Kevés tool, tiszta nevek
5-10 jól nevezett tool jobb mint 30 átfedő. Egy dolgot csinálj, azt jól.
3
A return tokent eszik
Ne adj vissza nyers 10 000 soros JSON-t — szűrd a lényegre. Pagináld a listákat.

Tipp: először skillt írj (markdown), csak akkor MCP ha valós integráció kell (API, DB, külső rendszer).

Builder track / 2. alkalom 14 / 16
BIZTONSÁG

MCP biztonság

1
Amit az MCP lát, Claude is látja
Tool output bekerül a beszélgetésbe és napló fájlba. Szűrj az MCP szerverben, ne a prompt-ban.
2
Transport: stdio vs SSE
Stdio = lokális subprocess, csak te éred el. SSE = hálózati, auth kell. Production remote MCP-nél mindig auth.
3
Credentials kezelés
API kulcs, DB password soha NE a forráskódban. Env vars, secret manager. NE commit-old a settings.json-t kulccsal.
Builder track / 2. alkalom 15 / 16
CAP

Köszönöm

Házi: bővítsd a saját MCP-det · Köss be kész MCP-t (mcp.so) · Gondolkodj agent use case-en. Jövő hét: agent tervezés.

Mundweil Zsolt — CAP. Marketing Agency Kft. backoffice@capmarketing.hu
1 / 16