MCP nástroje v Claude Code: Kompletní průvodce nastavením pro začátečníky (2026)

Proč se vyplatí naučit se MCP nástroje v Claude Code

Představte si, že máte chytrého asistenta, který umí psát kód, analyzovat data a odpovídat na otázky. Ale co kdyby tento asistent mohl navíc přistupovat k vašim souborům, prohledávat internet, pracovat s databázemi nebo dokonce ovládat váš prohlížeč? Přesně to umožňuje MCP -- Model Context Protocol.

Claude Code je výkonný AI nástroj pro vývojáře, který pracuje přímo ve vašem terminálu. Sám o sobě je velmi schopný, ale díky MCP se z něj stává skutečný švýcarský nůž. Můžete k němu připojit desítky až stovky různých nástrojů a služeb, které rozšíří jeho možnosti daleko za hranice pouhého generování kódu.

V tomto průvodci vám krok za krokem ukážeme, jak MCP nástroje nastavit. Nemusíte být žádný expert -- vše vysvětlíme tak, aby to pochopil i úplný začátečník.

Co je MCP a proč je důležité

Model Context Protocol (MCP) je otevřený standard vytvořený společností Anthropic, který definuje, jak AI modely komunikují s externími nástroji a datovými zdroji. Zní to složitě? Pojďme si to zjednodušit.

Představte si MCP jako univerzální adaptér. Stejně jako máte doma adaptér, kterým připojíte různé spotřebiče do jedné zásuvky, MCP je adaptér, kterým připojíte různé služby k vašemu AI asistentovi. Díky tomu nemusí každý nástroj vymýšlet vlastní způsob, jak se s AI propojit -- všichni mluví stejným jazykem.

Jak MCP funguje v praxi

Celý systém má tři části:

• MCP klient -- to je váš Claude Code (nebo jiná AI aplikace), který potřebuje nějaký nástroj
• MCP server -- malý program, který zpřístupňuje konkrétní službu (například přístup k souborům, databázi nebo API)
• Přenosový kanál (transport) -- způsob, jakým klient a server komunikují (buď lokálně přes příkazový řádek, nebo vzdáleně přes internet)

Když například řeknete Claude Code "přečti soubor z mého počítače", Claude Code se přes MCP spojí se serverem pro souborový systém, ten soubor přečte a výsledek pošle zpět. Vy z toho vidíte jen to, že AI odpověděl s obsahem vašeho souboru -- o celou komunikaci na pozadí se postaral MCP.

Tři typy přenosu (transport)

MCP servery mohou komunikovat třemi způsoby:

• stdio -- server běží lokálně na vašem počítači a komunikuje přes příkazový řádek. Toto je nejběžnější způsob pro lokální nástroje.
• HTTP streamable -- server běží vzdáleně na internetu. Toto je doporučený standard pro rok 2026 a nahrazuje starší SSE metodu. Hodí se pro cloudové služby.
• SSE (Server-Sent Events) -- starší způsob vzdálené komunikace, který se postupně přestává používat. Pokud narazíte na starší návody s SSE, raději hledejte novější verzi s HTTP streamable.

Jak nastavit MCP v Claude Code krok za krokem

Existují dva způsoby, jak přidat MCP servery do Claude Code: pomocí příkazového řádku (jednodušší) nebo přímou editací konfiguračního souboru (pokročilejší, ale flexibilnější).

Způsob 1: Přidání přes příkazový řádek

Nejjednodušší způsob je použít příkaz claude mcp add. Otevřete terminál a zadejte:

claude mcp add nazev-serveru příkaz argumenty

Například pro přidání serveru, který umožní Claude Code přistupovat k vašim souborům:

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /cesta/k/vasemu/adresari

Pro přidání serveru s proměnnými prostředí (například API klíčem):

claude mcp add github --env GITHUB_TOKEN=váš_token -- npx -y @modelcontextprotocol/server-github

Pro přidání vzdáleného serveru přes HTTP:

claude mcp add muj-server --transport http https://mcp.example.com/mcp

Způsob 2: Přímá editace konfiguračního souboru

Pokud potřebujete nastavit více serverů najednou nebo máte složitější konfiguraci, je jednodušší upravit konfigurační soubor přímo. Důležité: Konfigurační soubor pro MCP servery se nachází v:

~/.claude/.mcp.json

Poznámka: Starší návody mohou uvádět cestu ~/.claude.json. Ta stále funguje pro uživatelský scope, ale doporučený způsob je ~/.claude/.mcp.json.

