# Servery MCP pro Claude Code v roce 2026: 7 integrací a instalace

> Co je MCP a jak jej za 5 minut připojit pomocí příkazu claude mcp add. 7 serverů: GitHub, Postgres, Slack, Notion, Sentry, Playwright. Seznam povolených položek pomocí hooks.

Source: https://ailoot.ai/blog/cs/mcp-servers-claude-code/
Canonical: https://ailoot.ai/blog/cs/mcp-servers-claude-code/
Language: cs
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-172
Revision: sha256-97cdf6a0e6e00b30525a6fd64bb32d23dd169b06ef84aa029614227668a6ca5b


Další pokyny k práci s Ailoot najdete v [dokumentaci](https://ailoot.ai/docs/).



## Co je server MCP a proč ho Claude Code potřebuje?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

MCP (Model Context Protocol) je otevřený standard od Anthropic, který Claude Code poskytuje přístup k externím nástrojům a datům prostřednictvím jednotného rozhraní. Jeden protokol místo deseti různých API. Anthropic jej označuje jako „USB-C pro AI aplikace“: připojte port a Claude uvidí vaši databázi, e-mail, messenger nebo repozitář.

</div>

Anthropic oznámil MCP 25. listopadu 2024 jako otevřený standard. Během roku se protokol stal průmyslovým standardem: podporují jej OpenAI, Google DeepMind i Microsoft. Oficiální repozitář `modelcontextprotocol/servers` obsahuje referenční servery samotného projektu MCP (Filesystem, Memory, Sequential Thinking, Fetch a další); dodavatelé — GitHub, Notion, Stripe, Linear, Cloudflare a Sentry — publikují servery MCP ve vlastních repozitářích. V komunitních katalozích se celkový počet serverů počítá na tisíce.

Z technického hlediska MCP funguje přes JSON-RPC 2.0. Architektura je jednoduchá: váš Claude Code je klient, jakákoli služba je server a server MCP mezi nimi má tři entity: `tools` (co může AI volat), `resources` (co může AI číst) a `prompts` (připravené šablony).

<figure>
<blockquote>
Stejně jako USB-C nabízí standardní způsob připojení zařízení k různým periferiím, MCP nabízí standardní způsob připojení modelů AI k různým zdrojům dat a nástrojům.
</blockquote>
<figcaption>— Model Context Protocol, https://modelcontextprotocol.io/</figcaption>
</figure>

Proč je to důležité pro vibe codera: před MCP bylo každé propojení Claude se službou třetí strany samostatnou integrací s vlastním wrapperem. S MCP připojíte Postgres, Slack a GitHub třemi podobnými příkazy a stejně snadno je odpojíte, až službu přestanete potřebovat.

## Jak se MCP v Claude Code liší od skills a subagentů?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Tyto tři mechanismy vypadají podobně, ale řeší různé problémy. Skills jsou vaše pracovní postupy a prompty jako kód. Subagenti jsou samostatní specializovaní „kolegové“ s vlastním kontextem. MCP poskytuje externí nástroje, díky nimž se Claude může připojit ke službám a datům. Liší se i náklady na tokeny: skill je nejlevnější, MCP bývá dražší. MCP nejprve vloží do kontextu pouze názvy nástrojů a pokyny serveru; úplné popisy Claude načítá podle potřeby. Většinu nákladů tvoří odpovědi služeb: mohou být rozsáhlé a zůstávají v konverzaci.

</div>

Jednoduchá tabulka, která pomůže rozdíly udržet přehledné:

| Mechanismus | Co to je | Kdy ho použít | Náklady na tokeny |
|----|----|----|----|
| Skill | Soubor s pokyny a prompty v `.claude/skills/` | Opakuje se pracovní postup: napsat e-mail, sestavit zprávu, zveřejnit příspěvek | Nízké. Načte se při spuštění |
| Subagent | Samostatný agent s vlastním kontextem a nástroji | Dlouhý paralelní úkol: kontrola, audit, výzkum | Střední. Má vlastní kontext |
| Server MCP | Služba s nástroji/zdroji přes JSON-RPC | Je potřeba živý přístup k datům: databáze, e-mail, messenger, repozitář | Střední nebo vysoké. V kontextu zůstávají jen názvy nástrojů; popisy se načítají podle potřeby a odpovědi služeb mohou být rozsáhlé |

Praktické shrnutí: pokud je úkol jednou specifikován a opakuje se jako text, jde o skill. Pokud AI potřebuje živou odpověď z externího systému, jde o MCP. Pokud je úkol dlouhý, větví se a potřebuje samostatný mozek, jde o subagenta.

Více o dvou příbuzných mechanismech: [Claude Code Skills: Jak si vytvořit vlastní knihovnu](https://ailoot.ai/blog/cs/claude-code-skills-library/) a [Claude Code Subagents: 5 připravených příkladů](https://ailoot.ai/blog/cs/claude-code-subagents/).

## Jak nainstalovat server MCP: váš první příkaz za 5 minut

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Stejná syntaxe funguje ve všech případech: `claude mcp add [name] -- [launch command]`. Server se objeví v seznamu `claude mcp list`. Claude pak zjistí nástroje serveru a začne je používat v konverzaci. Není třeba ručně upravovat konfiguraci — vše probíhá přes CLI.

</div>

Úplná syntaxe z oficiální dokumentace:

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

Jsou podporovány tři transporty: `--transport stdio` (výchozí, místní proces), `--transport http` (vzdálené HTTP) a `--transport sse` (označený jako zastaralý; použijte jen v případě, že server ještě nepřešel na jiný transport).

Pomocí příznaku `--scope` jsou podporovány tři rozsahy:

- `local` — pouze v aktuální složce projektu (výchozí).
- `project` — zapisuje se do `.mcp.json`, který se odevzdává do repozitáře a je dostupný celému týmu.
- `user` — globálně pro všechny projekty na počítači.

Minimální příklad s referenčním serverem Filesystem projektu MCP. Spustíte ho za půl minuty:

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

Po příkazu `list` uvidíte v seznamu `filesystem`, pokud složka z příkazu existuje; bez ní se server nespustí. Uvidí pracovní složky Claude Code, tedy složku, ve které jste jej spustili. Níže v části 5.2 vysvětluji, proč tomu tak je a kdy je tento server skutečně užitečný.

Chcete-li ověřit připojení MCP, spusťte v relaci Claude Code příkaz `/mcp`. Zobrazí všechny servery, jejich stav a seznamy nástrojů. Další pokyny k práci s Ailoot najdete v [dokumentaci](https://ailoot.ai/docs/). Konkrétní příkazy si ověřte v souboru README vybraného serveru MCP.

## stdio, nebo HTTP: který transport zvolit?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

stdio je místní proces na vašem počítači; vše funguje bez sítě a není potřeba OAuth. HTTP je vzdálená služba přístupná pomocí tokenu nebo OAuth a lze ji sdílet mezi zařízeními. Pokud se server MCP instaluje přes `npx` nebo `uvx`, používá stdio. Pokud má služba vlastní veřejnou adresu, používá HTTP. SSE je oficiálně označen jako zastaralý, proto se na něj nespoléhejte.

</div>

Srovnání podle hlavních kritérií:

| Kritérium | stdio | HTTP |
|----|----|----|
| Kde běží | Místně (podřízený proces Claude Code) | Vzdálený server |
| Autorizace | Není potřeba | OAuth 2.1 nebo Bearer token |
| Síťové porty | Žádné | Veřejná adresa |
| Použití | Filesystem, Postgres, místní nástroje | GitHub, Slack, Notion, Linear, Sentry |
| Opětovné připojení | Není potřeba | Exponenciální prodleva, až 5 pokusů |
| Nasazení | Instalace místního balíčku | Služba dodavatele |

Praktické pravidlo: vše, co je uložené na vašem disku nebo v místní databázi, používá stdio. Vše, co je v cloudu, používá HTTP. SSE je oficiálně zastaralý; nevybírejte ho.

## 7 připravených serverů MCP pro podnikatele

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Těchto sedm nastavení pokrývá 80 % úkolů vibe codera: kód (GitHub), soubory (Filesystem), databáze (Postgres přes DBHub), týmová komunikace (Slack), znalostní báze (Notion), sledování chyb (Sentry) a práce v prohlížeči (Playwright). U každého nastavení níže uvádím jednořádkový instalační příkaz a příklad přesného zadání, kterým můžete Claude požádat o práci v reálné konverzaci.

</div>

### 5.1. GitHub MCP — oficiální server od GitHubu

Co umí: poskytuje Claude Code přístup k issues, pull requestům, souborům repozitáře a běhům akcí. Server je open source a na GitHubu má více než 30 000 hvězdiček.

Instalace (HTTP přes OAuth):

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

Případně použijte stdio přes Docker, pokud místo OAuth potřebujete token PAT.

Příklad: „Přečti otevřené issues označené `bug`, roztřiď je podle komponent a navrhni pořadí, v jakém je uzavřít.“ Claude zavolá GitHub MCP, přečte všechna issues a vrátí seznam podle priority.

Repozitář: [github/github-mcp-server](https://github.com/github/github-mcp-server).

### 5.2. Filesystem MCP — referenční server projektu MCP

Co umí: poskytuje AI přístup k souborům v počítači v rámci schválených složek. Vydává jej samotný projekt MCP; registr npm uvádí jako autora Model Context Protocol a Series of LF Projects, LLC.

Instalace (stdio) s připnutou verzí:

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

Při připojení Claude Code předá serveru své pracovní složky, které nahradí vše zadané v příkazu. Pracovní složky Claude Code jsou ta, ve které jste jej spustili, a složky přidané příkazem `/add-dir` nebo příznakem `--add-dir`. Pomocí příkazu nelze serveru předat samostatnou složku s maketami. Složka v příkazu přesto musí existovat, jinak se server nespustí.

V Claude Code to tedy většinou duplikuje vestavěné nástroje. Pro přístup k souborům v jiné složce stačí `/add-dir`: poté mohou složku číst i vlastní nástroje Claude Code. Server je užitečnější pro programy, které nemají vlastní přístup k souborům. V Claude Desktop se může objevit jiný problém: nástroje serveru jsou odmítnuty, protože jejich popisy používají starý formát schématu; tento problém stále není vyřešen.

Přístup povolujte pouze ke složkám, které skutečně potřebujete, a to jak v příkazu, tak prostřednictvím `/add-dir`. Nepovolujte přístup ke kořenu disku — to je první bezpečnostní díra.

Příklad: nejprve `/add-dir ~/Documents/design`, potom „Přesuň všechny makety z `~/Documents/design/landing-v3/` do aktuálního projektu a přejmenuj je podle konvence `hero-*.png`.“

### 5.3. Postgres MCP — DBHub (Bytebase)

Co umí: propojí Claude s Postgres, MySQL, SQL Server, MariaDB nebo SQLite. Podporuje režim pouze pro čtení, takže AI agent nemůže jedním příkazem smazat databázi. Často se používá jako náhrada za archivovaný referenční server Anthropic `server-postgres`.

Instalace (HTTP, pouze pro čtení):

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

U produkční databáze vždy používejte samostatného uživatele s oprávněními pouze pro čtení a anonymizujte osobní údaje pomocí VIEW nebo zprostředkující trasy API. Nepřipojujte se k produkční databázi s oprávněním k zápisu.

Příklad: „Vyhledej zákazníky se stavem předplatného `expired` z posledního měsíce a seřaď 20 nejlepších podle celkové výše plateb.“

Repozitář: [bytebase/dbhub](https://github.com/bytebase/dbhub).

### 5.4. Slack MCP — týmová komunikace

Co umí: poskytuje Claude přístup ke čtení kanálů Slacku a odesílání zpráv. Hodí se pro automatizaci: „Až sestavení projde, napiš do `#releases`“; „Sestav týdenní přehled z `#engineering`.“

Instalace (stdio přes wrapper npx, například `@modelcontextprotocol/server-slack` nebo ekvivalent dodavatele):

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

Autorizace používá Slack Bot Token; přístup se omezuje pomocí oprávnění na straně Slacku. AI můžete udělit jen `chat:read` a `chat:write:user`, takže nebude moci měnit nastavení pracovního prostoru. Aktuální příkazy ověřte v souboru README vybraného serveru; ekosystém se rychle mění.

Příklad: „Každé ráno v 9:00 pošli seznam včera sloučených PR do `#daily`.“

### 5.5. Notion MCP — znalostní báze

Co umí: poskytuje Claude přístup ke stránkám a databázím Notion. Je to znalostní báze mimo váš projekt: pokud tam uchováváte poznámky, seznam zákazníků nebo redakční pravidla, AI je může číst.

Instalace (HTTP přes OAuth):

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

Případně použijte oficiální plugin Anthropic `@makenotion/claude-code-notion-plugin`.

Příklad: „V databázi Notion ‚Customers‘ najdi všechny, jejichž stav je ‚active‘ a se kterými nikdo nemluvil déle než dva týdny. Připrav každému e-mail.“

Průvodce od Notion: [developers.notion.com/guides/mcp](https://developers.notion.com/guides/mcp/get-started-with-mcp).

### 5.6. Sentry MCP — sledování chyb

Co umí: propojí Claude s chybami v produkčním systému. Když stránka selže s chybou 500, můžete požádat: „Ukaž mi 10 nejnovějších problémů projektu v Sentry a vysvětli hlavní příčinu každého z nich,“ a okamžitě získat analýzu.

Instalace (HTTP):

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

Autorizace probíhá přes Sentry OAuth. Přístup lze omezit na konkrétní projekt.

Příklad: „Vyber tři nejčastější problémy za posledních 24 hodin. Srozumitelně vysvětli, co se stalo, a navrhni opravu.“

Repozitář: [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp).

### 5.7. Playwright MCP — práce v prohlížeči

Co umí: poskytne Claude prohlížeč. AI může otevřít stránku, klikat, vyplňovat formuláře a pořizovat snímky obrazovky. Hodí se pro kontroly UI, ruční testování po zveřejnění a zpracování pracovních postupů.

Instalace (stdio):

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

Verze v0.0.75, vydaná 7. května 2026, je aktivně udržována společností Microsoft (více než 32 000 hvězdiček).

Příklad: „Otevři domovskou stránku našeho webu, zkontroluj, že se všechny karty zobrazují správně, a pořiď snímek obrazovky na počítači i mobilu.“

Repozitář: [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp).

V souboru README vybrané verze Playwright MCP najdete příkaz s připnutou verzí, příznak pro více současných relací a běžné chyby instalace.



## Jak řídit zabezpečení pomocí hooku PreToolUse

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

MCP dává AI velkou moc: může zapisovat do databází, odesílat zprávy a mazat soubory. Hook PreToolUse může řídit odpovídající volání nástrojů, regulární výraz na začátek SQL ale není databázovou autorizací a matcher pouze pro Postgres nepokrývá Slack ani souborové nástroje. Nejprve použijte skutečná oprávnění služeb a souborového systému a přesný rozsah hooku testujte zvlášť.

</div>

Blokovací seznam prefixů SQL není hranicí přístupu pouze pro čtení: tři prefixy velkými písmeny nepokrývají malá písmena, komentáře, `UPDATE`, `INSERT`, `ALTER`, více příkazů ani funkce s vedlejšími účinky. Databázovému připojení dejte samostatnou roli s oprávněními jen pro čtení a ověřte je v jednorázové testovací databázi. Hook je další kontrola volání nástroje, nikoli náhrada oprávnění.

Zde je záměrně úzký **příklad karantény**: odmítá všechna volání tří pojmenovaných rodin serverů MCP, dokud neprověříte a neotestujete přesnější zásady. Blokuje čtení i zápis. Použijte skutečné názvy serverů a nástrojů; přejmenovaný server, vestavěný Bash či jiný konektor těmto vzorům nepodléhá.

Do `.claude/settings.json` vložte tato samostatná pravidla:

```json
{
  "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\""}]
      }
    ]
  }
}
```

Skript uložte jako `.claude/hooks/deny-unapproved-mcp.sh`. Vrací dokumentovaný [kontrakt rozhodnutí PreToolUse](https://code.claude.com/docs/en/hooks#pretooluse-decision-control), nikoli starý vrcholový formát `decision: approve/block`:

```bash
#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Tato rodina serverů MCP je v karanténě do prověření zásad."}}'
```

Skript SQL neparsuje ani neklasifikuje. Odpovídající volání vždy odmítne. Před připojením cenných dat v izolované relaci ověřte shodu a výsledek hooku: `SELECT 1`, malé `delete`, `UPDATE` s úvodním komentářem, čtení i odesílání Slacku a čtení `.env` přes Filesystem musejí být při shodě názvu odmítnuty. Nástroj jiné rodiny musí zůstat mimo příklad; tuto samostatnou hranici výslovně ověřte.

Pro databázové čtení použijte ověřená databázová oprávnění a karanténu nahraďte prověřenými zásadami pro skutečné nástroje. Pro čtení Slacku použijte přihlašovací údaj bez možnosti odesílání. U souborů omezte povolené kořeny serveru a oprávnění procesu. Netvrďte, že hook brání přístupu přes jiné nástroje, shell, přílohy zadání nebo zásady, které může agent upravit.

Stejný přístup podrobněji popisuje průvodce [Plan Mode v Claude Code](https://ailoot.ai/blog/cs/claude-code-plan-mode/) — používá podobnou logiku „zkontroluj před provedením“.

## Co dělat, když máte 40+ nástrojů a Claude se v nich ztrácí?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Sedm serverů může snadno znamenat 50–100 nástrojů. Claude Code standardně používá Tool Search: při spuštění se do kontextu vloží pouze názvy nástrojů a pokyny serverů a Claude načte úplný popis, až když nástroj potřebuje. Pokud je vyhledávání vypnuté, načtou se všechny popisy najednou a přibližně po 40 nástrojích se Claude začne plést: vybere nesprávný nástroj nebo sáhne po MCP, i když by stačil běžný příkaz.

</div>

Podle [dokumentace Claude Code](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search) je nyní ve výchozím nastavení zapnutý a není nutné ho ručně aktivovat.

Výjimky, kdy Claude Code načte všechny nástroje okamžitě: práce přes proxy třetí strany (když je `ANTHROPIC_BASE_URL` nastaven na jinou adresu než Anthropic), modely starší než generace 4.5 v Google Cloud a nasazení Microsoft Foundry v Azure. Proměnná `ENABLE_TOOL_SEARCH` mění chování:

- není nastavena — všechny nástroje MCP se odloží a načítají podle potřeby;
- `true` — totéž, navíc se Claude Code pokusí zapnout vyhledávání přes proxy;
- `auto` — režim s prahem: pokud všechny popisy nástrojů zabírají méně než 10 % kontextového okna, načtou se okamžitě; při překročení se odloží;
- `auto:N` — totéž, ale s vlastním procentním prahem, například `auto:5`;
- `false` — staré chování; všechny nástroje jsou okamžitě v kontextu.

U kritických nástrojů, které musí být vždy viditelné, je v `.mcp.json` vedle popisu serveru příznak `alwaysLoad: true`. Každý takový nástroj zabírá místo v kontextu od první minuty, proto ho používejte jen u nástrojů, které Claude potřebuje téměř v každé odpovědi.

Pokud máte pět nebo více serverů MCP a Claude si plete, který nástroj zavolat, nejprve ověřte, zda není vyhledávání vypnuté: v nastavení hledejte `ENABLE_TOOL_SEARCH=false` a zkontrolujte, zda pracujete přes proxy.

Pomoci může také [omezení kontextu pomocí /compact](https://ailoot.ai/blog/cs/claude-code-token-limits-saving/).

## Kdy MCP nepotřebujete: není lepší Skill, subagent nebo CLI?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Z hlediska tokenů je MCP nejdražší způsob, jak Claude poskytnout externí schopnosti. Pokud lze úkol vyřešit hotovým nástrojem CLI (`gh issue list`, `psql`, `curl`) nebo jednostránkovým skillem, použijte je místo vytváření serverů MCP. Pravidlo: MCP se vyplatí pouze tehdy, když AI potřebuje živou obousměrnou komunikaci se službou, nikoli jednorázovou odpověď.

</div>

Pořadí podle nákladů na tokeny a složitosti:

1.  **Příkaz CLI přes Bash** — téměř zdarma. AI spustí `gh pr list`, `psql -c` nebo `curl` a dostane odpověď jako běžný uživatel terminálu.
2.  **Skill** — levný. Připravená šablona promptu s pokyny, co zavolat a jak zpracovat výsledek. Načte se podle spouštěče v názvu složky.
3.  **Subagent** — střední náklady. Samostatný kontext pro dlouhý úkol s vlastní relací tokenů.
4.  **Server MCP** — drahý. V kontextu zůstávají pouze názvy nástrojů, ale popis nástroje se načte, když ho Claude před voláním najde; odpovědi služeb mohou být rozsáhlé: Claude Code varuje, když odpověď nástroje přesáhne 10 000 tokenů. Navíc je potřeba relace OAuth pro HTTP.

Neintuitivní rada: pro zpracování webových stránek, práci s gitem, otevírání PDF a používání open source nástrojů zvolte **CLI**, nikoli MCP. AI může volat příkazy terminálu stejně jako člověk a tokeny se spotřebovávají pouze na příkaz a jeho odpověď, bez popisů nástrojů a režie serveru.

MCP se vyplatí ve dvou případech:

- Služba je **uzavřená**: Slack, Notion, Sentry, Linear. Existují i nástroje CLI, ale MCP nabízí podrobnější přístup přes OAuth a řízení oprávnění.
- Je potřeba **živá obousměrná komunikace**: AI se připojí k Postgresu, zkontroluje schéma, položí navazující dotaz, získá data a provede další krok. S CLI by to znamenalo 10 ručních příkazů.

## 6 antipatternů při připojování MCP

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Šest konkrétních chyb, které potkávají vibe codery v prvních týdnech práce s MCP. Každý antipattern lze napravit za minutu: otevřete `claude mcp list`, projděte seznam a zkontrolujte oprávnění a hooky. Většinu problémů vyřeší odebrání zbytečného serveru, nikoli přidání nového; tuto část můžete projít jako krátký kontrolní seznam od začátku do konce.

</div>

1.  **Skříň plná MCP.** Připojili jste 10 serverů „pro jistotu“; Claude se plete v tom, který nástroj zavolat, a jejich odpovědi zahlcují kontext. Řešení: ponechte 3–5 serverů pro aktuální projekt a ostatní odeberte příkazem `claude mcp remove`.

2.  **Přístup pro zápis do produkční databáze.** Připojili jste Postgres MCP k produkční databázi bez `--readonly`, samostatného uživatele nebo hooku se seznamem povolených položek. Stačí jeden prompt — „smaž testovací záznamy“ — a produkční data jsou pryč. Řešení: samostatná databázová role s ověřenými oprávněními pouze pro čtení, případný režim serveru jen pro čtení a otestované kontroly volání nástrojů. Blokovací seznam prefixů `DROP|TRUNCATE|DELETE` není dostatečná autorizace.

3.  **Osobní údaje bez anonymizace.** Přímo jste připojili databázi obsahující e-maily, telefonní čísla a údaje z pasů zákazníků. Claude data uvidí a ta skončí v protokolech Anthropic. Řešení: použijte VIEW nebo zprostředkující trasu API, která vrací maskovaná data, například `j***@gmail.com`.

4.  **MCP místo skillu.** Potřebujete „vytvořit prodejní zprávu ve formátu X“ — rutinní úkol, který vyřeší skill s připraveným promptem. Server MCP nevytvářejte.

5.  **MCP místo open source CLI.** Potřebujete převést PDF na text. Existuje `pdftotext`. Nevytvářejte „PDF MCP“ — jen by plýtval tokeny.

6.  **Nesledování nákladů na tokeny.** Připojený server vidíte v `claude mcp list`, ale nevíte, kolik prostředků spotřebovává v každé konverzaci. Po týdnu netušíte, že „MCP spotřebovalo 40 % kontextu a celou tu dobu jsem za to platil“. Řešení: pravidelně vypínejte nepoužívané servery a sledujte, jak se mění využití, pomocí [sledování limitu používání Claude Code](https://ailoot.ai/blog/cs/claude-code-token-limits-saving/).

## Jak ladit nefunkční připojení MCP

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Nejčastější problémy: nefunguje zpětné volání OAuth, název serveru koliduje s existujícím serverem nebo se nástroj po příkazu `add` neobjeví v `claude mcp list`. Standardní postup při řešení problémů je napraví: `list` ukáže, co se připojilo, `status` ověří stav a při červeném indikátoru `logs` vrátí trasování zásobníku. Po úpravě `--scope` nebo proměnné ENV vše restartujte.

</div>

Kontrolní seznam krok za krokem:

1.  **Je server viditelný v seznamu?**

    ```bash
    claude mcp list
    ```

    Pokud ne, `claude mcp add` nebyl dokončen. Nejčastější příčinou je `--scope`: přidali jste server do `local` a kontrolujete ho z jiného projektu.

2.  **Je stav serveru zelený?**

    ```bash
    claude mcp status <name>
    ```

    Červená znamená, že se proces nespustil (stdio) nebo server neodpověděl (HTTP).

3.  **Obsahují protokoly serveru něco užitečného?**

    ```bash
    claude mcp logs <name>
    ```

    Pokud vidíte trasování zásobníku, problém obvykle souvisí s balíčkem (`npx` jej nemohl najít nebo je verze Node nižší než 20).

4.  **Nedaří se vrátit zpětné volání OAuth?** Problém obvykle souvisí s `--callback-port` nebo síťovým filtrem. Přesměrujte konkrétní port:

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

5.  **Konflikt názvů nástrojů?** Dva servery zpřístupňují nástroj se stejným názvem a Claude volá nesprávný. Použijte Tool Search (viz předchozí H2) nebo přebytečný server ručně odeberte příkazem `claude mcp remove`.

6.  **Nevidíte rozšíření (connectors) z claude.ai?** Jde o známý problém: rozšíření (connectors) z webového rozhraní claude.ai nejsou Claude Code dostupná, když používá klíč API. Řešení: připojte MCP přes CLI, nikoli přes webové rozhraní.

## Co dál: OAuth, vlastní servery MCP a Plugin Marketplace

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key points in this section">

Hlavní poznatky

Po sedmi připravených serverech následují tři kroky: OAuth pro vlastní servery HTTP (pokud chcete MCP sdílet s týmem), vytvoření vlastního MCP pro jedinečnou službu a připojení k Plugin Marketplace Anthropic. Marketplace byl spuštěn 9. října 2025 a sdružuje MCP do pluginů, které lze instalovat jediným příkazem.

</div>

Plugin Marketplace urychluje práci každému, kdo si nechce pamatovat instalační příkazy. Formát tvoří manifest `.claude-plugin/marketplace.json`, který popisuje sadu serverů v jednom balíčku.

Instalace pluginu z marketplace:

```bash
claude plugin install <plugin-name>
```

Plugin může obsahovat několik serverů MCP, skills a subagentů najednou — zabalené nastavení pro konkrétní situaci: e-commerce, marketing nebo právní oddělení.

Napište vlastní server MCP podle specifikace `modelcontextprotocol.io`. Minimální šablona používá Python nebo TypeScript SDK od Anthropic; potom popíšete nástroje a připojíte transport. Složitostí se to podobá psaní REST API ve FastAPI.

Pokud váš projekt už má [nakonfigurovaný CLAUDE.md](https://ailoot.ai/blog/cs/claude-md-template/) a rozumíte [práci s kontextem](https://ailoot.ai/blog/cs/context-engineering/), přidání vlastního MCP zabere den. Bez toho je lepší nejprve se naučit základy.

<div class="section" role="doc-bibliography" aria-label="Sources">

### Zdroje

- [Model Context Protocol — oficiální web](https://modelcontextprotocol.io/)
- [Anthropic představuje MCP — 25. listopadu 2024](https://www.anthropic.com/news/model-context-protocol)
- [Dokumentace Claude Code MCP](https://code.claude.com/docs/en/mcp)
- [Claude Code: vyhledávání nástrojů MCP](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
- [Oznámení Claude Code Plugins — 9. října 2025](https://claude.com/blog/claude-code-plugins)
- [Code with Claude 2026](https://claude.com/code-with-claude)
- [modelcontextprotocol/servers — oficiální registr](https://github.com/modelcontextprotocol/servers)
- [github/github-mcp-server](https://github.com/github/github-mcp-server)
- [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
- [bytebase/dbhub — Postgres MCP](https://github.com/bytebase/dbhub)
- [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp)
- [makenotion/claude-code-notion-plugin](https://github.com/makenotion/claude-code-notion-plugin)
- [Průvodce Notion MCP](https://developers.notion.com/guides/mcp/get-started-with-mcp)
- [Repozitář Anthropic Claude Code — issues a changelog](https://github.com/anthropics/claude-code)

</div>





Chcete-li pokračovat v práci s modely, přejděte na [Ailoot](https://ailoot.ai/).

## Časté otázky

### Zajistí tento hook přístup do produkční databáze jen pro čtení?

Ne. Příklad dává do karantény všechna volání odpovídajících rodin MCP; SQL neklasifikuje. Čtení bez zápisu musí zajistit samostatná databázová role s ověřenými oprávněními. Hook slouží jako dodatečná kontrola.

### Jak otestovat rozsah hooku?

V izolované relaci ověřte odmítnutí čtení i zápisů odpovídajících názvů nástrojů, včetně SQL malými písmeny a s úvodním komentářem. Poté ověřte, že jiný nástroj do matcheru nespadá; tato nepokrytá cesta potřebuje vlastní oprávnění či zásady.


## Ailoot · Společnost a její portfolio projektů

Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.
