MCP 深度整合、效能與成本調校

這一章把「MCP 接得夠不夠聰明」跟「這一切到底要花多少錢」放在同一章講——因為兩件事其實是同一枚硬幣的兩面：你開的每一個工具、每一次自動壓縮對話、每一輪往返，最後都會變成帳單上的一個數字。

想像你家裡的電費帳單。插座（MCP 伺服器）越多、插著的家電（工具）越多，用電量在帳單寄來之前你根本看不出來——直到某個月帳單突然變厚，你才回頭想「上個月是不是多插了什麼」。Copilot CLI 到這個階段也是同一個道理：第 9 章教你怎麼把 MCP 接上去，這一章要教你的是「接上去之後，怎麼接得精、接得省、接得安全」，外加一段這系列教學裡時效性最短的內容——2026 年 6 月才剛發生的計費制度大轉型。

這一章你會學到：

• MCP 設定檔到底該放在哪裡：不只第 9 章教過的 ~/.copilot/mcp-config.json，還有兩個「專案層」的位置；
• 一個從 VS Code 直接複製設定檔過來、會整段靜默陣亡的踩雷；
• local／http／sse 三種連線型態的完整欄位表，加上官方 GitHub MCP server 的手動接法示範；
• /mcp 互動指令跟 copilot mcp 終端子指令的完整對照表；
• 對話拉得夠長時，Copilot CLI 怎麼自動幫你「精簡記憶」，以及官方文件自己都沒講清楚的一個小矛盾；
• MCP 工具的「說明書」本身也在吃 token，怎麼精簡；
• Copilot CLI 獨有的內建省錢顧問 /chronicle cost-tips；
• 2026 年 6 月才剛發生的計費大地震：從「premium request」變成「AI Credits」，你的帳單邏輯怎麼被重新設計；
• Free／Pro／Pro+／Business／Enterprise 各方案能不能用 CLI、額度差多少；
• 你自己能設的安全防線——--allow-tool／--deny-tool、trusted_folders、持久化權限設定，以及一句老實話：這些是縱深防禦的一層，不是絕對保險箱。

15.1 MCP 設定檔完整地圖：不只一個地方能放

第 9 章教過最基本的一條路：手動編輯使用者層級的 ~/.copilot/mcp-config.json。這一節把完整地圖攤開——原來這份設定其實有三個可能的落腳處，範圍一個比一個窄：

三個檔案彼此不衝突、可以同時存在——使用者層放你個人跨專案都想用的伺服器，專案層或儲存庫層放「這個專案 team 共用」的伺服器定義。.github/mcp.json 適合共享不含憑證、已審查的 command、URL 與 tools；每位成員仍要自行設定最小權限憑證，提交前也要再次審查定義內容。

15.2 別把 VS Code 的 MCP 設定直接複製過來：兩個地雷

如果你同時是 VS Code 裡 GitHub Copilot 擴充套件的使用者，手上很可能已經有一份寫好的 MCP 設定——這時候最直覺的動作就是把那份設定複製貼進 Copilot CLI。先別急著貼，這裡有兩個會讓設定整段靜默失效的地雷。

地雷一：.vscode/mcp.json 的舊支援已經被移除

Copilot CLI 曾經 best-effort 讀取 VS Code 慣用的 .vscode/mcp.json 路徑，但那個支援並不完整，現在已經被移除。如果你的專案是照 VS Code 的慣例，把 MCP 設定放在 .vscode/mcp.json，Copilot CLI 現在不會再讀到它——你得手動把內容搬到本章 15.1 講的 .mcp.json 或 .github/mcp.json。

地雷二：頂層鍵名不一樣——servers 對 mcpServers

即使你已經把檔案搬到正確位置，還有一個更容易忽略的細節：VS Code 的設定檔頂層鍵名是 servers，Copilot CLI 要的是 mcpServers。 同樣的概念、同樣的結構，就差這一個鍵名，直接把 VS Code 的 JSON 整份貼過來、只是換個檔名放進 Copilot CLI 認得的路徑，那個鍵名對不上，Copilot CLI 完全讀不到裡面任何一個伺服器設定。

15.3 三種連線型態完整攤開：local／http／sse

第 9 章的範例已經示範過 local 跟 http 兩種型態的基本寫法，這裡把三種型態的完整欄位攤開來對照：

官方逐字範例（跟第 9 章看過的是同一份）：

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": { "CONTEXT7_API_KEY": "${COPILOT_MCP_CONTEXT7_API_KEY}" },
      "tools": ["*"]
    }
  }
}

