GitHub Copilot 配置 MCP 伺服器(.vscode/mcp.json)與貼截圖生代碼實戰指南

把其他工具的 mcp.json 拷進 VS Code 為什麼識別不到?本文詳解 .vscode/mcp.json 的頂層 servers 與安全彈窗 inputs 語法、Agent 工具勾選上限,以及粘貼 UI 截圖聯動 MCP 生成前後端代碼的完整步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Pro 帳號

在 VS Code 裏完成了基礎的 GitHub Copilot 登入配置並開啟了 Agent 智能體模式之後,很多開發者想讓 Copilot 直接連上自家的 PostgreSQL 測試庫、讀取 GitHub Issue 或調用 Playwright 瀏覽器做介面自檢。

VS Code 現已原生內置模型上下文協議(Model Context Protocol,簡稱 MCP)支持,並允許在對話框裏直接粘貼或拖入介面截圖(Vision 視覺能力)。不過很多同學第一步就把配置文件寫錯了——直接把其他編輯器裏的 JSON 粘過來會發現一個工具都刷不出來。下面帶你一次配通。

本站開發者訂閱直達入口:高頻跑多文件重構與工具鏈調用時,搭配固定月費的主力訂閱往往比純燒按量 API 更省錢。國內無境外信用卡可通過支付寶、微信支付或 AlipayHK 在本站免密自助開通 Claude Code 訂閱(Pro / Max)、ChatGPT Plus 或瀏覽 AI 會員充值總覽。

一、避開第一大坑:VS Code 頂層鍵名是 servers 而不是 mcpServers

如果你之前在 Claude Desktop 或 Cursor 裏配過 MCP,一定對頂層的 "mcpServers": { ... } 結構很熟。但在 VS Code 的工作區配置文件 .vscode/mcp.json 中,官方規範採用了不同的頂層字段設計,並且原生加入了防泄密的交互式輸入變量("inputs")。

VS Code 與其他工具 MCP JSON 鍵名區別

千萬不要把個人 Token 硬編碼寫進要提交 Git 的配置文件裏。推薦直接在項目根目錄新建 .vscode/mcp.json,按照下面的官方標準結構編寫:

json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "github-pat",
      "description": "請輸入你的 GitHub Personal Access Token",
      "password": true
    }
  ],
  "servers": {
    "filesystem-docs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}/docs"]
    },
    "github-repo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github-pat}"
      }
    }
  }
}

這套寫法有兩個非常實用的工程細節:

  1. 安全共享不漏密鑰:"inputs" 聲明瞭一個密碼型輸入框("password": true)。你可以放心地把這個 .vscode/mcp.json 提交到團隊倉庫,同事拉下代碼首次啟動服務時,VS Code 頂部會自動彈出密碼框讓他填入自己的 Token,密鑰只安全緩存在本機,絕不會寫回 JSON 文件。
  2. 支持遠程 HTTP / SSE 服務:如果你連接的是團隊部署在內網的遠程 MCP 網關,只需把 "type" 改成 "http"(或 "sse"),把 command 換成 "url": "https://mcp.internal.example.com/mcp" 並附上請求頭即可。

二、啟動 MCP 服務並在 Agent 模式勾選工具

寫好配置文件後,按下面四步把工具真正掛載進對話流:

在 VS Code 給 Copilot 配 MCP 四步

  1. 點擊編輯器內嵌的 Start 啟動按鈕:打開 .vscode/mcp.json 文件時,VS Code 會在每個服務名正上方渲染一行小字 CodeLens 按鈕(Start | Stop | Restart)。點一下 Start,狀態變成 Running 並顯示已發現的工具數量(如 12 tools)即代表握手成功。你也可以按 Ctrl+Shift+P(macOS 為 Cmd+Shift+P)運行 MCP: List Servers 集中查看運行日誌。
  2. 必須切到 Agent 模式:打開右側 Copilot Chat 面板,將輸入框左下角的模式下拉選單從 Ask 或 Edit 切換為 Agent(普通問答模式不會主動調用外部 MCP 動作)。
  3. 點開工具圖標(Tools Picker)按需勾選:點擊輸入框旁邊的扳手/工具箱小圖標,你會看到剛才啟動的 MCP 伺服器及其下屬的所有子工具。
  4. 控制單次掛載工具總數:VS Code 對單次請求同時開啟的工具數量設有上限(通常建議控制在幾十個高相關工具以內,上限為 128 個)。如果掛了四五個龐大的全量服務,把平時根本用不上的刪除類、管理類子工具取消勾選,既能防止超出上限報錯,也能大幅提高模型選對工具的準確率。如果你想把固定工具調用順序固化下來,還可以配合 VS Code Copilot 的 Agent Skills 技能文件一起用。
重度編碼配額與雙引擎互補建議:在開源插件或終端智能體裏處理大型單體倉庫時,不少工程師會同時備好一套包月封頂的官方訂閱兜底複雜架構攻堅。可按需前往查看 Claude Max 5x / 20x 充值說明、Claude Pro iOS 自助卡密 或 ChatGPT Pro 充值頁。

三、貼截圖生代碼(Vision)+ MCP 全棧聯動實戰

配置好 MCP 後,再疊加上 Copilot Chat 的多模態識圖(Vision)能力,改前端頁面和對接口的效率會翻倍:

場景 1:拖入設計稿或舊網頁截圖還原組件

不用費口舌描述“左邊放個圓角卡片、右上角帶藍色狀態徽章”。直接用系統截圖快捷鍵截下 Figma 局部設計稿(或競品網頁佈局),在 Copilot Chat 輸入框直接按 Ctrl+V(Cmd+V)粘貼,或者點回形針圖標 Add Context 選擇本地圖片,然後輸入:

text
請嚴格參照我粘貼的這張介面截圖的排版層級與間距,複用當前項目 src/components/ui 下的現有基礎組件和 Tailwind 主題變量,新建 OrderSummaryCard.tsx。如果數據庫字段不確定,先調用已連接的數據庫 MCP 工具查詢 orders 表的真實列名,不要自己瞎編字段名。

場景 2:截下瀏覽器控制檯錯位圖讓它自己對帳修復

遇到移動端響應式溢出、彈窗層級遮擋這類純文字很難形容的樣式 Bug,把瀏覽器渲染壞掉的畫面連同 DevTools 元素面板截成一張圖粘進對話框,Agent 就能一邊看圖定位錯位容器,一邊直接修改項目裏的 CSS / Tailwind 類名。

日常寫全棧項目時,很多工程師除了用 VS Code 裏的 Copilot 做行內補全,遇到跨十幾個文件的複雜後端重構還會搭配獨立的終端智能體或多模態大模型交叉審校。需要開通海外主流開發訂閱的同學,可前往查看貝果研究社 Claude Code 訂閱與配置方案以及 ChatGPT Plus 自助充值專頁。

常見問題

為什麼點 Start 後立刻報錯 spawn npx ENOENT?

這是因為 VS Code 桌面進程啟動時沒有繼承你終端裏的 Node.js 環境變量(常見於用 nvm、fnm 或 volta 管理多版本 Node 的電腦)。最穩的解決辦法是在終端跑一下 which npx(Windows 跑 where.exe npx)拿到完整絕對路徑,或者從配置好環境變量的終端裏敲 code . 重新喚起 VS Code。

每次智能體調用 MCP 工具都要點確認,能設自動放行嗎?

出於安全防禦考慮,預設情況下外部 MCP 工具每次執行前都會彈出參數預覽卡片讓你點 Continue。確認某個本地只讀查詢工具(如查文檔庫或讀測試表結構)絕對無害後,你可以點 Continue 按鈕旁的小箭頭,選擇在當前會話自動允許該工具或在當前工作區始終允許;但涉及刪改線上數據或發外部請求的寫操作工具,務必保留人工確認。

