Sběr podkladů od klienta pro Windsurf: z agenta Cascade

Aktualizováno: 16. 9. 2026

Agent Windsurfu (Cascade) čte MCP servery ze souboru mcp_config.json. Hostovaný endpoint BriefGate se připojí stejně jako jakýkoli jiný vzdálený MCP server přes Streamable HTTP, přičemž nejrychlejší funkční cesta je API klíč.

Poznámka k názvu: editor Windsurf je dnes distribuovaný jako součást Devin Desktop (Windsurf koupila Cognition) a jeho aktuální oficiální dokumentace žije na docs.devin.ai, ne na starém docs.windsurf.com — pokud vám některý odkaz níže přijde neznámý, tohle je důvod.

Problém

Cascade dokáže postavit velkou část klientského webu nebo aplikace v jednom sezení a pak narazí na stejnou věc jako každý agent: logo, texty na homepage nebo přihlášení k hostingu klient ještě neposlal.

Řešení

Cascade zavolá define_intake se seznamem potřebných položek, BriefGate klientovi pošle e-mail s odkazem na portál a automaticky ho upomíná, a Cascade zavolá get_intake_results, jakmile vše dorazí.

Nastavení BriefGate MCP ve Windsurfu

Přidejte server do mcp_config.json (Windsurf nastavení → Cascade → MCP Servers → zobrazit raw config, nebo soubor na úrovni projektu).

Varianta A — hostovaný endpoint s API klíčem (ověřená cesta)

json

{
  "mcpServers": {
    "briefgate": {
      "serverUrl": "https://mcp.briefgate.dev/mcp",
      "headers": {
        "Authorization": "Bearer bg_live_xxxxx"
      }
    }
  }
}

Klíč získáte na https://app.briefgate.dev/app (Nastavení → API klíče). Tohle je konfigurace, kterou jsme ověřili proti publikovanému formátu mcp_config.json Windsurfu/Devin Desktop pro vzdálený server přes Streamable HTTP.

Dokumentace Windsurfu zároveň uvádí, že Cascade podporuje OAuth pro vzdálené MCP servery, a hostovaný endpoint BriefGate mluví standardním OAuth 2.1 s dynamickou registrací klienta a PKCE (stejný mechanismus, jaký proti němu používají Claude Code a VS Code) — přesnou syntaxi v mcp_config.json, kterou k tomu Cascade očekává, jsme si ale neověřili. Pokud vás Cascade vyzve k přihlášení místo čtení hlavičky výše, projděte jeho vlastní flow v aplikaci; jinak se spolehněte na konfiguraci s hlavičkou výše.

Varianta B — lokální balíček s API klíčem

json

{
  "mcpServers": {
    "briefgate": {
      "command": "npx",
      "args": ["-y", "@briefgate/mcp"],
      "env": {
        "BRIEFGATE_API_KEY": "bg_live_xxxxx"
      }
    }
  }
}

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.

Jak Cascade říct, kdy to použít

Přidejte pravidlo (Windsurf → Customizations → Rules, nebo soubor .windsurfrules v projektu):

Když potřebuješ soubor, přístup nebo text od klienta:
1. Zavolej define_intake s items[] popisujícím přesně to, co je potřeba
2. Klienta nekontaktuj sám e-mailem ani zprávou — odkaz na portál posílá BriefGate
3. Pokračuj v jiné práci; sleduj get_intake_status místo čekání
4. Zavolej get_intake_results pro typovaná data a URL souborů
5. Pro jakékoli heslo, API klíč nebo přihlášení použij typ "secret"

Příklad z praxe

Vy: „Rezervační stránka potřebuje aktuální PDF s menu a přihlášení do Google Business Profile. Vyžádej si to od klienta."

Cascade zavolá define_intake s položkou typu file a secret. Klient nahraje a vyplní z mobilu; Cascade si výsledky vyzvedne přes get_intake_results v dalším vhodném kroku.

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
Rychlý start — stejný hostovaný endpoint pro Claude Code, Cursor i jiné MCP klienty