請勿把真實金鑰寫入這份 JSON。${COPILOT_MCP_CONTEXT7_API_KEY} 只是受支援的 secret／環境變數參照示意；若你的 MCP 設定來源不能安全展開，改用該服務的 OAuth 或本機／CI secret 機制，不要把 header 連同實值 commit。

tools 欄位的白名單寫法，第 9 章教過三種："*"（全開）、逗號分隔清單（只開列出的）、""（全關但保留設定）——這裡再提醒一次，因為 15.6 節省 token 的關鍵動作就是靠它。

sse 是被官方明講「已棄用」的傳輸方式

官方對 sse 型態的原文警語相當直接：「使用已棄用的伺服器發送事件傳輸，但仍支援向後相容。」 翻成白話：這個型態能用、目前也還支援，但官方自己都講明是舊的、正在被淘汰的東西——語氣上暗示未來真的有可能整個移除。

15.4 互動指令與終端機子指令完整對照表

MCP 伺服器的日常管理，Copilot CLI 給了兩條路——互動畫面裡打斜線指令，或是寫進腳本的終端機子指令，兩邊做的事是同一組，只是介面不同。

互動模式：/mcp 系列

終端機模式：copilot mcp 子指令

copilot mcp list [--json]
copilot mcp get SERVER-NAME [--json]
copilot mcp remove SERVER-NAME
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]
copilot mcp add --transport http SERVER-NAME URL
copilot mcp add SERVER-NAME -e KEY=VALUE -- COMMAND [ARGS...]
copilot mcp add --transport http --header "Header: Value" SERVER-NAME URL

--json 這個旗標值得特別記住：想寫腳本批次盤點多台機器上接了哪些伺服器，copilot mcp list --json 給的是機器可讀的結構化輸出，比自己 parse 互動畫面的文字輸出可靠得多。

進階情境：自架 GitHub MCP 與需要認證的 HTTP server

這是進階情境。先選 OAuth 等不必把 PAT 放到命令列的方式；使用者、CI 與可提交設定檔都不應直接保存 token。

# GitHub 原生 HTTP MCP 走 OAuth，不需在命令列填 PAT
copilot mcp add --transport http github https://api.githubcopilot.com/mcp/

# 需要自訂 header 的 server：先確認它支援安全的 secret 注入。
# 不要把 token 填入 --header、-e 或任何可提交設定檔。

GitHub 自家的官方 MCP server 也有原生的 HTTP endpoint：https://api.githubcopilot.com/mcp/，認證方式標記為 auth = "oauth"——這是 Copilot CLI 跟 GitHub 生態系整合最深的入口，走 OAuth 授權流程，不需要你自己手動管理 PAT token 的存放與輪替，是比上面 header-based PAT 方案更省心的接法。

15.5 效能：對話拉長之後，context 怎麼自動幫你「精簡」

長 session 聊久了，逼近 context window 上限是遲早的事。Copilot CLI 遇到這種情況，會在背景自動把對話歷史壓縮成摘要，保留大約 20% 的緩衝空間讓工具呼叫能繼續跑、不至於卡住。壓縮後的摘要維持「連續性」——它記得你們討論過什麼、已經決定了什麼、下一步該做什麼，即使原始的逐字訊息已經被摘要取代。

一個誠實的矛盾：觸發門檻官方自己講法不一致

查證這一段時發現一個小矛盾，值得老實告訴你：一份官方頁面（context 管理相關）描述觸發時機大約在 80%（留 20% 緩衝）；另一份文件（changelog 相關報導）卻描述大約 95%。這種百分比數字本來就會隨版本迭代常常在變，本書不建議你把任何一個數字背下來、更不要寫進自動化判斷邏輯。

手動管理：/compact 與 /context

/compact
/context

/context 讓你隨時查看目前 session 的 context 用量；/compact 是手動觸發壓縮，不用等自動壓縮找上門。

15.6 MCP 工具的「說明書」本身也要付 token 錢

接的 MCP 伺服器越多、每個伺服器暴露的工具越多，Copilot CLI 在你打字之前，就已經要把每一個工具的 schema 說明塞進 context——工具越多、schema 描述越肥，system prompt 就越大，不只是額外成本，還會讓 Copilot 在挑工具時的判斷更容易失準。

直接對策，跟 15.1、15.3 節提過的 tools 欄位是同一招——只暴露你真的會用到的工具，不要整台伺服器全開：

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "auth": "oauth",
      "tools": ["list_issues", "get_pull_request", "search_code"]
    }
  }
}

