Jak dostat podklady od klienta do vašeho coding agenta
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.
- 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.
- 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.
- 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.
- 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
claude mcp add --transport http briefgate https://mcp.briefgate.dev/mcpPak 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:
{ "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
codex mcp add briefgate --url https://mcp.briefgate.dev/mcp
codex mcp login briefgatePrvní 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 |