MCP

文件版本：2.0 對應規範：MCP Specification 2026-07-28（正式版，2026-07-28 發布） 前一規範：2025-11-25（相容性內容仍保留於本文） 最後更新：2026 年 7 月 31 日 文件等級：企業標準技術白皮書 適用對象：資深軟體開發工程師、系統架構師、平台工程與資安治理人員 Created by：Eric Cheng Anthropic Model Context Protocol (MCP) 教學手冊 重大提醒：2026-07-28 是 MCP 自發布以來最大幅度的改版，包含破壞性變更（Breaking Changes）。 核心協議由「有狀態、雙向」轉為「無狀態、請求／回應」。initialize 交握、Mcp-Session-Id 與 SSE 續傳機制均已移除；Roots、Sampling、Logging 進入棄用（Deprecated）狀態。 詳見 版本更新摘要 與 第十一章。 目錄 版本更新摘要：2026-07-28 規範重點 0.1 一頁式變更總覽 0.2 破壞性變更清單 0.3 棄用功能與生命週期政策 0.4 本手冊改版說明 第一章：MCP 概述與核心概念 1.1 什麼是 MCP？ 1.2 為什麼需要 MCP？ 1.3 MCP 架構概覽 1.4 協議演進史與版本治理 第二章：MCP 技術架構深度解析 2.1 分層架構 2.2 資料層協議（Data Layer Protocol） 2.3 MCP 核心原語（Primitives） 2.4 通知機制與訂閱串流（Notifications & Subscriptions） 2.5 多輪往返請求（Multi Round-Trip Requests, MRTR） 第三章：傳輸層深度解析 3.1 STDIO Transport 3.2 Streamable HTTP Transport 3.3 標頭路由、快取與可觀測性 3.4 傳輸層相容性策略 第四章：實戰開發指南 4.1 開發環境設置 4.2 開發 MCP Server 4.3 開發 MCP Client 4.4 整合到 AI 應用 第五章：完整實戰範例 5.1 範例一：檔案系統 MCP Server 5.2 範例二：資料庫查詢 MCP Server 5.3 範例三：API 整合 MCP Server 第六章：最佳實踐與設計模式 6.1 MCP Server 設計原則 6.2 效能優化 6.3 安全性考量 6.4 測試策略 第七章：進階主題 7.1 Tasks 擴充（io.modelcontextprotocol/tasks） 7.2 自訂傳輸層 7.3 多語言 SDK 比較 7.4 偵錯與監控 第八章：疑難排解 8.1 常見錯誤與解決方案 8.2 除錯技巧 8.3 錯誤訊息參考 第九章：實際案例研究 9.1 案例一：企業知識庫 MCP Server 9.2 案例二：DevOps 整合 MCP Server 第十章：資源與參考 10.1 官方資源 10.2 社群資源 10.3 開發環境建議 10.4 版本相容性 10.5 快速參考 第十一章：2026-07-28 遷移指南 11.1 遷移總體策略 11.2 Server 端遷移步驟 11.3 Client 端遷移步驟 11.4 從 Session 到顯式握柄（Explicit Handle） 11.5 雙時代（Dual-era）相容部署 第十二章：擴充框架與官方擴充 12.1 擴充框架（Extensions Framework） 12.2 MCP Apps：伺服器渲染互動介面 12.3 Tasks 擴充深入解析 12.4 企業託管授權（EMA）與 OAuth 擴充 12.5 自建第三方擴充 第十三章：企業級部署與治理 13.1 無狀態水平擴展架構 13.2 API 閘道、WAF 與速率限制 13.3 授權硬化與身分治理 13.4 可觀測性與 OpenTelemetry 13.5 一致性驗證與 SDK 分級 附錄：檢查清單（Checklist） A. Server 開發檢查清單 B. 部署檢查清單 C. 程式碼審查檢查清單 D. 故障排除檢查清單 E. 2026-07-28 遷移檢查清單 結語 參考文獻與延伸閱讀 官方規範（2026-07-28） 治理與流程 官方擴充 官方部落格 社群分析 相關標準 主要 SEP 索引 版本更新摘要：2026-07-28 規範重點 0.1 一頁式變更總覽 2026-07-28 由六份以上的 SEP（Specification Enhancement Proposal）共同構成，將 MCP 從 「為單機 stdio 情境設計的有狀態雙向協議」重塑為「可在通用 HTTP 基礎設施上水平擴展的無狀態 請求／回應協議」。以下為與前一版 2025-11-25 的對照總覽。 ...