Napřímo s AI

Osm modulů. Dva levely. Od prvního promptu po stavění agentů – vše v češtině, vše s příklady k okamžitému použití.

Proč to funguje jinak,
než čekáte

Než se naučíte psát prompty, potřebujete vidět, co Claude dokáže. Nejdřív výsledek – pak vysvětlení.

Jak to bylo dřív – a jak je to teď

Není to magie. Je to nástroj. Jako Excel pro čísla – Claude pro text. Kvalita výstupu = kvalita vašeho zadání.

Čeština nebo angličtina? (Zabíjíme mýtus)

Slyšeli jste to: "AI funguje líp v angličtině." Pro běžnou kancelářskou práci to není pravda. Claude byl trénován na velkém množství českého textu a pro běžnou kancelářskou práci si s češtinou poradí velmi dobře.

Write email to client about delay in delivery. Be polite.

ROLE: Obchodní manažer firmy CEOS Data
KONTEXT: Klient Novák s.r.o. objednal dodávku na 15. května.
Kvůli výpadku subdodavatele se zpozdíme o 3 pracovní dny.
ÚKOL: Napiš omluvný e-mail panu Dvořákovi (ředitel logistiky).
FORMÁT: Formální, max 150 slov, nabídnout 5% slevu jako kompenzaci.

Claude rozumí češtině výborně – pro výstup (e-maily, texty, zprávy) pište česky. Pro instrukce a složité prompty zvažte angličtinu: méně tokenů, silnější reasoning.

Čtyři elementy dobrého promptu

Každý prompt, který stojí za to napsat, má tyto čtyři vrstvy. Pokud vám výstup nesedí, jednu jste vynechali.

Gramatika promptu – proč formát rozhoduje

Claude nečte prompt jako člověk. Strukturu vnímá jako signály priority. Tři nejsilnější nástroje:

Tato „gramatika" není povinná pro jednoduché prompty – e-mail nebo shrnutí napíšete bez ní. Začíná se vyplácet u projektových instrukcí a u promptů, které budete používat opakovaně.

Před/Po #1 – Obchodní manažer B2B

Scénář: Připravujete se na schůzku se zákazníkem, který zvažuje přechod ke konkurenci.

Pomoz mi připravit se na poradu.

ROLE: Zkušený obchodní manažer B2B v IT službách.
KONTEXT: Klient Alfa Logistik (3 roky náš zákazník, roční obrat
1,2 mil. Kč) zvažuje přechod ke konkurenci. Důvody, které uvedli:
(1) drahší než konkurence o 15 %, (2) pomalejší reakce supportu,
(3) chybějící integrace na jejich ERP.
ÚKOL: Připrav mi tři protiargumenty pro retenční schůzku.
Každý: jedna věta tvrzení + jedna věta podklad/číslo.
FORMÁT: Odrážky. Bez úvodu, bez závěru. Jen ty tři argumenty.

Když výstup nesedí – co s tím

Zkus to sám – Cvičení 1

Napiš mi prezentaci o našem novém produktu.

ROLE: Produktový marketér v B2B SaaS firmě.
KONTEXT: Náš produkt je nástroj pro automatizaci fakturace
pro účetní firmy s 5–50 klienty. Spouštíme za 2 týdny.
Cílové publikum: majitelé účetních firem, kteří fakturují ručně v Excelu.
ÚKOL: Napiš osnovu 10minutové prezentace.
FORMÁT: 6 slide titulků + 2–3 odrážky obsahu pro každý.
Bez úvodního „Děkuji za pozornost", bez závěrečného „Otázky?".

Pozor: Claude si někdy vymýšlí

Pravidlo: Jakékoli konkrétní fakty, čísla nebo právní odkazy z Claudea si vždy ověřte v primárním zdroji. Nikdy je neposílejte dál bez kontroly.

Claude vidí obrázky, screenshoty a grafy

Claude není jen textový nástroj. Nahrajte screenshot, fotografii nebo graf – Claude ho přečte a analyzuje.

[Nahrajete screenshot dashboardu nebo tabulky]

ÚKOL: Shrň klíčové čísla z tohoto grafu do 3 odrážek.
Co je nejdůležitější trend? Co by mě mělo znepokojit?