國內沒有海外信用卡,怎麼開通 Claude Code 或 ChatGPT 編程訂閱?

可直接在 本站充值中心 使用支付寶、微信支付或 AlipayHK 下單獲取自助卡密,支持免上號兌換 Claude Pro、Claude Max 與 ChatGPT Plus / Pro,可開具增值稅發票;實時價格、兌換前提與售後邊界(封號不在質保範圍)以對應商品頁說明為準。

小結

  1. VS Code 的 .vscode/mcp.json 頂層服務鍵名必須寫 "servers"(而非 "mcpServers"),配合 "inputs" 彈窗填密鑰可安全提交倉庫團隊共享。
  2. 只有在 Copilot Chat 切換到 Agent 模式並在工具選擇器裏勾選對應服務後,模型才會自動調用 MCP,注意精簡無用子工具避免超限。
  3. 直接粘貼 UI 稿或錯位截圖配合數據庫/文檔 MCP,能讓智能體同時“看懂視覺樣式”與“對齊真實後端字段”,減少前後端返工。

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    GitHub Copilot Pro、Pro+ 與 Business 怎麼選:高級請求倍率、AI Credits 扣費與超額預算上限

    GitHub Copilot 個人 Pro($10)、Pro+($39)與組織 Business($19/席位)怎麼選?本文按官方文檔講清從舊版高級請求(Premium Requests)倍率到 AI Credits 計費的對應關係、各檔額度及防超支預算上限設定。

    GitHub Copilot0
  2. 02

    GitHub Copilot Next Edit Suggestions(NES 下一步編輯預測)開啟、快捷鍵與降噪設定

    改了一個函數參數名,剩下七八處調用點還要自己滾屏一個個改?本文詳解 VS Code GitHub Copilot 的 Next Edit Suggestions(NES 下一步編輯預測)與傳統幽靈補全的本質區別、開啟設定項、連按兩次 Tab 跨行跳轉與採納手勢,以及嫌提示太吵時的降噪配置。

    GitHub Copilot0
  3. 03

    GitHub Copilot 提示無法連接到服務怎麼辦:could not connect to server、ETIMEDOUT、證書錯誤的官方排查辦法

    Copilot 提示 could not connect to server、read ETIMEDOUT 或證書錯誤,多與代理、防火牆有關。本文按 GitHub 官方網絡錯誤排查文檔,講 curl 測連通性、代理與認證限制、證書錯誤處理和公司網絡放行清單。

    GitHub Copilot0
  4. 04

    GitHub Copilot 報錯「Language model unavailable」怎麼辦:VS Code 團隊說的頭號原因,以及怎麼收集診斷資訊

    VS Code 裏 Copilot Chat 提示 Language model unavailable,官方沒有單獨說明。本文按 VS Code 團隊的說法講頭號原因(公司防火牆沒放行新端點)、怎麼看 Failed to fetch models、運行 Chat Diagnostics。

    GitHub Copilot0
  5. 05

    copilot-instructions.md 怎麼寫:用途、範例、按路徑生效的 instructions 文件與 AGENTS.md 的區別

    copilot-instructions.md 是什麼、放哪、怎麼寫?按 GitHub 官方文檔講清倉庫級指令、.github/instructions 下按路徑生效的 *.instructions.md(applyTo / excludeAgent)、AGENTS.md 三者的分工,附可改寫的中文範例與不生效排查。

    GitHub Copilot0
  6. 06

    GitHub Copilot CLI 安裝與使用:npm / winget / brew 安裝、登入、常用指令與工具權限

    GitHub Copilot CLI 怎麼安裝、怎麼用?按官方文檔講清三種安裝方式(npm 需 Node.js 22+)、/login 登入與令牌登入、交互模式常用快捷鍵、copilot -p 非交互調用,以及 --allow-tool / --deny-tool 工具權限的寫法。

    GitHub Copilot0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~