Otevřete tento soubor v libovolném textovém editoru a přidejte vaše servery. Struktura souboru vypadá takto:

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/cesta/k/vasemu/adresari"
      ]
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "váš_token"
      }
    }
  }
}

Každý server má svůj název (klíč v objektu) a nastavení, které obsahuje:

• type -- typ přenosu (stdio pro lokální, http pro vzdálené)
• command -- příkaz pro spuštění serveru (většinou npx, node nebo uvx)
• args -- argumenty příkazu
• env -- proměnné prostředí (volitelné, třeba API klíče)

Správa MCP serverů

Claude Code nabízí několik užitečných příkazů pro správu serverů:

# Zobrazení všech nakonfigurovaných serverů
claude mcp list

# Detaily konkrétního serveru
claude mcp get filesystem

# Odebrání serveru
claude mcp remove filesystem

Po každé změně konfigurace je potřeba restartovat Claude Code, aby se nové nastavení projevilo. Stačí Claude Code zavřít a znovu otevřít.

Populární MCP servery, které stojí za vyzkoušení

Ekosystém MCP serverů v roce 2026 prudce roste -- existuje již přes 1200 ověřených serverů. Zde jsou ty nejužitečnější pro začátečníky:

Filesystem (přístup k souborům)

Umožní Claude Code číst a zapisovat soubory na vašem počítači. Ideální, když potřebujete AI analyzovat obsah vašich dokumentů nebo pracovat s lokálními projekty.

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /Users/vas-uzivatel/Dokumenty

Sequential Thinking (lepší uvažování)

Tento server pomáhá AI lépe přemýšlet nad složitými problémy tím, že strukturuje myšlenkový proces do postupných kroků. Vhodný pro komplexní úlohy.

claude mcp add sequential-thinking npx -y @modelcontextprotocol/server-sequential-thinking

Puppeteer (ovládání prohlížeče)

Umožní Claude Code ovládat webový prohlížeč -- načítat stránky, klikat na tlačítka, vyplňovat formuláře nebo pořizovat snímky obrazovky. Skvělé pro testování webových aplikací.

claude mcp add puppeteer npx -y @modelcontextprotocol/server-puppeteer

Context7 (aktuální dokumentace)

Poskytuje Claude Code přístup k aktuální dokumentaci knihoven a frameworků. Když se AI ptáte na kód, Context7 zajistí, že pracuje s nejnovějšími informacemi, ne zastaralými daty z tréninku.

claude mcp add context7 npx -y @upstash/context7-mcp@latest

GitHub (správa repozitářů)

Propojí Claude Code s vaším GitHub účtem. Můžete vytvářet issues, pull requesty, procházet kód a spravovat repozitáře přímo z terminálu.

claude mcp add github --env GITHUB_TOKEN=váš_token -- npx -y @modelcontextprotocol/server-github

Vzdálené MCP servery

Stále více služeb nabízí vlastní vzdálené MCP servery, ke kterým se připojíte jednoduše přes URL. Například:

# Připojení ke vzdálenému serveru
claude mcp add linear --transport http https://mcp.linear.app/sse

# S autentizací
claude mcp add muj-server --transport http --header "Authorization: Bearer TOKEN" https://mcp.sluzba.com/mcp

Projektová vs. globální konfigurace

Claude Code rozlišuje tři úrovně konfigurace MCP serverů, které určují, kde a pro koho budou dostupné:

Uživatelská konfigurace (user scope)

Servery dostupné pro vás ve všech projektech. Ukládají se do souboru ~/.claude/.mcp.json. Toto je ideální volba pro nástroje, které používáte pořád -- třeba přístup k souborům nebo GitHub.

claude mcp add --scope user filesystem npx -y @modelcontextprotocol/server-filesystem ~/Dokumenty

Projektová konfigurace (project scope)

Servery dostupné pro všechny členy týmu v konkrétním projektu. Ukládají se do souboru .mcp.json v kořenovém adresáři projektu. Tento soubor se typicky přidává do Gitu, aby ho mohli využít i vaši kolegové.

claude mcp add --scope project databaze npx -y @modelcontextprotocol/server-postgres postgresql://localhost/muj-projekt

Lokální konfigurace (local scope)

Servery dostupné pouze pro vás v aktuálním projektu. Toto je výchozí nastavení, když neuvedete scope. Ideální pro experimentování nebo servery s citlivými údaji, které nechcete sdílet.