[Nahrajete fotografii handwriten poznámek nebo tabulky]

ÚKOL: Přepiš tuto tabulku do čistého textu.
Zachovej strukturu, oprav zjevné překlepy.

Jak nahrát: v Claude.ai klikněte na ikonku přílohy nebo přetáhněte soubor do chatovacího okna. Podporované formáty: PNG, JPG, GIF, WebP, PDF.

Napište Claudovi víc kontextu, než byste napsali e-mailovému kolegovi – hned dnes odpoledne.

Jak psát prompty,
které fungují

Když znáte čtyři elementy z Modulu 1, jste 70 % na cestě. Zbývajících 30 % je vědět, kdy Claude zapomněl, jak iterovat – a kterých pět chyb dělá skoro každý začátečník.

Claude nezná vaši historii (Blank Slate model)

Představte si Claude jako kolegu s perfektní pamětí – ale jen do té doby, než zavřete okno chatu. Každý nový rozhovor = prázdná tabule. Neví, kdo jste, na čem jste pracovali včera.

Pět nejčastějších chyb

Rozpoznejte chybu – pak ji opravte. U každého páru zkuste napřed uhodnout, co je špatně.

1 · Příliš krátký prompt bez kontextu

Napiš e-mail zákazníkovi.

KONTEXT: Zákazník Novák s.r.o. (pan Dvořák, ředitel logistiky)
nedostal dodávku včas – zpoždění 3 dny, vina subdodavatele.
ÚKOL: Napiš omluvný e-mail.
TÓN: Formální, bez přehnané pokory, nabídnout 5% slevu.
DÉLKA: Max 150 slov.

2 · Žádný příklad ani vzor

Napiš příspěvek na LinkedIn v našem firemním stylu.

Tady jsou tři naše předchozí příspěvky, abys pochopil styl:
[VLOŽTE 3 UKÁZKY]

ÚKOL: Napiš nový příspěvek na téma „spuštění nové verze
naší fakturační aplikace". Stejný tón, stejná délka, stejná struktura.

3 · První výstup = finální

[Claude vrátí draft]
[Vy ho ručně přepisujete v editoru 20 minut.]

[Claude vrátí draft]
Vy: Udělej to o třetinu kratší a formálnější.
[Claude vrátí v2]
Vy: Druhý odstavec přeformuluj, ať tam není „rád bych".
[Hotovo za 3 minuty.]

4 · Přehnaná zdvořilost

Byl bych velice vděčný, pokud byste mi mohl laskavě
pomoci s krátkým shrnutím tohoto dokumentu,
pokud by to nebyl problém. Předem děkuji.

ÚKOL: Shrň tento dokument do 5 odrážek.

Není to o kultuře. Je to o efektivitě. Pět slov místo dvaceti, výsledek stejný.

5 · Citlivá data bez rozmyslu

Připrav analýzu výkonu zaměstnance:
Petr Novák, rodné číslo 850315/1234,
plat 65 000 Kč, hodnocení 2024: 3/5.

Připrav analýzu výkonu zaměstnance:
Zaměstnanec A, senior pozice, plat v horní třetině pásma,
hodnocení 2024: 3/5 (průměrné).
Jakou odměnu jako % platu navrhuješ?

Iterativní promptování

Prompt je dialog, ne formulář. Tři kroky, které se vyplatí mít ve svalové paměti:

Prompt je dialog, ne formulář.

Jak poznat kvalitní výstup

Pokud odpověď na kteroukoli otázku je „ne" → jedna věta korekce v dalším promptu.

Před/Po #2 – HR specialistka

Scénář: Hledáte tři obráběče CNC do výrobní firmy. Potřebujete inzerát, který nebude znít jako každý druhý.

Napiš mi e-mail o tom, že potřebujeme nové zaměstnance.

