Blog

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

Markdown

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.

Přečíst celý článek

Další pokyny k práci s Ailoot najdete v dokumentaci.

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

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ář.

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).

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.
— Model Context Protocol, https://modelcontextprotocol.io/

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ů?

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.

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

MechanismusCo to jeKdy ho použítNáklady na tokeny
SkillSoubor s pokyny a prompty v .claude/skills/Opakuje se pracovní postup: napsat e-mail, sestavit zprávu, zveřejnit příspěvekNízké. Načte se při spuštění
SubagentSamostatný agent s vlastním kontextem a nástrojiDlouhý paralelní úkol: kontrola, audit, výzkumStřední. Má vlastní kontext
Server MCPSlužba s nástroji/zdroji přes JSON-RPCJe 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 a Claude Code Subagents: 5 připravených příkladů.

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

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.

Úplná syntaxe z oficiální dokumentace:

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:

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. Konkrétní příkazy si ověřte v souboru README vybraného serveru MCP.

stdio, nebo HTTP: který transport zvolit?

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.

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

KritériumstdioHTTP
Kde běžíMístně (podřízený proces Claude Code)Vzdálený server
AutorizaceNení potřebaOAuth 2.1 nebo Bearer token
Síťové portyŽádnéVeřejná adresa
PoužitíFilesystem, Postgres, místní nástrojeGitHub, Slack, Notion, Linear, Sentry
Opětovné připojeníNení potřebaExponenciální prodleva, až 5 pokusů
NasazeníInstalace místního balíčkuSluž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

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.

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):

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.

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í:

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í):

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.

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):

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):

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.

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):

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.

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):

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.

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

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ášť.

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:

{
  "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, nikoli starý vrcholový formát decision: approve/block:

#!/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 — 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í?

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.

Podle dokumentace Claude Code 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.

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

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ěď.

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

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.

  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.

Jak ladit nefunkční připojení MCP

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.

Kontrolní seznam krok za krokem:

  1. Je server viditelný v seznamu?

    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ý?

    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?

    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:

    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

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.

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:

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 a rozumíte práci s kontextem, přidání vlastního MCP zabere den. Bez toho je lepší nejprve se naučit základy.

Chcete-li pokračovat v práci s modely, přejděte na Ailoot.

Další podrobnosti

Č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.

Všechny články