Sběr podkladů od klienta pro Claude Desktop: přímo z konverzace
Claude Desktop se k BriefGate připojí dvěma způsoby: jako vzdálený vlastní konektor (bez instalace, přihlášení přes prohlížeč) nebo jako lokální MCP server přes claude_desktop_config.json. Obě cesty dávají stejných 13 nástrojů.
Problém
Hodně práce na klientském projektu — revize textů, plánování stránky, kontrola briefu — probíhá v obyčejné konverzaci v Claude Desktop, ne uvnitř kódovacího agenta. Stejná brzda se ale objeví i tam: klientovo logo nebo přihlášení k hostingu leží v e-mailu a někdo si pro něj musí dojít.
Varianta A — vzdálený vlastní konektor (bez instalace)
Jděte do Settings → Connectors v Claude Desktop (stejný panel Customize → Connectors, jaký používá i claude.ai — Claude Desktop a claude.ai sdílejí konfiguraci konektorů), zvolte Add custom connector a vyplňte:
- Name: BriefGate
- URL:
https://mcp.briefgate.dev/mcp
Advanced settings (OAuth Client ID/Secret) nechte prázdné — server BriefGate podporuje dynamickou registraci klienta, takže se Claude při prvním připojení zaregistruje sám, stejně jako u hostovaného endpointu v claude.ai (viz návod pro claude.ai). Dostupné je to pro individuální tarify Pro a Max, ne jen pro Team a Enterprise; tarif Free má limit jednoho vlastního konektoru.
Varianta B — lokální balíček přes claude_desktop_config.json
Otevřete Settings → Developer → Edit Config (nebo upravte soubor přímo — ~/Library/Application Support/Claude/claude_desktop_config.json na macOS, %APPDATA%\Claude\claude_desktop_config.json na Windows) a přidejte:
{
"mcpServers": {
"briefgate": {
"command": "npx",
"args": ["-y", "@briefgate/mcp"],
"env": {
"BRIEFGATE_API_KEY": "bg_live_xxxxx"
}
}
}
}Klíč získáte na https://app.briefgate.dev/app (Nastavení → API klíče), nebo klíč úplně vynechte a jednou v terminálu spusťte npx -y @briefgate/mcp login — otevře přihlášení přes device flow v prohlížeči a uloží výsledné přihlašovací údaje pro lokální balíček. Po úpravě configu Claude Desktop restartujte.
Obě varianty zpřístupní stejných 13 nástrojů: define_intake, add_items, update_item, update_intake, list_intakes, get_intake_status, get_intake_results, request_revision, send_chase, manage_recipients, manage_webhook, list_folders, create_folder.
Příklad z praxe
Vy: „Připrav žádost v BriefGate pro projekt Kovář: jejich logo, tři fotky produktů a otevírací dobu obchodu."
Claude zavolá define_intake s položkou image, file_list a structured. BriefGate klientovi pošle e-mail s odkazem na portál; průběh zkontrolujete později přes get_intake_status, nebo se zeptáte Claude ve stejné či nové konverzaci — žádost žije na straně BriefGate, ne v paměti konverzace.
Zpracování výsledků
get_intake_results vrátí typované hodnoty, jakmile je klient hotový: logo a fotky jako podepsané URL souborů, otevírací dobu jako strukturovaný JSON. Cokoli ještě chybí, je pojmenované v poli missing, místo aby se nedokončená žádost tiše brala jako hotová.
Další kroky
- Přehled MCP nástrojů — plný seznam parametrů pro všech 13 nástrojů
- Typy položek — co validuje každý typ položky
- Nastavení pro claude.ai (web) — stejný konektor z prohlížeče, včetně nastavení pro Team/Enterprise
- Rychlý start — stejný hostovaný endpoint pro Claude Code, Cursor i jiné MCP klienty