ROLE: HR specialistka s 10 lety praxe ve strojírenství.
KONTEXT: Hledáme 3 obráběče CNC do výrobní haly v Plzni.
Mzda 55–65 tis. Kč podle praxe. Třísměnný provoz.
Nástup do 30 dnů. Konkurence v okolí má volných cca 40 pozic.
STRUKTURA: 3 odstavce – proč my, koho hledáme, jak se přihlásit.
DÉLKA: Max 150 slov.
ZAKÁZANÉ FRÁZE: „dynamické prostředí", „přátelský kolektiv",
„benefity", „rodinná atmosféra", „mladý tým".
ÚKOL: Napiš inzerát na pracovní portál.

Zkus to sám – Cvičení 2

VY (krok 1): [původní prompt z Cvičení 1]
CLAUDE: [draft, ~400 slov]

VY (krok 2): Zkrať na polovinu a vyhoď všechny floskule.
CLAUDE: [draft v2, ~200 slov]

VY (krok 3): Druhou odrážku přepiš – místo
„výrazně lepší" dej konkrétní číslo.
CLAUDE: [finální verze]

Vždy žádejte druhou verzi.

Kdy iterovat – a kdy začít znovu

Tip: Než začnete znovu, přidejte do nového promptu, co v předchozím nefungovalo – Claude se vyhne stejné chybě.

Claude jako nástroj,
ne hračka

Jak nastavit Claude.ai Projekty, kdy AI použít a kdy ne – a co nikdy neposílat.

Claude.ai Projekty – vaše pracovní prostředí

Projekt = konverzační prostor s trvalými instrukcemi. Nastavíte jednou → funguje ve všech konverzacích v projektu.

Jsi asistent pro tým obchodních manažerů ve firmě [název].
Vždy odpovídej česky. Vykání.
Výstupy strukturuj jako: Shrnutí → Klíčové body → Doporučení.
Délka odpovědí: max 300 slov, pokud nepožádám jinak.
NEPIŠ: „Rád vám pomohu", „Samozřejmě", „Skvělá otázka".
Pokud chybí kontext, polož mi jednu konkrétní otázku místo abys hádal.

Firemní kontext v příloze

K projektu nahrajte soubory (PDF, DOCX, TXT). Claude k nim má přístup ve všech konverzacích v projektu.

• Firemní style guide – Claude dodržuje tón a slovník.
• Šablona reportu – výstupy v přesné struktuře.
• Produktová specifikace – odpovídá fakty, ne odhady.
• Anonymizované profily klientů – kontext pro draftování komunikace.

Před/Po #3 – Projektový manažer: Zápis z porady

Udělej zápis z porady.

ROLE: Projektový manažer ve vývoji softwaru.
KONTEXT: Tady je hrubý zápis z dnešní porady (8 lidí, 60 min):
[text zápisu]

ÚKOL: Přepiš do strukturované podoby podle šablony.
Pokud chybí termín nebo odpovědná osoba, uveď to v Otevřených otázkách.

ŠABLONA:
**Rozhodnutí:**
- [seznam]

**Akční body (kdo, co, do kdy):**
- [Jméno] · [úkol] · [datum]

**Otevřené otázky:**
- [otázka] – kdo rozhodne, do kdy

Kdy Claude pomůže – a kdy ne

Claude dělá chyby. Vy je zkontrolujete. Ale za 10 minut místo hodiny.

Bezpečnost dat – tři kategorie

Poslal bych tato data e-mailem cizinci? Pokud ne, neposílám je ani Claudovi.

Šedá zóna – jak rozhodnout

Oranžová kategorie je nejčastějším zdrojem nejistoty. Klíčová otázka: „Dá se z toho identifikovat konkrétní člověk?"

Zkus to sám – Cvičení 3

Vytvořte si dnes jeden Projekt v Claude.ai s instrukcemi pro vaši nejčastější práci.

ROLE: Jsi asistent pro [vaše pozice] v [typ firmy / odvětví].
JAZYK VÝSTUPU: Česky. Vykání.
JAZYK INSTRUKCÍ: Angličtina dává lepší výsledky u složitých úkolů.
STYL: [formální / kolegiální / přímý]
TYPICKÉ ÚKOLY: [3 nejčastější věci, které s Claudem děláte]
FORMÁT: [markdown / prostý text / odrážky], max [délka].
NEPIŠ: [3 fráze, které vás na výstupech AI vadí]
KDYŽ NEMÁŠ KONTEXT: Polož jednu konkrétní otázku místo abys hádal.

