Sběr podkladů od klienta pro VS Code a GitHub Copilot: bez opuštění editoru

Aktualizováno: 16. 9. 2026

Vestavěná podpora MCP ve VS Code (kterou používá agentní režim GitHub Copilot i jakékoli jiné chat rozšíření čtoucí stejný mcp.json) se k hostovanému endpointu BriefGate připojí s OAuth řešeným automaticky editorem.

Problém

Agentní režim Copilota umí postavit i upravit reálný klientský projekt a pak narazí na stejnou zeď jako každý kódovací agent: logo, texty na stránku nebo přihlášení k hostingu jsou v e-mailu, ne ve workspace.

Řešení

Agent zavolá define_intake s typovanými položkami, BriefGate klientovi pošle e-mail s odkazem na portál a podle plánu ho upomíná, a agent zavolá get_intake_results, jakmile vše dorazí — typované hodnoty a podepsané URL souborů, rovnou použitelné.

Nastavení BriefGate MCP ve VS Code

VS Code čte MCP servery ze souboru .vscode/mcp.json (workspace, sdílitelný s týmem) nebo z uživatelského mcp.json (Command Palette → MCP: Open User Configuration).

Varianta A — hostovaný endpoint s OAuth (nejméně kroků)

json

{
  "servers": {
    "briefgate": {
      "type": "http",
      "url": "https://mcp.briefgate.dev/mcp"
    }
  }
}

Blok oauth není potřeba: server BriefGate publikuje standardní OAuth 2.1 discovery metadata (/.well-known/oauth-authorization-server) a podporuje dynamickou registraci klienta s PKCE, a MCP klient VS Code to zpracuje automaticky — při prvním připojení se otevře okno prohlížeče, kde se přihlásíte a schválíte přístup, stejně jako u jiných vzdálených MCP serverů podporujících discovery.

Varianta B — lokální balíček s API klíčem (pro CI nebo neinteraktivní nastavení)

json

{
  "servers": {
    "briefgate": {
      "command": "npx",
      "args": ["-y", "@briefgate/mcp"],
      "env": {
        "BRIEFGATE_API_KEY": "${input:briefgate_api_key}"
      }
    }
  },
  "inputs": [
    {
      "id": "briefgate_api_key",
      "type": "promptString",
      "description": "BriefGate API key",
      "password": true
    }
  ]
}

Díky položce inputs se VS Code na klíč zeptá jen jednou a bezpečně ho uloží, místo aby ležel v prostém textu v mcp.json. Klíč získáte na https://app.briefgate.dev/app (Nastavení → API klíče). 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 agentovi říct, kdy to použít

Přidejte poznámku do instrukcí pro Copilota v repu (.github/copilot-instructions.md):

Když chybí podklad, 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 — odkaz na portál posílá BriefGate
3. Pokračuj v jiné práci; sleduj get_intake_status místo čekání na odpověď
4. Jakmile je hotovo, zavolej get_intake_results a použij typované hodnoty přímo
5. Pro jakékoli heslo, API klíč nebo přihlášení použij typ "secret"

Příklad z praxe

Vy, v Copilot Chat (agentní režim): „Než bude kontaktní formulář umět posílat poštu, vyžádej si od klienta SMTP přihlašovací údaje a adresu, kam se má posílat."

Copilot zavolá define_intake s položkou typu secret a text. Klient vyplní portál z mobilu; vy (nebo Copilot v dalším vhodném kroku) zavoláte get_intake_results a hodnoty rovnou zapojíte do konfigurace prostředí.

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