Jak dostat podklady od klienta do vašeho coding agenta

Aktualizováno:

Každý coding agent narazí na stejnou zeď: kód je hotový, ale klientovo logo, texty nebo přihlašovací údaje ne — a neexistuje dobrý způsob, jak mu je předat.

Problém

Claude Code, Cursor, Codex a všichni podobní agenti jsou rychlí v tom, co vidí: soubory, strukturu, logiku. V tom, co nevidí, jsou bezmocní — logo ležící na klientově notebooku, odstavec textu pro homepage, který ještě nikdo nenapsal, heslo do rezervačního systému, o které se agent nemá jak bezpečně říct. Agent na tuhle zeď narazí, a od té chvíle rychlost projektu závisí čistě na lidské smyčce, které se agent nijak neúčastní: napíšete klientovi e-mail, klient zapomene, urgujete, klient nakonec pošle něco použitelného — pokud vlákno dřív neusne.

Tahle mezera — mezi „agent tohle potřebuje" a „tohle existuje někde, kde si to agent umí přečíst" — bývá nejpomalejší částí klientského projektu, pomalejší než samotné programování.

Tři způsoby, jak to lidé řeší dnes, a proč žádný nestačí

Vložit to do chatu. Funguje pro větu textu. Pro soubor se to rozpadá — většina chatů agentů buď neumí přijmout upload od klienta, který do session nikdy neměl přístup, nebo klient místo zdrojového souboru vloží screenshot loga, a někdo se musí zeptat znovu. Navíc to nenechává žádnou stopu: požadavek zapadlý v transkriptu chatu starém tři týdny nikdo znovu neotevře.

Sdílená složka na Drive. Pro soubory o něco lepší, pořád ruční na obou stranách. Musíte složku vytvořit, nasdílet, v samostatné zprávě popsat, co do ní má přijít, sledovat, kdy něco nového přibude, a ručně ověřovat, jestli klient nahrál opravdu tu správnou věc — export loga ve 200 px zůstane exportem loga ve 200 px, i když je ve složce. Nic to nevaliduje, nic klienta neupomene, když to nedotáhne do konce, a nic agentovi neřekne, kdy je to skutečně hotové.

Obecný formulář. Typeform, Google Forms, kontaktní formulář nalepený na web — tohle slušně zvládne krátká textová pole a padá na všem ostatním, co reálný projekt potřebuje: žádný upload souborů ve velikosti nebo typu, jaký logo nebo galerie potřebují, a nikde bezpečné místo pro heslo. Klient, který napíše přihlášení do WordPressu do políčka formuláře, jež ho e-mailem pošle vám v čistém textu, je riziko v přestrojení za řešení.

Vzor, který tu mezeru skutečně zavírá

Funguje to, když se obrátí, kdo je iniciátorem: místo aby agent (nebo vy) honil klienta, agent přesně deklaruje, co potřebuje — jako typovaná, validovaná pole, ne odstavec prózy — a klient vyplní portál postavený přesně pro tenhle jeden účel.

  1. Agent deklaruje, co chybí. Ne „pošlete prosím nějaké fotky", ale „12 až 20 fotek, JPG nebo PNG, jídlo a interiér" — tvar, který systém dokáže reálně zkontrolovat.
  2. Klient dostane jeden odkaz. Žádný účet k založení, žádný software k instalaci. Otevře ho, uvidí krátký seznam a vyplní nebo nahraje každou položku svým tempem.
  3. Systém automaticky upomíná. Připomínky chodí podle rozvrhu, podepsané vámi, aniž byste vy nebo agent museli pamatovat na to, že máte urgovat.
  4. Agent se vrátí k práci na vlastní signál. Místo čekání na odpověď v okně chatu dostane agent webhook nebo zkontroluje stavový endpoint a pokračuje ve chvíli, kdy odpověď existuje — typovaná, validovaná, připravená k použití.

BriefGate je postavený přesně na tomhle vzoru, konkrétně pro AI coding agenty: agent zavolá define_intake() se seznamem typovaných položek (soubory, obrázky, strukturovaná data, jednorázově odhalené přihlašovací údaje), BriefGate se postará o portál, validaci i upomínání, a agent na konci zavolá get_intake_results() — žádné parsování, žádné opakované ptaní, žádné PDF nalepené do e-mailu, který nikdy neměl nést heslo. Jak fungují typy položek najdete v item-types.md a mechaniku upomínání v chase.md.

Nastavení ve vašem agentovi

Tenhle vzor umí použít jakýkoli agent podporující MCP — nezávisí na tom, který konkrétně používáte. Tady je jednořádkové nastavení pro tři nejběžnější, každé s odkazem na kompletní návod:

Claude Code

bash
claude mcp add --transport http briefgate https://mcp.briefgate.dev/mcp

Pak v Claude Code spusťte /mcp, vyberte briefgate a zvolte Authenticate — žádný klíč nikam nekopírujete. Celý návod: Podklady od klienta pro Claude Code.

Cursor

Přidejte hostovaný endpoint do .cursor/mcp.json nebo ~/.cursor/mcp.json:

json
{ "mcpServers": { "briefgate": { "url": "https://mcp.briefgate.dev/mcp" } } }

Pak klikněte na Needs login u položky briefgate v Settings → Tools & Integrations. Celý návod: Podklady od klienta pro agenty v Cursoru.

OpenAI Codex

bash
codex mcp add briefgate --url https://mcp.briefgate.dev/mcp
codex mcp login briefgate

První příkaz zaregistruje endpoint do ~/.codex/config.toml, sdíleného mezi Codex CLI, jeho rozšířením do IDE a desktopovou aplikací ChatGPT; druhý pro něj spustí vlastní OAuth flow Codexu. Celý návod: Podklady od klienta pro OpenAI Codex.

Ostatní agenti

BriefGate je standardní MCP server na Streamable HTTP s OAuth 2.1, plus lokální stdio balíček pro klienta, který radši nechce projít přesměrováním přes prohlížeč — na nastavení není nic specifického pro tři agenty výše. Jakýkoli agent, který mluví Model Context Protocol, by ho měl umět přidat stejným způsobem: nasměrovat ho na https://mcp.briefgate.dev/mcp, nebo lokálně spustit npx -y @briefgate/mcp s API klíčem. Tohle by mělo pokrýt agenty jako Windsurf, Gemini CLI nebo agent mode GitHub Copilotu, i když jsme si konkrétní konfigurační obrazovku každého z nich neprošli krok za krokem — pokud narazíte na zádrhel u klienta, který tu není jmenovitě popsaný, quickstart popisuje všechny čtyři způsoby připojení dostatečně obecně na to, aby šly přizpůsobit.

Jakmile je připojeno

Nastavení se u jednotlivých agentů mírně liší; co se stane po zavolání define_intake(), ne. Klient dostane e-mailem jeden odkaz na portál s vaším brandingem, odešle, co bylo požadováno, je automaticky upomenut, pokud se zasekne, a agent si výsledky vyzvedne zpět — typované a připravené — ať se ptal přes Claude Code, Cursor, Codex nebo cokoli jiného mluvícího MCP.

Co dál

Téma Dokument
Úplná reference všech 13 MCP nástrojů mcp.md
Všechny typy položek a jejich omezení item-types.md
Jak fungují automatické připomínky chase.md
Bezpečná práce s hesly a API klíči secrets.md