Jsi expert na psaní instrukcí pro Claude Projects.

Když uživatel přijde s požadavkem, nejdřív se ho zeptej
na každou z těchto otázek zvlášť a počkej na odpověď:
1. Jaká je jeho pracovní role a v jakém odvětví pracuje?
2. Jaké 3 věci bude v tomto Projektu s Claudem dělat nejčastěji?
3. Jaký tón preferuje – formální, kolegiální, nebo přímý?
4. Co mu na výstupech AI nejvíc vadí nebo co nikdy nechce vidět?

Po odpovědích vygeneruj hotové instrukce připravené k přímému
vložení do pole "Project instructions" v Claude.ai.
Instrukce musí být konkrétní, max 250 slov, bez zbytečného
omáčkování – jen jasná pravidla, která Claude bude dodržovat.

[VERSION] 1.0 — AI Instruction Architect

[ROLE]
You are an AI Instruction Architect — a specialist in designing,
refining, and auditing system prompts for AI assistants across
all major platforms (Claude Projects, Custom GPTs, Gemini Gems,
M365 Copilot, API integrations).

Your core skill: turning a user's vague intent into a precise,
deployable set of instructions that makes an AI behave exactly
as needed — no guesswork, no bloat.

[GOAL]
For every request, produce a complete, platform-appropriate
system prompt. When the user's intent is clear enough, generate
immediately. When critical information is missing, run a short
interview first. Never produce a partial result.

[WORKFLOW]

## Step 1 — Identify the mode
Classify what the user is bringing to you:
- DESIGN: Building a new AI assistant or tool from scratch
- REFINE: Improving or extending an existing prompt
- AUDIT: Reviewing a prompt for issues, gaps, or risks

## Step 2 — Gap analysis
Evaluate the request across four dimensions:
1. Purpose — What must the AI accomplish?
2. Audience — Who uses it, in what context?
3. Constraints — What must it never do?
4. Platform — Where will this run?

Scoring rules:
- 3+ dimensions unclear → run Step 3 interview, then stop
- 1–2 dimensions unclear → state assumptions, generate immediately
- Bypass signal detected ("just draft it", "no questions") → generate immediately

## Step 3 — Interview (only when needed)
Ask all questions in one message. Maximum 4 questions.
Make them specific and answerable. Number them.
Do not ask open-ended questions like "tell me more."
Stop after asking. Wait for the user's response.

## Step 4 — Generate
Produce the full system prompt inside a single fenced code block.
Never truncate. Never use "..." or "same as above."
Output every section in full.

[OUTPUT STRUCTURE]
Every prompt you generate must contain these sections:

[VERSION]       — version number and one-line description
[ROLE]          — who the AI is, its expertise, its persona
[GOAL]          — the primary outcome it must achieve
[WORKFLOW]      — numbered phases for handling any request
[CONSTRAINTS]   — hard rules: what it must always do
[ANTI-PATTERNS] — hard prohibitions: what it must never do
[OUTPUT FORMAT] — exact structure of its responses
[EXAMPLES]      — optional; only if behavior is non-obvious

[PLATFORM GUIDE]
Default target: Claude Project.

- Claude Project     → XML tags welcome, generous token limit
- Custom GPT / Gem   → ~8000 chars max, plain markdown
- M365 Copilot       → ~8000 chars max, minimal formatting
- Direct API         → no hard limit, optimize for token efficiency

If the platform is not specified, state your assumption and proceed.

[CONSTRAINTS]
- Always output the complete prompt — never a partial version
- State all assumptions explicitly before or after the generated prompt
- Match response language to the user's input language;
  keep section anchors in English
- Remove [EXAMPLES] first if near the platform token limit
- When auditing: list issues before proposing fixes

[ANTI-PATTERNS]
- Never ask more than 4 interview questions at once
- Never invent constraints the user did not imply or request
- Never copy an existing prompt verbatim without meaningful improvement
- Never use placeholder phrases: "...", "rest unchanged", "as above"
- Never generate a prompt that instructs the AI to act harmfully

[OUTPUT FORMAT]

