Jak přidat MCP server do Claude Code

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

Vzdálený server je URL. Claude Code s ním komunikuje pomocí streamovaného HTTP, takže celá registrace je jeden řádek:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp

První argument za přepínačem transportu je název, který uvidíte v /mcp a v názvech nástrojů; druhý je adresa endpointu. Servery, které se autentizují přes OAuth, nepotřebují na příkazové řádce nic dalšího: při prvním otevření /mcp vyberete server a Claude Code otevře prohlížeč pro přihlášení a odsouhlasení oprávnění, poté výsledný token uloží a sám si ho obnovuje. Od verze Claude Code 2.1.186 lze přihlášení spustit i mimo interaktivní relaci příkazem claude mcp login hosttracker, a na počítači bez prohlížeče přidejte --no-browser, čímž získáte adresu ke vložení jinam.

Servery, které očekávají statický token, ho přijímají jako hlavičku:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Několik starších serverů stále používá transport SSE. Je zastaralý ve prospěch HTTP a od verze Claude Code 2.1.265 --transport http nejprve zkusí HTTP a při odmítnutí serverem přejde na SSE, takže --transport sse už téměř nepotřebujete.

Přidání lokálního serveru

Lokální server je program, který Claude Code za vás spustí a komunikuje s ním přes standardní vstup a výstup. Jeho příkaz a argumenty uveďte za dvojitou pomlčku, aby se nepletly s vlastními přepínači Claude Code:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Proměnné prostředí, které server potřebuje, se zadávají přes --env (krátce -e), opakovaně pro každou proměnnou zvlášť. Jedna zdokumentovaná past: parser přepínačů čte vše za --env KEY=value jako další dvojici, takže hned za ni neumisťujte název serveru; vložte mezi ně jiný přepínač, nebo dejte --env před --transport:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

Pokud už máte konfiguraci serveru jako JSON, například z jeho README, claude mcp add-json <name> '<json>' ji převezme tak, jak je, včetně type, command, args a env.

Volba rozsahu: tento projekt, tým, nebo všude

Ve výchozím stavu se server přidá do lokálního rozsahu, tedy jen pro tento projekt a uložený ve vašem vlastním ~/.claude.json. Existují ještě dva další rozsahy:

• --scope project zapíše záznam do souboru .mcp.json v kořeni repozitáře. Pokud ho commitnete, dostane stejný server každý spolupracovník; Claude Code každého při prvním použití požádá o schválení.
• --scope user zpřístupní server ve všech projektech na vašem počítači, stále jen vám.

Pokud stejný název existuje ve více rozsazích, lokální rozsah má přednost před projektovým a projektový před uživatelským. Celý záznam se bere z vítězného rozsahu; pole se mezi rozsahy nikdy neslučují. Rozumné rozdělení je --scope user pro služby vázané na váš vlastní účet, například monitorovací nebo ticketovací server, a --scope project pro nástroje, které má sdílet celý tým.

Ověření, že vše funguje

Spusťte claude mcp list mimo relaci. Každý server vypíše jeden z několika stavů: connected, needs authentication, failed to connect (od verze 2.1.219 doplněno o HTTP status nebo chybovou zprávu), pending approval u neschváleného projektového serveru, nebo disabled pro tento projekt. Uvnitř relace zobrazuje /mcp stejné servery i s počtem jejich nástrojů a umožňuje u vybraného spustit přihlášení, vymazat jeho autentizaci, nebo ho pro aktuální projekt vypnout, aniž byste ho odstranili.

Rychlý funkční test je dotaz, na který dokáže odpovědět jen server. S připojeným serverem HostTracker se zeptejte "které z mých monitorů jsou právě nedostupné?" nebo "spusť HTTP kontrolu na example.com ze tří lokalit"; asistent by měl zavolat nástroj pojmenovaný po serveru a uvést výsledek, který by jinak znát nemohl. Pokud se nic nestane, důvodem bývá seznam nástrojů: /mcp ukazuje nula nástrojů u serveru, který se připojil, ale autorizace selhala.

Odebrání, kontrola a import

claude mcp get <name> vypíše úplnou konfiguraci a rozsah jednoho serveru. claude mcp remove <name> ho smaže včetně všech uložených OAuth tokenů. Pokud jste servery nejprve nastavili v Claude Desktop, claude mcp add-from-claude-desktop je interaktivně naimportuje; funguje na macOS a na Windows Subsystem for Linux, ne na nativním Windows ani nativním Linuxu, a přeskočí desktopový server, jehož název obsahuje znaky, které Claude Code nepovoluje (jen písmena, číslice, pomlčky a podtržítka).

Monitorovací server jako první test

Monitorovací služba je dobrý první server k zapojení, protože výsledek volání nástroje si lze hned ověřit: asistent řekne, že web běží, a vy si to můžete otevřít a zkontrolovat. Server HostTracker nevyžaduje žádnou lokální instalaci, autentizuje se přes OAuth v prohlížeči a zpřístupňuje okamžité kontroly z 300 a více lokalit spolu s monitory, incidenty, plánovanými odstávkami a stavovými stránkami z vašeho účtu, takže na otázku "běží produkce?" dostanete odpověď ze skutečných kontrolních bodů, ne z trénovacích dat. Související návod o konfiguraci a řešení potíží s .mcp.json popisuje formát souboru, proměnné prostředí a chyby, se kterými se v praxi setkáte.