https://chihhung.github.io/Blog/tags/mcp/Recent content in MCP on Eric 個人部落格Hugozh-TWFri, 31 Jul 2026 10:00:00 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/ai%E9%96%8B%E7%99%BC/anthropic-model-context-protocol-mcp-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/Fri, 09 Jan 2026 18:11:38 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/ai%E9%96%8B%E7%99%BC/anthropic-model-context-protocol-mcp-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/<blockquote> <p><strong>文件版本</strong>：2.0 <strong>對應規範</strong>：MCP Specification <code>2026-07-28</code>（正式版，2026-07-28 發布） <strong>前一規範</strong>：<code>2025-11-25</code>（相容性內容仍保留於本文） <strong>最後更新</strong>：2026 年 7 月 31 日 <strong>文件等級</strong>：企業標準技術白皮書 <strong>適用對象</strong>：資深軟體開發工程師、系統架構師、平台工程與資安治理人員 <strong>Created by</strong>：Eric Cheng</p></blockquote> <h1 id="anthropic-model-context-protocol-mcp-教學手冊">Anthropic Model Context Protocol (MCP) 教學手冊</h1> <blockquote> <p><strong>重大提醒</strong>：<code>2026-07-28</code> 是 MCP 自發布以來最大幅度的改版，<strong>包含破壞性變更（Breaking Changes）</strong>。 核心協議由「有狀態、雙向」轉為「無狀態、請求／回應」。<code>initialize</code> 交握、<code>Mcp-Session-Id</code> 與 SSE 續傳機制均已移除；Roots、Sampling、Logging 進入棄用（Deprecated）狀態。 詳見 <a href="#%E7%89%88%E6%9C%AC%E6%9B%B4%E6%96%B0%E6%91%98%E8%A6%812026-07-28-%E8%A6%8F%E7%AF%84%E9%87%8D%E9%BB%9E">版本更新摘要</a> 與 <a href="#%E7%AC%AC%E5%8D%81%E4%B8%80%E7%AB%A02026-07-28-%E9%81%B7%E7%A7%BB%E6%8C%87%E5%8D%97">第十一章</a>。</p></blockquote> <h2 id="目錄">目錄</h2> <ul> <li><a href="#%E7%89%88%E6%9C%AC%E6%9B%B4%E6%96%B0%E6%91%98%E8%A6%812026-07-28-%E8%A6%8F%E7%AF%84%E9%87%8D%E9%BB%9E">版本更新摘要：2026-07-28 規範重點</a> <ul> <li><a href="#01-%E4%B8%80%E9%A0%81%E5%BC%8F%E8%AE%8A%E6%9B%B4%E7%B8%BD%E8%A6%BD">0.1 一頁式變更總覽</a></li> <li><a href="#02-%E7%A0%B4%E5%A3%9E%E6%80%A7%E8%AE%8A%E6%9B%B4%E6%B8%85%E5%96%AE">0.2 破壞性變更清單</a></li> <li><a href="#03-%E6%A3%84%E7%94%A8%E5%8A%9F%E8%83%BD%E8%88%87%E7%94%9F%E5%91%BD%E9%80%B1%E6%9C%9F%E6%94%BF%E7%AD%96">0.3 棄用功能與生命週期政策</a></li> <li><a href="#04-%E6%9C%AC%E6%89%8B%E5%86%8A%E6%94%B9%E7%89%88%E8%AA%AA%E6%98%8E">0.4 本手冊改版說明</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%B8%80%E7%AB%A0mcp-%E6%A6%82%E8%BF%B0%E8%88%87%E6%A0%B8%E5%BF%83%E6%A6%82%E5%BF%B5">第一章：MCP 概述與核心概念</a> <ul> <li><a href="#11-%E4%BB%80%E9%BA%BC%E6%98%AF-mcp">1.1 什麼是 MCP？</a></li> <li><a href="#12-%E7%82%BA%E4%BB%80%E9%BA%BC%E9%9C%80%E8%A6%81-mcp">1.2 為什麼需要 MCP？</a></li> <li><a href="#13-mcp-%E6%9E%B6%E6%A7%8B%E6%A6%82%E8%A6%BD">1.3 MCP 架構概覽</a></li> <li><a href="#14-%E5%8D%94%E8%AD%B0%E6%BC%94%E9%80%B2%E5%8F%B2%E8%88%87%E7%89%88%E6%9C%AC%E6%B2%BB%E7%90%86">1.4 協議演進史與版本治理</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%BA%8C%E7%AB%A0mcp-%E6%8A%80%E8%A1%93%E6%9E%B6%E6%A7%8B%E6%B7%B1%E5%BA%A6%E8%A7%A3%E6%9E%90">第二章：MCP 技術架構深度解析</a> <ul> <li><a href="#21-%E5%88%86%E5%B1%A4%E6%9E%B6%E6%A7%8B">2.1 分層架構</a></li> <li><a href="#22-%E8%B3%87%E6%96%99%E5%B1%A4%E5%8D%94%E8%AD%B0data-layer-protocol">2.2 資料層協議（Data Layer Protocol）</a></li> <li><a href="#23-mcp-%E6%A0%B8%E5%BF%83%E5%8E%9F%E8%AA%9Eprimitives">2.3 MCP 核心原語（Primitives）</a></li> <li><a href="#24-%E9%80%9A%E7%9F%A5%E6%A9%9F%E5%88%B6%E8%88%87%E8%A8%82%E9%96%B1%E4%B8%B2%E6%B5%81notifications--subscriptions">2.4 通知機制與訂閱串流（Notifications &amp; Subscriptions）</a></li> <li><a href="#25-%E5%A4%9A%E8%BC%AA%E5%BE%80%E8%BF%94%E8%AB%8B%E6%B1%82multi-round-trip-requests-mrtr">2.5 多輪往返請求（Multi Round-Trip Requests, MRTR）</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%B8%89%E7%AB%A0%E5%82%B3%E8%BC%B8%E5%B1%A4%E6%B7%B1%E5%BA%A6%E8%A7%A3%E6%9E%90">第三章：傳輸層深度解析</a> <ul> <li><a href="#31-stdio-transport">3.1 STDIO Transport</a></li> <li><a href="#32-streamable-http-transport">3.2 Streamable HTTP Transport</a></li> <li><a href="#33-%E6%A8%99%E9%A0%AD%E8%B7%AF%E7%94%B1%E5%BF%AB%E5%8F%96%E8%88%87%E5%8F%AF%E8%A7%80%E6%B8%AC%E6%80%A7">3.3 標頭路由、快取與可觀測性</a></li> <li><a href="#34-%E5%82%B3%E8%BC%B8%E5%B1%A4%E7%9B%B8%E5%AE%B9%E6%80%A7%E7%AD%96%E7%95%A5">3.4 傳輸層相容性策略</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%9B%9B%E7%AB%A0%E5%AF%A6%E6%88%B0%E9%96%8B%E7%99%BC%E6%8C%87%E5%8D%97">第四章：實戰開發指南</a> <ul> <li><a href="#41-%E9%96%8B%E7%99%BC%E7%92%B0%E5%A2%83%E8%A8%AD%E7%BD%AE">4.1 開發環境設置</a></li> <li><a href="#42-%E9%96%8B%E7%99%BC-mcp-server">4.2 開發 MCP Server</a></li> <li><a href="#43-%E9%96%8B%E7%99%BC-mcp-client">4.3 開發 MCP Client</a></li> <li><a href="#44-%E6%95%B4%E5%90%88%E5%88%B0-ai-%E6%87%89%E7%94%A8">4.4 整合到 AI 應用</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%BA%94%E7%AB%A0%E5%AE%8C%E6%95%B4%E5%AF%A6%E6%88%B0%E7%AF%84%E4%BE%8B">第五章：完整實戰範例</a> <ul> <li><a href="#51-%E7%AF%84%E4%BE%8B%E4%B8%80%E6%AA%94%E6%A1%88%E7%B3%BB%E7%B5%B1-mcp-server">5.1 範例一：檔案系統 MCP Server</a></li> <li><a href="#52-%E7%AF%84%E4%BE%8B%E4%BA%8C%E8%B3%87%E6%96%99%E5%BA%AB%E6%9F%A5%E8%A9%A2-mcp-server">5.2 範例二：資料庫查詢 MCP Server</a></li> <li><a href="#53-%E7%AF%84%E4%BE%8B%E4%B8%89api-%E6%95%B4%E5%90%88-mcp-server">5.3 範例三：API 整合 MCP Server</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%85%AD%E7%AB%A0%E6%9C%80%E4%BD%B3%E5%AF%A6%E8%B8%90%E8%88%87%E8%A8%AD%E8%A8%88%E6%A8%A1%E5%BC%8F">第六章：最佳實踐與設計模式</a> <ul> <li><a href="#61-mcp-server-%E8%A8%AD%E8%A8%88%E5%8E%9F%E5%89%87">6.1 MCP Server 設計原則</a></li> <li><a href="#62-%E6%95%88%E8%83%BD%E5%84%AA%E5%8C%96">6.2 效能優化</a></li> <li><a href="#63-%E5%AE%89%E5%85%A8%E6%80%A7%E8%80%83%E9%87%8F">6.3 安全性考量</a></li> <li><a href="#64-%E6%B8%AC%E8%A9%A6%E7%AD%96%E7%95%A5">6.4 測試策略</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%B8%83%E7%AB%A0%E9%80%B2%E9%9A%8E%E4%B8%BB%E9%A1%8C">第七章：進階主題</a> <ul> <li><a href="#71-tasks-%E6%93%B4%E5%85%85iomodelcontextprotocoltasks">7.1 Tasks 擴充（io.modelcontextprotocol/tasks）</a></li> <li><a href="#72-%E8%87%AA%E8%A8%82%E5%82%B3%E8%BC%B8%E5%B1%A4">7.2 自訂傳輸層</a></li> <li><a href="#73-%E5%A4%9A%E8%AA%9E%E8%A8%80-sdk-%E6%AF%94%E8%BC%83">7.3 多語言 SDK 比較</a></li> <li><a href="#74-%E5%81%B5%E9%8C%AF%E8%88%87%E7%9B%A3%E6%8E%A7">7.4 偵錯與監控</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%85%AB%E7%AB%A0%E7%96%91%E9%9B%A3%E6%8E%92%E8%A7%A3">第八章：疑難排解</a> <ul> <li><a href="#81-%E5%B8%B8%E8%A6%8B%E9%8C%AF%E8%AA%A4%E8%88%87%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%A1%88">8.1 常見錯誤與解決方案</a></li> <li><a href="#82-%E9%99%A4%E9%8C%AF%E6%8A%80%E5%B7%A7">8.2 除錯技巧</a></li> <li><a href="#83-%E9%8C%AF%E8%AA%A4%E8%A8%8A%E6%81%AF%E5%8F%83%E8%80%83">8.3 錯誤訊息參考</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E4%B9%9D%E7%AB%A0%E5%AF%A6%E9%9A%9B%E6%A1%88%E4%BE%8B%E7%A0%94%E7%A9%B6">第九章：實際案例研究</a> <ul> <li><a href="#91-%E6%A1%88%E4%BE%8B%E4%B8%80%E4%BC%81%E6%A5%AD%E7%9F%A5%E8%AD%98%E5%BA%AB-mcp-server">9.1 案例一：企業知識庫 MCP Server</a></li> <li><a href="#92-%E6%A1%88%E4%BE%8B%E4%BA%8Cdevops-%E6%95%B4%E5%90%88-mcp-server">9.2 案例二：DevOps 整合 MCP Server</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%8D%81%E7%AB%A0%E8%B3%87%E6%BA%90%E8%88%87%E5%8F%83%E8%80%83">第十章：資源與參考</a> <ul> <li><a href="#101-%E5%AE%98%E6%96%B9%E8%B3%87%E6%BA%90">10.1 官方資源</a></li> <li><a href="#102-%E7%A4%BE%E7%BE%A4%E8%B3%87%E6%BA%90">10.2 社群資源</a></li> <li><a href="#103-%E9%96%8B%E7%99%BC%E7%92%B0%E5%A2%83%E5%BB%BA%E8%AD%B0">10.3 開發環境建議</a></li> <li><a href="#104-%E7%89%88%E6%9C%AC%E7%9B%B8%E5%AE%B9%E6%80%A7">10.4 版本相容性</a></li> <li><a href="#105-%E5%BF%AB%E9%80%9F%E5%8F%83%E8%80%83">10.5 快速參考</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%8D%81%E4%B8%80%E7%AB%A02026-07-28-%E9%81%B7%E7%A7%BB%E6%8C%87%E5%8D%97">第十一章：2026-07-28 遷移指南</a> <ul> <li><a href="#111-%E9%81%B7%E7%A7%BB%E7%B8%BD%E9%AB%94%E7%AD%96%E7%95%A5">11.1 遷移總體策略</a></li> <li><a href="#112-server-%E7%AB%AF%E9%81%B7%E7%A7%BB%E6%AD%A5%E9%A9%9F">11.2 Server 端遷移步驟</a></li> <li><a href="#113-client-%E7%AB%AF%E9%81%B7%E7%A7%BB%E6%AD%A5%E9%A9%9F">11.3 Client 端遷移步驟</a></li> <li><a href="#114-%E5%BE%9E-session-%E5%88%B0%E9%A1%AF%E5%BC%8F%E6%8F%A1%E6%9F%84explicit-handle">11.4 從 Session 到顯式握柄（Explicit Handle）</a></li> <li><a href="#115-%E9%9B%99%E6%99%82%E4%BB%A3dual-era%E7%9B%B8%E5%AE%B9%E9%83%A8%E7%BD%B2">11.5 雙時代（Dual-era）相容部署</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%8D%81%E4%BA%8C%E7%AB%A0%E6%93%B4%E5%85%85%E6%A1%86%E6%9E%B6%E8%88%87%E5%AE%98%E6%96%B9%E6%93%B4%E5%85%85">第十二章：擴充框架與官方擴充</a> <ul> <li><a href="#121-%E6%93%B4%E5%85%85%E6%A1%86%E6%9E%B6extensions-framework">12.1 擴充框架（Extensions Framework）</a></li> <li><a href="#122-mcp-apps%E4%BC%BA%E6%9C%8D%E5%99%A8%E6%B8%B2%E6%9F%93%E4%BA%92%E5%8B%95%E4%BB%8B%E9%9D%A2">12.2 MCP Apps：伺服器渲染互動介面</a></li> <li><a href="#123-tasks-%E6%93%B4%E5%85%85%E6%B7%B1%E5%85%A5%E8%A7%A3%E6%9E%90">12.3 Tasks 擴充深入解析</a></li> <li><a href="#124-%E4%BC%81%E6%A5%AD%E8%A8%97%E7%AE%A1%E6%8E%88%E6%AC%8Aema%E8%88%87-oauth-%E6%93%B4%E5%85%85">12.4 企業託管授權（EMA）與 OAuth 擴充</a></li> <li><a href="#125-%E8%87%AA%E5%BB%BA%E7%AC%AC%E4%B8%89%E6%96%B9%E6%93%B4%E5%85%85">12.5 自建第三方擴充</a></li> </ul> </li> <li><a href="#%E7%AC%AC%E5%8D%81%E4%B8%89%E7%AB%A0%E4%BC%81%E6%A5%AD%E7%B4%9A%E9%83%A8%E7%BD%B2%E8%88%87%E6%B2%BB%E7%90%86">第十三章：企業級部署與治理</a> <ul> <li><a href="#131-%E7%84%A1%E7%8B%80%E6%85%8B%E6%B0%B4%E5%B9%B3%E6%93%B4%E5%B1%95%E6%9E%B6%E6%A7%8B">13.1 無狀態水平擴展架構</a></li> <li><a href="#132-api-%E9%96%98%E9%81%93waf-%E8%88%87%E9%80%9F%E7%8E%87%E9%99%90%E5%88%B6">13.2 API 閘道、WAF 與速率限制</a></li> <li><a href="#133-%E6%8E%88%E6%AC%8A%E7%A1%AC%E5%8C%96%E8%88%87%E8%BA%AB%E5%88%86%E6%B2%BB%E7%90%86">13.3 授權硬化與身分治理</a></li> <li><a href="#134-%E5%8F%AF%E8%A7%80%E6%B8%AC%E6%80%A7%E8%88%87-opentelemetry">13.4 可觀測性與 OpenTelemetry</a></li> <li><a href="#135-%E4%B8%80%E8%87%B4%E6%80%A7%E9%A9%97%E8%AD%89%E8%88%87-sdk-%E5%88%86%E7%B4%9A">13.5 一致性驗證與 SDK 分級</a></li> </ul> </li> <li><a href="#%E9%99%84%E9%8C%84%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AEchecklist">附錄：檢查清單（Checklist）</a> <ul> <li><a href="#a-server-%E9%96%8B%E7%99%BC%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AE">A. Server 開發檢查清單</a></li> <li><a href="#b-%E9%83%A8%E7%BD%B2%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AE">B. 部署檢查清單</a></li> <li><a href="#c-%E7%A8%8B%E5%BC%8F%E7%A2%BC%E5%AF%A9%E6%9F%A5%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AE">C. 程式碼審查檢查清單</a></li> <li><a href="#d-%E6%95%85%E9%9A%9C%E6%8E%92%E9%99%A4%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AE">D. 故障排除檢查清單</a></li> <li><a href="#e-2026-07-28-%E9%81%B7%E7%A7%BB%E6%AA%A2%E6%9F%A5%E6%B8%85%E5%96%AE">E. 2026-07-28 遷移檢查清單</a></li> </ul> </li> <li><a href="#%E7%B5%90%E8%AA%9E">結語</a></li> <li><a href="#%E5%8F%83%E8%80%83%E6%96%87%E7%8D%BB%E8%88%87%E5%BB%B6%E4%BC%B8%E9%96%B1%E8%AE%80">參考文獻與延伸閱讀</a> <ul> <li><a href="#%E5%AE%98%E6%96%B9%E8%A6%8F%E7%AF%842026-07-28">官方規範（2026-07-28）</a></li> <li><a href="#%E6%B2%BB%E7%90%86%E8%88%87%E6%B5%81%E7%A8%8B">治理與流程</a></li> <li><a href="#%E5%AE%98%E6%96%B9%E6%93%B4%E5%85%85">官方擴充</a></li> <li><a href="#%E5%AE%98%E6%96%B9%E9%83%A8%E8%90%BD%E6%A0%BC">官方部落格</a></li> <li><a href="#%E7%A4%BE%E7%BE%A4%E5%88%86%E6%9E%90">社群分析</a></li> <li><a href="#%E7%9B%B8%E9%97%9C%E6%A8%99%E6%BA%96">相關標準</a></li> <li><a href="#%E4%B8%BB%E8%A6%81-sep-%E7%B4%A2%E5%BC%95">主要 SEP 索引</a></li> </ul> </li> </ul> <hr> <h2 id="版本更新摘要2026-07-28-規範重點">版本更新摘要：2026-07-28 規範重點</h2> <h3 id="01-一頁式變更總覽">0.1 一頁式變更總覽</h3> <p><code>2026-07-28</code> 由六份以上的 SEP（Specification Enhancement Proposal）共同構成，將 MCP 從 「為單機 stdio 情境設計的有狀態雙向協議」重塑為「可在通用 HTTP 基礎設施上水平擴展的無狀態 請求／回應協議」。以下為與前一版 <code>2025-11-25</code> 的對照總覽。</p>