## Analysis
Mode: DESIGN / REFINE / AUDIT
Platform: [identified or assumed — note if assumed]
Assumptions: [explicit list, or "none"]

## Generated Prompt
(complete prompt in a single fenced code block)

## Design Notes
(optional — 2–3 bullets on tradeoffs or suggested next iterations)

Vytvořte si dnes jeden Projekt s instrukcemi pro vaši nejčastější práci s Claudem.

Agenti a co dál

Krátký výhled. Co je agent, kde ho najít, kdy se vyplatí – a jak najít kandidáty na automatizaci ve vlastní práci.

Co je agent – jedním slovem

Dva konkrétní příklady, ne abstraktní definice:

Jak agenti v praxi fungují

1. Dostane cíl. Ne jednu otázku – celý úkol. „Připrav konkurenční analýzu pro pondělní poradu."
2. Plánuje kroky. Rozdělí úkol: najdi, přečti, porovnej, zapiš.
3. Používá nástroje. Volá web search, čte soubory, spouští kód, ukládá výstupy.

Vy schvalujete výsledek, ne každý krok. Ale výsledek vždy schvalujte.

Kde agenty najdete

Co sledovat – kandidáti na automatizaci

Sledujte, co opakujete každý týden – to jsou kandidáti na automatizaci agenty.

• Opakuje se – každý týden nebo měsíc ve stejné podobě.
• Má pravidla – dá se popsat „když X, tak Y; jinak Z".
• Zabírá čas – alespoň 30 minut na jeden běh.
• Textový vstup a výstup – dokumenty, e-maily, data.
• Lze zkontrolovat kvalitu – víte, jak vypadá správný výstup.

Zkus to sám – Cvičení 4

Jste tu správně, pokud…

Level 2 předpokládá, že Level 1 máte zvládnutý. Pokud ne, projděte M1–M4 napřed.

Claude Code
v praxi

Claude Code není chatbot. Je to AI s přístupem k vašemu souborovému systému, terminálu a nástrojům. Tady je vše, co potřebujete vědět na začátek.

Claude.ai vs. Claude Desktop vs. Claude Code

Instalace

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

Po instalaci: spusťte claude v terminálu v adresáři svého projektu. Claude Code se vás zeptá na přihlášení přes API klíč nebo přes Claude.ai Pro/Max účet.

# Zkontroluje verzi a stav všech součástí
claude doctor

# Výpis nainstalované verze
claude --version

claude doctor diagnostikuje běžné problémy (verze Node.js, oprávnění, konfigurace) a navrhne opravy. Spusťte ho vždy, když něco nefunguje.

IDE integrace a desktop appka

• VS Code: nainstalujte extension „Claude Code“ z Marketplace – spouští Claude Code přímo v editoru
• JetBrains (IntelliJ, PyCharm, WebStorm...): plugin „Claude Code“ dostupný v JetBrains Marketplace
• Terminál: příkaz claude funguje v jakémkoliv terminálu

CLAUDE.md – váš permanentní briefing

CLAUDE.md je soubor v kořeni vašeho projektu. Claude Code ho čte automaticky na začátku každé session. Je to ekvivalent systémových instrukcí v Claude.ai Projektech – ale pro agentic workflow.

# Projekt: CRM API Backend

## Stack
- Python 3.12, FastAPI, PostgreSQL 16
- Testy: pytest, coverage > 80 %
- Linting: ruff, mypy strict

## Konvence
- Docstringy v cestine, komentare v anglictine
- Snake_case pro promenne, PascalCase pro tridy
- Kazda funkce max 30 radku

## Co NESMI dělat
- Mazat soubory bez potvrzeni
- Commitovat bez spusteni testu
- Menit databazove migrace bez souhlasu

## Caste ukoly
- make test spusti celou test suite
- make lint spusti ruff + mypy
- Migrace: alembic revision --autogenerate -m popis

Výběr modelu

Claude Code podporuje více modelů. Vyberte podle potřeby:

Context window a příkaz /compact

Claude Code si pamatuje celou konverzaci v rámci session. Při dlouhých sekcích (velké codebases, mnoho souborů) se kontext plní. Signály, že je čas na /compact:

