📖 Den 7 — Reference: Filesystem + Fetch MCP + multi-MCP workflow

Reference — Den 7 (Filesystem + Fetch MCP)

🚀 Install commands (Claude Code)

Filesystem MCP

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem "%USERPROFILE%\Documents" "%USERPROFILE%\Desktop"

🔒 Allowed paths jsou EXPLICIT. Cokoli mimo zůstává neviditelné.

Fetch MCP

claude mcp add fetch -s user -- npx -y @modelcontextprotocol/server-fetch

Memory MCP (z Dne 4)

claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

Ověření všech 3

claude mcp list

V Claude Code chat: /mcp → vidíš memory, filesystem, fetch.

---

🗺 Tools per MCP server (typické)

Server	Tools	Použití
memory	memorize, list_memories, delete_memory, search_memories	Persistent fakta z konverzací
filesystem	list_directory, read_file, write_file, search_files, move_file	Vlastní soubory v allowed paths
fetch	fetch	URL → Markdown

💡 Tool calls v UI: vždy začínají ⏺ <toolname>(...). Bez tohoto indikátoru tool nebyl zavolán.

---

🔒 Filesystem MCP — sandbox principles

Aspekt	Realita
Path scope	Jen explicit povolené v claude mcp add (poslední argumenty)
Můžu přidat cestu později?	Ano: claude mcp remove filesystem + add s novými cestami
Read-only?	NE — agent může i psát (write_file, edit). Path scope je tvoje pojistka
Symlinks	Některé verze následují, některé ne. Pro jistotu drž explicit cesty
Network drives	Záleží na OS — Win UNC paths většinou OK pokud namountnuté

Best practice: povol jen to, co reálně potřebuješ. NIKDY nepovoluj ~/ nebo C:\ jako root — tím anuluj sandbox.

---

🌐 Fetch MCP — co umí / neumí

Funguje	Nefunguje
✅ Veřejné HTTP/HTTPS URL	❌ Login-protected (Gmail, ChatGPT)
✅ Statické weby (Wikipedia, blog posty)	❌ JavaScript SPA (mnoho React apps)
✅ HTML → Markdown konverze	❌ Cloudflare challenges, captcha
✅ Government sites (gov.cz, gov.us)	❌ Paywally (Forbes, FT)
✅ Most news sites	❌ Stránky vyžadující cookies / headers

Pro JavaScript/login weby: Playwright MCP (Y discovery, pokročilé).

---

💰 Token cost reality

Co	Cost
MCP server install (definice tools)	500-1000 tokens per server
3 aktivní MCP servery (memory + fs + fetch)	~2500 tokens jen na tool definice
Fetch krátké stránky (FAQ)	500-2000 tokens
Fetch Wikipedia článku	5000-20 000 tokens
Filesystem read_file Word soubor	1000-10 000 tokens dle velikosti

Pravidla:

• Drž max 3-5 aktivních MCP — context window má hranice
• Fetch velkých článků: prompt agenta „fetch + 5-vět shrnutí, ne raw obsah”
• Pro free tier: sleduj /cost po každém těžkém volání

---

🛠 Troubleshooting

Symptom	Pravděpodobná příčina	Řešení
claude mcp add permission error	Není admin / npm prefix v Program Files	PowerShell jako Admin / npm config set prefix $HOME\.npm-global
NPX delay 30-90 s	Stahování balíčku	Trpělivost, neukončuj Ctrl+C (z Dne 4)
/mcp neukazuje server	CC běžel PŘED mcp add	/exit + claude znovu
Filesystem „path not allowed”	Cesta není v allowed paths	claude mcp remove filesystem + add s novými
Filesystem „directory not found”	Cesta povolená, ale neexistuje	mkdir cestu nebo zvol existující
Fetch vrátí prázdný obsah	JS-heavy SPA / Cloudflare	Zkus alternativní URL (Wikipedia, gov)
Fetch token cost vyletí	Velký článek + raw content	„fetch + 5-vět shrnutí, ne raw” + /clear
Multi-MCP — agent přeskakuje server	Non-determinismus (lekce z Dne 4-6)	Explicit „volej VŠECHNY 3 — jména serverů”
Diakritika v username + npx fail	npm cache na unicode path	npm cache na ASCII (mkdir C:\npm-cache, z Dne 5 lektor)

---

🎓 4 advanced MCP (z Bloku 06 Y discovery)

1. Brave Search — real-time web search, free API key na brave.com/search/api
2. Sequential Thinking (Anthropic) — strukturované step-by-step reasoning
3. Playwright — browser automation (JS-heavy weby + login)
4. Awesome MCP servers — github.com/punkpeye/awesome-mcp-servers — 1800+ serverů

---

📚 Externí zdroje

Zdroj	URL	Co tam je
Filesystem MCP (Anthropic)	github.com/modelcontextprotocol/servers/tree/main/src/filesystem	Zdrojáky + docs
Fetch MCP (Anthropic)	github.com/modelcontextprotocol/servers/tree/main/src/fetch	Zdrojáky + docs
MCP spec	modelcontextprotocol.io	Oficiální protocol
Awesome MCP	github.com/punkpeye/awesome-mcp-servers	Komunitní katalog

---

💡 Jedna věta k zapamatování pro Den 7

Filesystem ti dává přístup k vlastním souborům (sandboxed), Fetch k veřejným URL, Memory persistuje fakta. V multi-MCP workflow agent orchestruje všechny 3 podle promptu — ty dáš jasný cíl, agent volá tools.