# Výchozí je local scope
claude mcp add muj-test npx -y @nejaký/server

Tabulka pro přehled:

• User -- soubor ~/.claude/.mcp.json, dostupné ve všech projektech, pouze pro vás
• Project -- soubor .mcp.json v projektu, dostupné pro celý tým, sdílené přes Git
• Local -- soubor ~/.claude.json (pod cestou projektu), pouze pro vás v daném projektu

Řešení častých problémů

Při nastavování MCP serverů se můžete setkat s několika běžnými problémy. Zde je návod, jak je vyřešit:

Server se nespustí nebo nereaguje

Nejčastější příčina je chybějící Node.js nebo npx. MCP servery většinou vyžadují Node.js verze 18 nebo novější. Ověřte instalaci:

node --version
npx --version

Pokud příkazy nefungují, nainstalujte Node.js z nodejs.org.

Chyba v JSON konfiguraci

JSON formát je přísný -- nepovoluje čárku za posledním prvkem. Toto je jedna z nejčastějších chyb:

// ŠPATNĚ - čárka za posledním serverem
{
  "mcpServers": {
    "filesystem": { ... },
    "github": { ... },  <-- tato čárka způsobí chybu
  }
}

// SPRÁVNĚ
{
  "mcpServers": {
    "filesystem": { ... },
    "github": { ... }
  }
}

Tip: Použijte online JSON validátor (třeba jsonlint.com) k ověření vašeho souboru.

Server je nakonfigurovaný, ale Claude Code ho nevidí

Po každé změně konfigurace musíte restartovat Claude Code. Zavřete terminál s Claude Code a spusťte ho znovu. Poté ověřte, že server je viditelný:

claude mcp list

Problémy s oprávněními

Pokud server pro souborový systém nemůže číst vaše soubory, zkontrolujte, zda cesta v konfiguraci existuje a máte k ní oprávnění. Na macOS může být potřeba povolit přístup k určitým složkám v nastavení systému.

API klíče a proměnné prostředí

Některé servery vyžadují API klíče. Pokud server nefunguje, zkontrolujte, zda máte správně nastavené proměnné prostředí v sekci env konfiguračního souboru. Nikdy nesdílejte soubory s API klíči přes Git -- používejte projektový .gitignore.

Tipy pro začátečníky

Na závěr několik praktických rad, které vám usnadní práci s MCP v Claude Code:

• Začněte jednoduše. Nepřidávejte hned deset serverů najednou. Začněte s jedním, třeba filesystem nebo sequential-thinking, a postupně přidávejte další, až budete potřebovat nové funkce.
• Používejte příkazový řádek pro rychlé přidání. Příkaz claude mcp add je nejrychlejší způsob, jak přidat nový server. Konfigurační soubor editujte ručně jen tehdy, když potřebujete přidat více serverů najednou nebo upravit složitější nastavení.
• Zálohujte svoji konfiguraci. Jakmile budete mít MCP servery nastavené tak, jak vám vyhovují, udělejte si zálohu souboru ~/.claude/.mcp.json. Hodí se to při reinstalaci systému nebo přechodu na nový počítač.
• Sledujte ekosystém. MCP komunita rychle roste. Navštivte stránky jako mcpservers.org nebo GitHub repozitář modelcontextprotocol/servers, kde najdete stovky hotových serverů pro různé účely.
• Bezpečnost na prvním místě. Nikdy nevkládejte API klíče přímo do projektových konfiguračních souborů, které sdílíte přes Git. Používejte proměnné prostředí nebo lokální scope pro citlivé údaje.

Závěr

MCP nástroje jsou jedním z nejsilnějších způsobů, jak rozšířit schopnosti Claude Code. Díky nim se z pouhého AI chatbotu stává plnohodnotný asistent, který přistupuje k vašim souborům, službám a nástrojům. Nastavení je přitom překvapivě jednoduché -- stačí jeden příkaz v terminálu nebo pár řádků v konfiguračním souboru.

Ekosystém MCP v roce 2026 nabízí přes tisíc serverů pro nejrůznější účely, od přístupu k souborům přes správu databází až po ovládání prohlížeče. Ať už jste vývojář, datový analytik nebo jen zvědavý nadšenec do AI, MCP vám otevírá dveře k efektivnější práci.

Nebojte se experimentovat -- začněte s jedním serverem, vyzkoušejte si ho a postupně objevujte další možnosti. S MCP je Claude Code připravený na cokoliv, co potřebujete.