• Claude začíná zapomínat dřívější instrukce nebo kontext
• Odpovědi jsou méně přesné než na začátku session
• Dostanete varování o využití kontextu

/compact

# Nebo s vlastnim shrnutim:
/compact Pracujeme na refaktoringu auth modulu.
Dokoncili jsme: User model, JWT middleware.
Zbyva: refresh token endpoint, rate limiting.

Claude Code shrne celou dosavadní konverzaci a pokračuje s komprimovaným kontextem. CLAUDE.md se vždy znovu načte – takže klíčové instrukce přežijí compact.

Pokračování předchozí session

Zavřeli jste terminál a chcete navazat tam, kde jste skončili? Claude Code umožňuje obnovit předchozí konverzaci dvěma způsoby:

# Navazat na posledni konverzaci v tomto adresari
claude --continue

# Zkratka
claude -c

# Zobrazit seznam predchozich konverzaci a vybrat si
claude --resume

Základní workflow

# 1. Prejdete do adresare projektu
cd ~/projects/muj-projekt

# 2. Spustte Claude Code
claude

# 3. Claude precte CLAUDE.md a ceka na vas prompt
# Pridej endpoint POST /api/users s validaci emailu a ulozenim do DB

# 4. Claude navrhne zmeny, vy je schvalite
# 5. Pri dlouhe session pouzijte /compact
/compact

CLAUDE.md je váš permanentní briefing pro každý projekt – napište ho jednou, aktualizujte při změnách architektury.

Skills
a Hooks

Skills jsou vaše zautomatizované best practices. Hooks jsou pravidla, která se spustí automaticky v pravý čas. Dohromady dávají Claude Code skutečnou firemní paměť.

Co je skill v Claude Code

Skill je markdown soubor s instrukcemi pro Claude Code. Definujete v něm, jak má Claude přistupovat k určitému typu úkolu. Místo abyste psali detailní instrukce pokaždé znovu, napíšete je jednou do skill souboru a Claude ho načte automaticky nebo na vyzádání.

Anatomie skill souboru

---
name: code-review
description: Perform code review according to team standards.
  Use this skill when asked to review a PR or specific files.
---

# Code Review Checklist

## Security (always check)
- SQL injection: are inputs parameterized?
- Authentication: are endpoints properly protected?
- Secrets: no API keys or credentials hardcoded?

## Code quality
- Functions max 30 lines (our convention)
- Variables named clearly and consistently
- Missing error handling?

## Tests
- Are new functions covered by tests?
- Are edge cases addressed?

## Output
Return a structured report:
- CRITICAL: (block merge)
- SUGGESTIONS: (nice to have)
- PRAISE: (what was done well)

Reálné příklady pluginů

Nejrychlejší cesta jak začít: nainstalovat hotový plugin a prohlédnout si, jak jsou skills napsané.

Kde se skills ukládají

• Projektové skills: .claude/skills/ v kořeni projektu – platí jen pro tento projekt
• Globální skills: ~/.claude/skills/ – platí pro všechny projekty
• Firemní skills: sdílené přes Git repo, každý vývojář si naklonól do ~/.claude/skills/

# Claude Code automaticky nabidne skill pokud prompt sedi na description
# Udelej code review tohoto PR
# Claude nacte code-review.md a postupuje podle nej

# Nebo ho explicitne zavolejte jako slash command (bez slova "skill"):
/code-review src/api/users.py

Co jsou Hooks

Hooks jsou shell příkazy nebo skripty, které Claude Code spouští automaticky v definovaných okamžicích – jako Git hooks, ale pro AI workflow.

Konfigurace hooků v settings.json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo Bash prikaz spusten >> ~/claude-audit.log"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "make lint 2>&1 | tail -5"
          }
        ]
      }
    ]
  }
}

Tento příklad loguje každý Bash příkaz a po ukončení session spustí linting. Výsledek lintingu dostanete jako součást Claude Code výstupu.

Paměť v Claude Code

Claude Code má tři úrovně paměti:

# Staci rict v konverzaci – Claude zapise do memory souboru sam
Zapamatuj si, ze preferuji vystupy v cestine a vzdy chci videt zduvodneni.

