Jak připojit MCP servery do Claude Desktop
Claude Desktop se k MCP serverům připojuje dvěma způsoby: vzdálený server se přidává jako vlastní konektor v Nastavení, Konektory, vložením jeho URL, a lokální server se deklaruje v souboru claude_desktop_config.json, ke kterému se dostanete přes Nastavení, Vývojář, Upravit konfiguraci, s následným úplným restartem aplikace. Rozšíření z vestavěného adresáře jsou třetí, jednoklikovou cestou pro lokální servery, které pro něj byly zabaleny.
Vzdálené servery: přidání vlastního konektoru
Otevřete Claude Desktop, přejděte do Nastavení, poté Konektory, a klikněte na Přidat vlastní konektor. Zadejte název, vložte URL serveru a potvrďte. Vlastní konektory přes vzdálené MCP jsou dostupné na plánech Free, Pro, Max, Team a Enterprise; účet Free má limit jeden vlastní konektor. Na plánech Team a Enterprise nejprve konektor přidá vlastník organizace v nastavení organizace a členové ho pak zapnou na vlastní stránce Konektory.
Servery podporující OAuth vás při prvním použití požádají o přihlášení a schválení rozsahů oprávnění v prohlížeči; nic jiného není potřeba. Volitelná sekce Pokročilá nastavení přijímá OAuth client ID a secret pro servery, které vyžadují předem registrovaného klienta, což většina veřejných serverů nevyžaduje. Pro server HostTracker je adresa https://mcp.host-tracker.com/mcp; používá OAuth s dynamickou registrací klienta, takže konektor drží jen rozsahy, které schválíte, a žádný klíč se nevkládá.
Konektory běží na straně Anthropic, ne na vašem počítači, takže se nedostanou k serveru ve vaší lokální síti, a jde o stejný mechanismus, jaký používají claude.ai a Cowork. Konfigurační soubor popsaný dále je lokální obdoba.
Lokální servery: úprava claude_desktop_config.json
Otevřete Nastavení, zvolte kartu Vývojář a klikněte na Upravit konfiguraci. Otevře se konfigurační soubor ve vašem editoru, a pokud ještě neexistuje, vytvoří se. Soubor se na macOS nachází v ~/Library/Application Support/Claude/claude_desktop_config.json a na Windows v %APPDATA%\Claude\claude_desktop_config.json; v linuxové beta verzi použijte tlačítko Upravit konfiguraci místo hádání cesty. Každý server je záznam pod mcpServers s příkazem ke spuštění a jeho argumenty:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}
Soubor uložte, poté Claude Desktop úplně ukončete a spusťte znovu; zavření okna nestačí, protože servery se spouštějí při startu aplikace. Na Windows musí být běhové prostředí, na které se příkaz spoléhá, například Node.js pro npx, nainstalováno a v PATH, které desktopová aplikace vidí, takže server, který v terminálu funguje, ale z aplikace ne, bývá způsoben právě rozdílem v PATH.
Ověřit, že se server načetl, lze kliknutím na ikonu "Přidat soubory, konektory a další" vlevo dole v poli zprávy, najetím na Konektory a otevřením Spravovat konektory; server je tam uveden i se svými nástroji. Starší dokumentace tomu říká ikona kladívka a stránka pro řešení potíží tento název stále používá v jednom nadpisu.
Rozšíření z adresáře
Nastavení, poté Rozšíření, poté Procházet rozšíření zobrazí kurátorovaný adresář lokálních serverů zabalených jako rozšíření, která se instalují jedním kliknutím a sama se aktualizují. Stažený balíček se instaluje přes Instalovat rozšíření výběrem souboru; tyto balíčky používají formát .mcpb, který nahradil dřívější název .dxt, a mohou zabalit servery v Node.js, Pythonu nebo binární podobě. Soukromě distribuované balíčky se sami neaktualizují a po změně je nutné je ručně přeinstalovat.
Kde hledat logy, když se nic nezobrazí
Claude Desktop píše obecný log připojení a po jednom logu pro každý server. Na macOS jsou v ~/Library/Logs/Claude/ jako mcp.log a mcp-server-NAME.log; na Windows v %APPDATA%\Claude\logs. Soubor pro jednotlivý server obsahuje jeho vlastní chybový výstup, kde je vidět chybějící modul, špatná cesta nebo odmítnutý přihlašovací údaj. Pokud je soubor prázdný, aplikace se vůbec nedokázala příkaz spustit, což ukazuje zpět na PATH nebo na chybu syntaxe JSON v konfiguračním souboru.
Jedna aplikace, dvě plochy
Claude Desktop nyní obsahuje kartu Code, která spouští Claude Code přímo v aplikaci, vedle karty Chat. Servery deklarované v claude_desktop_config.json jsou dostupné jak v chatu, tak v relacích na kartě Code, spolu se servery z ~/.claude.json a projektového .mcp.json; pokud stejný název existuje na obou místech, karta Code použije definici z desktopového souboru. Samostatný příkazový řádek Claude Code desktopový soubor nečte. Pokud jste servery nejprve nastavili v desktopové aplikaci a chcete je i v terminálu, claude mcp add-from-claude-desktop je naimportuje na macOS a Windows Subsystem for Linux, jak popisuje návod jak přidat MCP server do Claude Code.
Vzdálený monitorovací server jako první konektor
Vzdálený server je nejrychlejší způsob, jak ověřit, že tok připojování konektoru funguje, protože se nic neinstaluje a odpověď lze snadno zkontrolovat. Přidejte server HostTracker jako vlastní konektor, po vyzvání se přihlaste a zeptejte se Claude, zda web, který znáte, běží; odpověď by měla citovat kontrolu spuštěnou z konkrétních pojmenovaných kontrolních bodů HostTracker, ne odhad. Stránka MCP serveru uvádí všech 65 nástrojů a rozsahy oprávnění, které každý z nich potřebuje, od okamžitých kontrol až po aktualizace stavových stránek.