Sběr podkladů od klienta pro Claude Desktop: přímo z konverzace

Aktualizováno:

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:

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:

json
{
  "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