# Nebo pri dlouhe praci
Zapamatuj si, ze v tomto projektu pouzivame async/await everywhere.

# Claude soubor ulozi do:
# ~/.claude/projects/<projekt>/memory/

Skills = vaše firemní best practices zautomatizované. Napište je jednou, sdílejte přes Git, použijte v každém projektu.

MCP
servery

Model Context Protocol (MCP) je standard, který dává Claude Code přístup k externím systémům – databázím, API, nástrojům. Místo custom integrace: plug & play ekosystém.

Co je MCP a proč na tom záleží

MCP (Model Context Protocol) je otevřený standard od Anthropic pro připojení AI modelů k externím zdrojům dat a nástrojům. Místo toho, aby každý vývojář psal vlastní integraci, existuje standardizovaný protokol – a ekosystém hotových MCP serverů.

// Každá integrace je custom
// 100 řádků pro GitHub API
// 200 řádků pro databázi
// 150 řádků pro Slack
// Žádné sdílení, žádná standardizace

# Instalace standardizovaného serveru
claude mcp add github
claude mcp add postgres
claude mcp add slack

# Hotovo – Claude Code má přístup

Jak MCP funguje

MCP server je lokální nebo vzdálený proces, který Claude Code spouští a komunikuje s ním přes standardizované JSON-RPC zprávy. Claude Code může:

• Číst resources: soubory, databázové záznamy, API odpovědi
• Volat tools: spouštět akce (create PR, send message, run query)
• Číst prompts: předdefinované prompt šablony z externích systémů

Claude Code ↔ MCP Client ↔ MCP Server ↔ Váš systém
                  (součást Claude Code)  (lokální nebo remote)

Instalace MCP serveru

# Přidat MCP server
claude mcp add <název>

# Přidat s konkrétním příkazem (npm)
claude mcp add github npx -y @modelcontextprotocol/server-github

# Přidat s konkrétním příkazem (uvx/Python)
claude mcp add postgres uvx mcp-server-postgres postgresql://localhost/mydb

# Zobrazit nainstalované servery
claude mcp list

# Odstranit server
claude mcp remove <název>

Servery se konfigurují v .claude/settings.json (projektové) nebo ~/.claude/settings.json (globální).

Přehled užitečných MCP serverů

# Automaticky dostupné, bez instalace

# Instalace
claude mcp add github npx -y @modelcontextprotocol/server-github

# Co umí
# - Číst a vytvářet Issues
# - Číst a komentovat Pull Requesty
# - Procházet repozitáře a soubory
# - Spravovat branches
# Potřebuje: GITHUB_TOKEN env proměnnou

# PostgreSQL
claude mcp add postgres uvx mcp-server-postgres postgresql://user:pass@localhost/db

# SQLite
claude mcp add sqlite uvx mcp-server-sqlite --db-path ~/data/app.db

# Co umí
# - Spouštět SELECT dotazy (read-only)
# - Introspekce schématu (tabulky, sloupce)
# - Vysvětlení query plans

# Instalace
claude mcp add playwright npx -y @playwright/mcp

# Co umí
# - Otevřít URL v prohlížeči
# - Klikat, vyplňovat formuláře, screenshoty
# - End-to-end testování
# - Scraping webových stránek
# Použití: UI testování, debugging webových aplikací

# Instalace
claude mcp add fetch npx -y @modelcontextprotocol/server-fetch

# Co umí
# - HTTP GET/POST/PUT/DELETE requesty
# - Volání REST API
# - Stahování a parsování HTML stránek
# Použití: integrace s externími API, web scraping

# Instalace
claude mcp add slack npx -y @modelcontextprotocol/server-slack

# Co umí
# - Číst zprávy z kanálů
# - Odesílat zprávy a odpovědi
# - Správa kanálů a uživatelů
# Potřebuje: SLACK_BOT_TOKEN env proměnnou

Který MCP server pro jaký úkol

Bezpečnost MCP serverů

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

// ✓ Token přichází z OS env proměnné
// ✗ NIKDY: "GITHUB_TOKEN": "ghp_actualtoken123"

MCP server = Claude Code dostane ruce do vašich systémů. Nastavte přístup na nejnižší nutnou úroveň.

Agenti v
Claude Code

Agentic mód v Claude Code znamená, že Claude nečeká na každý váš pokyn – plánuje, používá nástroje, a dokončuje celé úkoly autonomně. Tady je jak to funguje a jak to dělat bezpečně.

Agentic vs. non-agentic mód

Agent tool – subagenti

V Claude Code (a v Claude.ai Pro/Max) lze spouštět subagenty – oddělené instance Claude, které pracují paralelně nebo sekvenčně na dílčích úkolech.

# Zadáte komplexní úkol
> Proveď komplexní audit bezpečnosti tohoto API projektu.
  Zkontroluj: (1) autentizaci, (2) SQL injections, (3) rate limiting,
  (4) logging citlivých dat. Pracuj paralelně, vrať souhrnnou zprávu.

# Claude Code spustí 4 subagenty paralelně:
# Agent 1: Analyzuje autentizaci
# Agent 2: Hledá SQL injection zranitelnosti
# Agent 3: Kontroluje rate limiting
# Agent 4: Audit loggingu
# → Každý pracuje samostatně, výsledky se sloučí

Kdy použít agenta vs. přímý příkaz

Rizika a ochranné mantinely

Permission prompts – vaše bezpečnostní síť

Claude Code vás při každé potenciálně nebezpečné operaci zeptá. Jsou tři možnosti odpovědi:

Full permission mode – agent bez přerušení

Pokud chcete agenta pustit zcela autonomně (přes noc, v CI/CD pipeline) bez jakýchkoli permission promptů:

# Agent pracuje bez přerušení – žádné permission prompty
claude --dangerously-skip-permissions

# Nebo trvale v settings.json:
{
  "permissionMode": "bypassPermissions"
}

Jak vypadá výstup agenta

Agent průběžně komentuje, co dělá. Typický výstup po dokončení úkolu:

✓ Hledám konkurenty v segmentu X... nalezeno 12 výsledků
✓ Čtu stránku firmy A... extrahoval jsem ceník a 3 klíčové funkce
✓ Čtu stránku firmy B... ceník veřejně nedostupný, poznamenal jsem
✓ Zpracovávám firmy C, D, E...
✓ Vytvářím srovnávací tabulku...

## Výsledek: 5 konkurentů v segmentu X

| Firma | Cena/měs. | Klíčová funkce | Slabina |
|-------|-----------|----------------|---------|
| A     | 2 900 Kč  | Integrace ERP  | Bez mobilní app |

⚠️ Firma B: ceník nenalezen – doporučuji ověřit ručně.

Worktree pattern – izolace pro agenty

Pro rozsáhlé agentic úkoly je dobrou praxí pracovat v Git worktree – izolované kopii repozitáře. Agent pracuje v izolaci, vaše main branch je v bezpečí.

# Vytvořte worktree pro agentic úkol
git worktree add ../feature-auth -b feature/auth-refactor

# Spusťte Claude Code v izolovaném worktree
cd ../feature-auth && claude

# Agent pracuje izolovaně – main branch nedotčena
# Po dokončení: merge, PR nebo cleanup
git worktree remove ../feature-auth

CLAUDE.md pro agentic projekty

## Safety Rules (ALWAYS FOLLOW)

### MUST NOT without explicit confirmation:
- Delete files or directories
- Push to main/master branch
- Run database migrations (--run)
- Call payment or production APIs
- Modify CI/CD pipeline configuration

### MAY do autonomously:
- Read and analyze files
- Write code to feature branches
- Run tests (make test)
- Run linting (make lint)
- Create files in /tmp or /draft

### When in doubt: STOP and ASK.

Jak sledovat agenta v průběhu práce

Kdy agenta nepoužívat

# V CLAUDE.md sekce bezpečnosti:
## Omezení session
- Max kroků na jeden agentic úkol: 30
- Při překročení: zastav a zeptej se uživatele

# Nebo v .claude/settings.json:
{
  "maxTurnsPerSession": 30
}

Agent je dobrý sluha – ale musíte mu nastavit hranice. CLAUDE.md s bezpečnostními pravidly je povinnost pro každý agentic projekt.