Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Model Context Protocol (MCP) je otevřený standard, který umožňuje modelům AI pracovat s externími nástroji a službami prostřednictvím sjednoceného rozhraní. Podpora MCP v sadě Visual Studio vylepšuje režim agenta GitHub Copilot tím, že umožňuje připojit jakýkoli server kompatibilní s MCP k pracovnímu postupu kódování agenta.
Tento článek vás provede nastavením serverů MCP a používáním nástrojů s režimem agenta v sadě Visual Studio.
Požadavky
- Visual Studio 2022 verze 17.14 nebo novější Důrazně doporučujeme nejnovější servisní verzi 17.14, protože každá verze přidává funkce MCP.
Jak MCP a Visual Studio rozšiřují agenta GitHub Copilot
Podpora MCP v sadě Visual Studio funguje takto:
- Klienti MCP, jako je Visual Studio, se připojují k serverům MCP a požadují akce jménem modelu AI.
- Servery MCP poskytují jeden nebo více nástrojů, které zpřístupňují konkrétní funkce prostřednictvím dobře definovaného rozhraní.
- Protokol definuje formát zprávy pro komunikaci mezi klienty a servery, včetně zjišťování nástrojů, vyvolání a zpracování odpovědí.
Například server MCP pro systém souborů může poskytovat nástroje pro čtení, zápis nebo vyhledávání souborů a adresářů. Oficiální server MCP GitHubu nabízí nástroje pro výpis úložišť, vytváření žádostí o přijetí změn nebo správu problémů. Servery MCP se můžou spouštět místně na vašem počítači nebo vzdáleně hostovat. Visual Studio podporuje obě konfigurace.
Díky standardizaci této interakce MCP eliminuje potřebu vlastních integrací mezi jednotlivými modely AI a jednotlivými nástroji. Možnosti asistenta AI pak můžete rozšířit jednoduše přidáním nových serverů MCP do pracovního prostoru. Přečtěte si další informace o specifikaci MCP.
Příklad konfigurace se serverem MCP GitHubu
Následující názorný postup vyžaduje verzi 17.14.9 nebo novější.
Vytvořte nový soubor:
<SOLUTIONDIR>\.mcp.jsonnebo%USERPROFILE%\.mcp.json. K úpravě tohoto souboru doporučujeme použít Visual Studio, aby se automaticky použilo jeho schéma JSON.Do souboru vložte následující obsah
.mcp.json:{ "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/" } } }Uložte soubor. Potom aktivujte informace CodeLens, které se zobrazí na novém serveru, aby se ověřily na tomto serveru prostřednictvím účtu GitHubu.
V sadě Visual Studio vyberte šipku Zeptat se v okně chatu GitHub Copilot a pak vyberte Agent.
Vyberte nástroje, které chcete použít; Například problémy se seznamem.
Vyzkoušejte ukázkovou výzvu: Zobrazení seznamu problémů přiřazených mně na GitHubu
Copilot žádá o povolení používat nástroj, který mu server MCP zpřístupnil. Vyberte Povolit pro rozsah, se kterým chcete pokračovat.
Podporované možnosti MCP
Visual Studio podporuje následující funkce MCP:
- Možnosti přenosu serveru MCP jsou místní standardní vstup/výstup (
stdio), události odesílané serverem (sse) a streamovatelné HTTP (http). - Z funkcí (nástroje, výzvy, prostředky, vzorkování) teď Visual Studio podporuje:
- Nástroje: Provádění akcí a operací prostřednictvím režimu agenta Copilot
- Výzvy: Opakovaně použitelné šablony výzev, které můžete vyvolat pomocí parametrů
- Prostředky: Přístup k externím datům a kontextu prostřednictvím prostředků založených na identifikátorech URI
- Vzorkování: Vylepšené interakce modelu AI s vašimi nástroji a službami
- Visual Studio poskytuje servery s aktuálními složkami řešení pomocí
roots(specifikace). - Pro autorizaci MCP visual Studio podporuje ověřování pro vzdálené servery s libovolným poskytovatelem OAuth.
Vyhledání serverů MCP
Oficiální úložiště serverů MCP je skvělým výchozím bodem pro referenční, oficiální a komunitní servery, které ukazují všestrannost MCP. Servery můžete prozkoumat pro různé funkce, jako jsou operace systému souborů, interakce s databázemi a webové služby.
MCP je relativně nový standard a ekosystém se rychle vyvíjí. Vzhledem k tomu, že další vývojáři přijmou MCP, můžete očekávat, že uvidíte rostoucí počet serverů a nástrojů dostupných pro integraci s vašimi projekty.
Příklady serverů MCP
Vyzkoušejte si některé další oblíbené servery MCP v sadě Visual Studio jedním kliknutím:
-
– Objevte a nainstalujte vlastní výzvy a návody pro GitHub Copilot.
-
různé formáty souborů (PDF, Word, Excel, obrázky, zvuk) na Markdown.
-
– dotazování a analýza dat v databázích DuckDB místně a v cloudu.
-
– databázové operace a správa. Spouštět dotazy, spravovat kolekce, kanály agregace a operace dokumentů
-
– přístup k modelům, datovým sadám a Spaces na Hugging Face Hubu.
Možnosti přidání serveru MCP
V sadě Visual Studio máte několik možností, jak přidat server MCP.
Instalace z webu
S nejnovější servisní verzí verze 17.14 podporuje Visual Studio přímou instalaci serverů MCP. Můžete vybrat tlačítko Nainstalovat na serveru MCP a automaticky ho přidat do vaší instance sady Visual Studio.
Přidání tlačítka Instalovat pro server MCP
Napište konfiguraci serveru MCP ve formátu JSON.
Tady je příklad serveru HTTP/SSE:
{"name":"My Server","type":"http","url":"https://example.com/mcp/"}Tady je příklad serveru stdio:
{"name":"My Server","type":"stdio","command":"python","args":["-m","my_mcp.server"]}Povinná pole jsou:
Obor Description namePopisný název serveru typeTyp připojení k serveru, například httpnebostdiourlAdresa URL serveru vyžadovaná pro httpcommandPříkaz pro spuštění spustitelného souboru serveru vyžadovaný pro stdioargsPole argumentů předaných příkazu, povinné pro stdioZakódujte JSON pro použití v URL. Můžete použít online kodér nebo konzolu prohlížeče.
Tady je příklad konzoly prohlížeče:
encodeURIComponent('{"name":"My Server","type":"http","url":"https://example.com/mcp/"}')Vložte KÓD JSON kódovaný adresou URL do formátu URI MCP, který vytvoří odkaz pro instalaci sady Visual Studio. Použijte tento formát:
vsweb+mcp:/install?<ENCODED_JSON>Přidejte odznáček Markdown do úložiště nebo dokumentů GitHubu. Například:
[](vsweb+mcp:/install?<ENCODED_JSON>)
Když uživatel vybere odznáček, visual Studio se otevře (nebo vás vyzve k jeho otevření). Zobrazí se dialogové okno instalace MCP s předem vyplněnými podrobnostmi o serveru.
Přidat ze zobrazení chatu
Ve Visual Studio verze 17.14.13 nebo novější můžete přidat server MCP ze zobrazení chatu.
Přidání serveru MCP ze zobrazení chatu:
V okně chatu vyberte zelené tlačítko plus (
+) v nástroji.Zadejte název serveru a podrobnosti o připojení, například adresu URL pro servery HTTP nebo příkaz a argumenty pro servery stdio.
Vytvoření souboru pro správu konfigurace serverů MCP
Pokud soubor ještě mcp.json nemáte, vytvořte ho v libovolném z podporovaných umístění na základě požadavků na úložiště, uživatele nebo editor.
Pokud chcete přidat server MCP, vyhledejte online konfiguraci JSON serveru. Najdete ho například v úložišti GitHub pro servery MCP. Pak vložte do souboru mcp.json.
Umístění souborů pro automatické zjišťování konfigurace MCP
Visual Studio také kontroluje konfigurace MCP, které nastavují jiná vývojová prostředí. Konfigurace serveru MCP se čtou z následujících adresářů v následujícím pořadí:
-
%USERPROFILE%\.mcp.json
Slouží jako globální konfigurace serveru MCP pro konkrétního uživatele. Přidáním serveru MCP zde se zajistí jeho načítání pro všechna řešení Visual Studio. -
<SOLUTIONDIR>\.vs\mcp.json
Specifické pro Visual Studio a načte zadané servery MCP pouze pro konkrétního uživatele pro zadané řešení. -
<SOLUTIONDIR>\.mcp.json
Funguje dobře, pokud hledáte konfiguraci MCP, kterou můžete sledovat ve správě zdrojového kódu pro úložiště. -
<SOLUTIONDIR>\.vscode\mcp.json
Vymezený na úložiště nebo řešení a obvykle není řízen zdrojem. -
<SOLUTIONDIR>\.cursor\mcp.json
Vymezený na úložiště nebo řešení a obvykle není řízen zdrojem.
Některá z těchto umístění vyžadují .mcp.json, zatímco jiné vyžadují mcp.json.
Formát konfigurace MCP
Můžete definovat vzdálené servery (adresy URL i přihlašovací údaje) i místní servery (vyvolání příkazového řádku).
Je běžné volat nástroje prostřednictvím správců balíčků; například npx -y @azure/mcp@latest nebo docker run ... mcp/github. Visual Studio respektuje jakýkoli zadaný příkaz, takže můžete podle potřeby připnout verze nebo předat příznaky.
Formát musí odpovídat specifikaci MCP. Musí například obsahovat pole serverových objektů, každý s name, command nebo url, a transport.
Úprava konfigurace MCP
Když máte existující mcp.json soubor, přidejte umístění souboru do položek řešení v Průzkumníku řešení, pokud soubor kontrolujete do systému správy verzí.
Při uložení souboru s platnou syntaxí se agent GitHub Copilot restartuje a znovu načte nakonfigurované servery.
Životní cyklus nástrojů
Jakmile je server zjištěn nebo přidán:
- Visual Studio inicializuje server provedením metody handshake a dotazováním seznamu nástrojů.
- Visual Studio se přihlásí k odběru události
notifications/tools/list_changedMCP. - Když se tato událost aktivuje, Visual Studio resetuje všechna předchozí přijetí nebo oprávnění k nástrojům (aby se zabránilo útokům rug-pull), znovu načte seznam nástrojů a živě aktualizuje počet a rozhraní.
- Po úspěšném povolení serveru budou pro agenta k dispozici nástroje. Nástroje jsou ve výchozím nastavení zakázané a musí být povoleny ručně.
- Pokud se server odebere, Visual Studio okamžitě zastaví proces a stáhne všechny jeho nástroje z uživatelského rozhraní.
- Pokud upravíte definici serveru, Visual Studio ji ukončí a restartuje a pak se znovu dotazuje.
Správa schvalování nástrojů
Když je nástroj aktivován, Copilot požádá o potvrzení, že může nástroj spustit. Důvodem je, že nástroje můžou běžet místně na vašem počítači a provádět akce, které upravují soubory nebo data.
Po vyvolání nástroje v podokně chatu použijte možnosti rozevíracího seznamu Povolit . Můžete automaticky potvrdit konkrétní nástroj pro aktuální relaci, aktuální řešení nebo všechna budoucí vyvolání.
Výběry potvrzení nástroje můžete resetovat v podokně Možnosti>nástrojů, v části Všechna nastavení>GitHub>Copilot>Nástroje.
Výběry potvrzení nástroje můžete obnovit v dialogovém okně Nástroje>Možnosti ve skupině Nástroje v části GitHub>Copilot.
Správa autorizace
Visual Studio teď podporuje ověřování pro vzdálené servery s libovolným poskytovatelem OAuth v souladu se specifikací autorizace MCP. Tato podpora je navíc součástí integrace se sadou Klíčů sady Visual Studio.
Správa ověřování pro server MCP:
V souboru
.mcp.jsonzvolte v CodeLens Spravovat ověřování pro tento server.V automaticky otevíraných dialogových oknech prohlížeče zadejte přihlašovací údaje potřebného zprostředkovatele OAuth pro daný server.
Výzvy a šablony výzev MCP
Servery MCP můžou poskytovat opakovaně použitelné šablony výzev, které vám pomůžou efektivněji pracovat s jazykovými modely. Tyto výzvy jsou přizpůsobené konkrétním úkolům a můžou obsahovat přizpůsobitelné argumenty.
Použití výzev MCP
Jak odkazovat na výzvy ze serveru MCP:
- V chatu vyberte + Přidat odkaz .
- Vyberte Výzvy>MCP výzvy.
- Zvolte výzvu a vyberte Vložit výzvu.
Některé výzvy obsahují argumenty, které si můžete přizpůsobit před vložením do chatu. Tyto šablony se nazývají šablony promptů.
Příklad: Server MCP GitHubu poskytuje výzvy k analýze žádostí o přijetí změn, generování zpráv potvrzení a kontrole změn kódu.
Prostředky MCP a šablony prostředků MCP
Prostředky MCP poskytují kontext k jazykovým modelům, jako jsou soubory, schémata databáze nebo data specifická pro aplikaci. Každý prostředek má jedinečný identifikátor URI, na který můžete odkazovat v chatu.
Použití prostředků MCP
Odkazujte na prostředky MCP v chatu Copilot pomocí hashtagu (#) následovaného identifikátorem URI prostředku.
Pro prostředky s argumenty (šablony prostředků):
- Vyberte + Přidat odkaz v chatu.
- Vyberte prostředky MCP.
- Vyberte prostředek, vyplňte všechny požadované argumenty a vyberte Přidat prostředek.
Příklad: Server McP Azure DevOps zveřejňuje zdroje pracovních položek, informace o sprintu a data o kapacitě týmu pro úkoly plánování projektů.
Příklad: Server Figma MCP poskytuje přístup k prostředkům komponent návrhu, průvodcům stylu a specifikacím návrhu.
Vzorkování MCP
Vzorkování umožňuje serverům MCP provádět volání na LLM vaším jménem, což umožňuje složitější a vícekrokové operace. Visual Studio automaticky podporuje vzorkování, pokud ho váš server MCP poskytuje.
Když Copilot bude muset uskutečnit vzorový hovor, zobrazí se potvrzovací dialogové okno. Zkontrolujte podrobnosti a schvalte před zahájením akce a zajistěte kontrolu nad automatizovanými operacemi.
Příklad: Server PLAYwright MCP používá vzorkování k vygenerování testovacích scénářů na základě struktury DOM vaší aplikace a toků uživatelů.
Nejčastější dotazy
Jak můžu jako správce řídit používání serverů MCP v režimu agenta pro uživatele sady Visual Studio?
Nastavení zásad GitHubu na řídicím panelu GitHub Copilot pro správce řídí režim agenta a používání MCP v sadě Visual Studio. Pokud správce toto nastavení vypne, nemůžou uživatelé v tomto předplatném používat režim agenta ani se připojovat k serverům MCP v sadě Visual Studio.
Další informace najdete v tématu Správa zásad a funkcí pro GitHub Copilot ve vašem podniku.