15.7 /chronicle cost-tips：Copilot CLI 獨有的內建省錢顧問

這是 Copilot CLI 在這系列教學裡一個明顯的差異化特色——其他兩套工具都得靠你自己 grep log 才能大概估算 token 花在哪，Copilot CLI 直接內建一個成本分析指令。

機制：Copilot CLI 把每次 session 的結構化資料——你送出的 prompt、它的回覆、用了哪些工具、改了哪些檔案——記錄進一份本機 SQLite「session store」。/chronicle 系列指令，就是基於這份本機資料庫運作的。

/chronicle cost-tips

/chronicle cost-tips 會分析你近期的 session，找出「token 到底都花去哪裡了」，並且給出具體的省 token／省成本建議。這是互動 CLI session 專屬的功能——VS Code 端的 Copilot 沒有這個指令。

前提：需要事先啟用本機 session tracking，不過多數系統預設就已經開著，通常不用你額外設定。

15.8 計費大地震：從「Premium Requests」到「AI Credits」（2026-06-01 起）

這是全篇時效性最短、最需要謹慎標注「以官方最新頁面為準」的一段——距離本章查證基準日 2026-07-18，這個轉型才剛發生約六週。

轉型前：Premium Requests（legacy，僅維持年約的舊戶還在用）

官方逐字對這份 legacy 文件的適用範圍講得很明確：

This article only applies to Copilot Pro and Copilot Pro+ subscribers on an existing annual plan who remained on legacy premium request-based billing after June 1, 2026.

翻成白話：只有維持年約、沒有轉換方案的 Copilot Pro／Pro+ 舊戶，才還適用這一套規則。 舊制的運作邏輯：

• 每個模型有各自的 premium request multiplier（依模型複雜度與資源消耗不同，倍數不同），額度按倍數扣；
• Copilot CLI 官方逐字：「Each prompt to Copilot CLI uses one premium request with the default model. For other models, this is multiplied by the model's rate.」——用預設模型，一次提問扣一個 premium request；換用其他模型，依那個模型的倍率往上乘；
• 舊制月額度（legacy 方案數字，非現行）：Pro 300 個／月、Pro+ 1500 個／月；
• 額度用完，仍可繼續用內建模型，但回應可能變慢、被 rate limit，也可以用 $0.04／個加購。

轉型後：現行制度（2026-06-01 起，絕大多數方案適用）

官方逐字：「All GitHub Copilot plans will transition to usage-based billing on June 1, 2026.」

現行制度重點：

• Premium Request Units（PRU）被 GitHub AI Credits 取代；
• 計價依據實際 token 消耗——input token、output token、cached token 都算，依各模型的 API 費率換算，最後轉成 AI credits；
• 匯率固定：1 AI credit = $0.01 USD；
• 各方案內含的月度 AI credits 額度：Pro 內含 $10、Pro+ 內含 $39、Business 內含 $19／user、Enterprise 內含 $39／user；
• 年約舊戶（annual Pro/Pro+）維持舊制直到合約到期，才會轉換到新制；
• 2026 年五月初曾推出「preview bill」，讓使用者跟管理員在正式轉型前先看到預估費用。

Free 方案：CLI 用得到，但撐不起大師篇這種工作流

Copilot CLI 本身有包含在 Free 方案內，但額度非常有限：月 50 次 agent mode／chat 請求、2000 次程式碼補全，只能用 Claude Haiku 3.5、GPT-4o mini 這類受限模型（不能自選模型）。

15.9 各方案速覽：CLI 可用性與額度差異

15.10 安全設定：你自己能設的防線（但不是絕對保險箱）

第 9 章提過 MCP 工具的核准機制，跟第 7 章教過的 approval／sandbox 是同一套。這一節整理你自己能主動設定的幾層防線。

--allow-tool / --deny-tool：deny 永遠優先

# 只允許這幾個工具/子指令
copilot --allow-tool "git status,git diff"

# 明確拒絕某個工具，即使前面允許了也一樣被擋
copilot --allow-tool "*" --deny-tool "rm"

• --allow-tool / --deny-tool：逗號分隔的工具／子指令清單；
• --deny-tool 的優先權永遠高於 --allow-tool，即使你同時開了 --allow-all 也一樣——deny 是最後一道、蓋過一切的否決權；
• 這兩個旗標只作用於當次 session，不會被寫進下面會提到的 permissions-config.json，關掉終端機重開一次就得重下；
• --allow-all：全域允許，但語意上仍是「逐工具核可」邏輯的全開，跟 Autopilot（見第 14 章）的「多步自主不停」是不同層次的東西，兩者不要混為一談。

持久化設定檔：這幾份會留在你的機器上

這三份跟 --allow-tool／--deny-tool 的差別在於持久性：命令列旗標只管這一次 session，這三份設定檔則是「記住這件事、下次不用再問一次」的長期記錄。

誠實的收尾：這是縱深防禦的一層，不是絕對沙箱

即使把上面這些防線都設好，第 14 章會提到 2026 年上半年多篇第三方安全研究揭露的漏洞——資料夾信任瞬間的 MCP server 自動執行、env 指令繞過白名單驗證、Git hook 執行檔搜尋順序劫持——都提醒我們一件事：這些設定是縱深防禦的一層，不是萬無一失的沙箱保證。

本章小結

這一章把 MCP 深度整合、效能調校、成本管理三件事收攏在一起講。你學會了 MCP 設定檔的完整地圖——不只第 9 章教過的使用者層 ~/.copilot/mcp-config.json，還有專案層的 .mcp.json 與儲存庫層的 .github/mcp.json；也認清了從 VS Code 直接搬設定過來會踩到的兩個地雷（.vscode/mcp.json 支援已移除、servers 跟 mcpServers 鍵名不同）。你看懂了 local／http／sse 三種連線型態的完整欄位，以及 /mcp 互動指令跟 copilot mcp 終端子指令的完整對照表，包括官方 GitHub MCP server 的 OAuth 接法。效能面，你知道了 context window 接近上限時會自動壓縮（觸發門檻官方講法本身有 80% 跟 95% 兩種不一致的說法，誠實以 /context 實機數字為準），也知道 MCP 工具的 schema 本身要付 token 錢，對策一樣是白名單。你認識了 Copilot CLI 獨有的 /chronicle cost-tips 省錢顧問。最重頭的一段是計費制度的重大轉型——2026 年 6 月 1 日起，多數方案從「premium requests」轉成「AI Credits」token 計價新制，年約舊戶維持舊制到合約到期，Copilot CLI 在新制下的精確扣費公式官方文件仍未逐字寫明。最後你認識了各方案的可用性差異，以及自己能設的安全防線——--allow-tool／--deny-tool（deny 永遠優先）、trusted_folders、持久化的 permissions-config.json——並且老實面對這些防線是縱深防禦的一層，不是絕對沙箱。

動手試試

1. 檢查一下你目前的專案有沒有 .vscode/mcp.json——如果有，照 15.2 節的做法，把內容搬到 .mcp.json 或 .github/mcp.json，並確認頂層鍵名已經改成 mcpServers。
2. 打 copilot mcp list --json，看看你目前接了哪些伺服器，跟互動模式的 /mcp show 結果對照一下。
3. 找一個你手上工具數量偏多的 MCP 伺服器，用 tools 欄位只留下你真的常用的兩三個，感受一下 15.6 節講的「精簡 schema」實際上怎麼做。
4. 讓對話拉得夠長（或直接打 /context 看目前用量），觀察看看接近上限時 Copilot CLI 是不是真的自動幫你壓縮了；也自己主動打一次 /compact 比較兩者的差異。
5. 打 /chronicle cost-tips，看看它針對你最近的 session 給了什麼建議——如果這是你第一次用 Copilot CLI，這個指令可能還沒有足夠的歷史資料可以分析，先記住這個指令的存在，累積幾次 session 後再回來試。
6. 翻一下你自己的帳單頁面（或組織管理員的帳務後台），確認你目前的方案是舊制年約還是已經轉入新制的 AI Credits，親自感受一次本章講的轉型在你自己帳號上長什麼樣子。

本章官方文件參考

• MCP 伺服器設定（第 9 章、本章共用主要來源）：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers
• 遷移 .vscode/mcp.json 公告（Microsoft 官方部落格）：https://techcommunity.microsoft.com/blog/educatordeveloperblog/action-required-migrate-your-copilot-cli-mcp-config-away-from-vscodemcp-json/4531562
• /chronicle 指令：https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle
• 計費轉型公告：https://github.blog/news-insights/company-news/github-copilot-is-moving-to-usage-based-billing/
• Premium Requests（legacy 文件）：https://docs.github.com/en/billing/concepts/product-billing/github-copilot-premium-requests
• Copilot Requests（legacy 文件）：https://docs.github.com/en/copilot/concepts/billing/copilot-requests
• 方案與價格：https://docs.github.com/en/copilot/get-started/plans
• CLI 設定目錄參考（trusted_folders／permissions-config.json／settings.json 位置）：https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference