MCP / ACP 协议与工具生态

课程目标

讲清价值：为何需要标准工具协议，而不是每个 Agent 手写 HTTP。
能集成：跑通 1 个 MCP Server + 1 个客户端（IDE 或自研 Agent）。
会排障：超时、schema、传输方式、版本、权限。
ACP：能说明与 MCP 的使用边界（若你所在生态在用 ACP，按官方定义更新本节）。

概念对齐

概念	你要能一句话解释
Tool	模型可调用的能力，带 schema
Resource	可读上下文（文件、URI）
Transport	stdio / Streamable HTTP（旧 HTTP+SSE 已弃用）
治理	白名单、审计、敏感操作二次确认

10 天学习路径

Day1：问题动机

任务：列「无协议时」的 5 个痛点（重复集成、难发现、难审计）。
验收：向非技术干系人讲 1 分钟价值。

Day2：阅读规范目录

任务：通读 MCP 规范目录与术语；记版本号。
验收：画 client-host-server 三角。

Day3：stdio 模式

任务：本地起一个官方示例 server；观察启动参数与日志。
验收：解释 stdio 适用场景（本机工具）。

Day4：Streamable HTTP 与旧传输迁移

任务：读 Streamable HTTP 约束；列出从 HTTP+SSE 迁移时与企业网关的冲突点。
验收：记录公司网络下需要的白名单。

Day5：在 Agent 中挂载

任务：在你现有 LangChain/LangGraph 或 IDE 中启用工具列表。
验收：成功调用 1 次读资源 + 1 次工具。

Day6：权限模型

任务：设计工具分级：只读 / 写内部 / 写外部 / 资金相关。
验收：哪些必须人工批准。

Day7：schema 与兼容

任务：故意改坏一个参数类型，看错误信息；写修复流程。
验收：版本 pin 策略（lock server/client）。

Day8：观测

任务：为每次工具调用打 trace：name、latency、success、truncated。
验收：与 llmops-observability-evaluation 字段对齐。

Day9：ACP 与行业协议（补充）

任务：若目标公司提 ACP，查阅其官方定义；写「与 MCP 是否互斥/互补」。
验收：避免面试张冠李戴——以官方为准。

Day10：面试稿

任务：6 分钟：企业为何上 MCP；治理；一次排障故事。

排障 Checklist（可贴 wiki）

传输是否匹配（stdio vs 远程）
版本是否 lock
JSON schema 是否一致
超时与重试
权限与令牌
日志是否脱敏

常见陷阱

把 MCP 当「万能远程代码执行」，不做白名单。
工具描述含糊导致模型乱调用。
无超时，卡死整个会话。

实操验收

1 次 MCP 接入笔记（步骤 + 截图或日志节选）
mcp-integration-notes.md + 排障 checklist

深度专题：从消费者到生产者 —— MCP Server 工程化

面试里能说"我做过一个 MCP Server 并接入 Claude Desktop / Cursor"比"我知道 MCP"值 2 倍薪水。以下是把协议知识升级为生产级 Server 的完整工程栈。

0. 2026-07-28 正式规范：无状态核心与扩展机制

2026 年 7 月 28 日，MCP 2026-07-28 正式规范发布。它相对 2025-11-25 含有破坏性变化；新实现应以最终 changelog 与所用 SDK 的兼容说明为准，而不是继续照搬 RC 或旧握手示例：

无状态核心 (Stateless Protocol Core)：移除 initialize / initialized 握手和 Mcp-Session-Id。客户端可先调用 server/discover，每个请求携带协议版本、客户端信息与能力；Streamable HTTP 请求使用 Mcp-Method / Mcp-Name，便于普通网关路由和无粘性会话的水平扩展。
Tasks 异步长任务生命周期：此前的实验能力转为官方扩展。Server 可从 tools/call 返回 task handle，Client 使用 tasks/get、tasks/update、tasks/cancel 驱动生命周期；tasks/list 因无会话条件下难以安全划分范围而被移除。
MCP Apps：Server 可提供交互式 HTML，由 Host 在 sandboxed iframe 中呈现；UI 发起的动作仍经过统一的 JSON-RPC、授权、同意和审计路径。
可路由、可缓存、可追踪：列表和资源结果增加 ttlMs / cacheScope，并约定 W3C Trace Context 在 _meta 中的传播方式。
安全与弃用策略：授权响应中的 iss 若存在必须与已记录 issuer 严格比较；新实现优先使用 Client ID Metadata Documents。Roots、Sampling、Logging 和旧 HTTP+SSE 已进入弃用生命周期，但不是在本版本中立即删除。

1. Tool / Resource / Prompt 三种边界

抽象	含义	典型例子	误用
Tool	模型可调用的"动作"，有副作用或强计算	`create_order` / `run_sql` / `send_email`	把"只读查询"也包成 Tool（浪费轮次）
Resource	可 URI 定位的"可读上下文"	`file://...` / `git://repo/path` / `kb://doc-123`	把"搜索"做成 Resource（搜索是动作，应做 Tool）
Prompt	预置工作流模板	`/review-pr` / `/daily-standup`	把动态参数塞进 Prompt 却不做校验

裁决口诀："取数据用 Resource，做事用 Tool，固定流程用 Prompt"。

2. Authorization（2026-07-28 规范）

HTTP 传输的 MCP Authorization 基于 OAuth 2.1 及一组既有 RFC；stdio 通常从环境获取凭据，不直接照搬浏览器授权流程。务必掌握：

OAuth 2.1：PKCE 强制、去掉隐式流、refresh token 轮换。
Resource Indicators（RFC 8707）：Token 必须绑定 aud=mcp-server-id，防止跨 server token 重放。
Scope 设计：tools:read / tools:execute:low / tools:execute:high 分级；不要一个 mcp:all。
客户端注册优先级：优先 Client ID Metadata Documents 或预注册；Dynamic Client Registration（RFC 7591）仅为兼容保留，已弃用。
Issuer 校验：客户端记录可信 metadata 中的 issuer；授权响应携带 iss 时必须做严格字符串比较，声明支持却缺失时拒绝。
Token audience check：Server 收到 token 必须校验 token 受众；客户端不得把为其他资源签发的 token 转发给 MCP Server。

def verify_token(raw: str) -> Principal:
    claims = jwt.decode(raw, JWKS, audience="mcp://orders-server",
                        issuer="https://auth.acme.com")
    if claims["scope"].split().count("tools:execute:high") == 0:
        raise HttpError(403, "insufficient scope")
    return Principal(sub=claims["sub"], tid=claims["tid"], scopes=claims["scope"].split())

面试陷阱："Bearer token 够用吗？" —— 不够。要 aud 绑定 + scope 分级 + 敏感工具二次挑战（step-up auth）。

3. Tool schema 设计规范

{
  "name": "create_refund",
  "title": "创建退款单",
  "description": "对指定订单发起退款。需要订单 ID 与金额；金额必须小于等于订单实付金额。",
  "inputSchema": {
    "type": "object",
    "required": ["order_id", "amount", "reason"],
    "properties": {
      "order_id": {"type": "string", "pattern": "^ORD-[0-9]{10}$"},
      "amount":   {"type": "number", "exclusiveMinimum": 0, "maximum": 100000},
      "reason":   {"type": "string", "minLength": 5, "maxLength": 500}
    },
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false
  }
}

要点：

description 写给模型看：动作、前置条件、金额/权限边界。不要写"如何调用"。
annotations：destructiveHint=true 的工具客户端会默认要求人审。
pattern / enum / min / max 尽量塞进 schema，防止模型瞎编参数。
additionalProperties: false 必加；否则模型会塞垃圾字段。

4. Schema 版本演进（不破坏客户端）

v1.0.0 初版
v1.1.0 新增可选字段 currency       ← 兼容
v1.2.0 annotations 更新描述         ← 兼容
v2.0.0 reason 由 optional 变 required ← 破坏

策略：

非破坏升级：minor bump，客户端自动适配。
破坏升级：同时保留 create_refund_v1 + create_refund_v2，并行 30-90 天再下线。
在 serverInfo 里带 protocolVersion 与 tools[].version。

5. 错误码与超时约定

所有错误走 JSON-RPC 标准：

Code	含义	典型场景
-32600	Invalid Request	协议层畸形
-32601	Method not found	工具不存在
-32602	Invalid params	schema 校验不通过
-32000 ~ -32019	实现自定义区段	业务错（细分，现有 SDK 用法保留）
-32020 ~ -32099	MCP 规范保留	不要分配给业务错误

业务层自定义：

{"code": -32010, "message": "order.not_found", "data": {"orderId": "ORD-..."}}
{"code": -32011, "message": "permission.denied", "data": {"requiredScope": "tools:execute:high"}}
{"code": -32012, "message": "rate.limited", "data": {"retryAfterMs": 1500}}

Timeout：每个 Tool 在 schema 里声明 x-timeout-ms（非标准但常用），客户端据此显示 loading；Server 侧硬超时。

6. Rate Limit / 并发控制

按 principal.sub + tool.name 双维度限流：令牌桶。
重试返回 Retry-After；客户端应指数退避。
并发危险工具（如发邮件）用分布式锁或数据库幂等键。

7. 危险工具审批策略

@tool(
    name="create_refund",
    annotations=Annotations(destructive=True),
)
def create_refund(order_id: str, amount: float, reason: str, ctx: Ctx):
    if amount > ctx.principal.auto_approve_limit:
        return require_approval(
            approver=ctx.principal.manager_id,
            payload={"order_id": order_id, "amount": amount},
        )
    return do_refund(order_id, amount, reason)

审批回调与 agent-state-persistence-hitl 的 interrupt 对齐。
审批决策与执行必须记录在 WORM 日志（见 ai-application-security 合规章）。

8. 测试夹具（Test Fixtures）

# 伪代码：具体方法名以所用 SDK 的 2026-07-28 迁移文档为准
@pytest.fixture
def mcp_client():
    server = subprocess.Popen(["python", "-m", "myserver"], stdin=PIPE, stdout=PIPE)
    client = StdioMCPClient(server)
    discovery = client.discover(
        protocol_version="2026-07-28",
        client_info={"name": "contract-tests", "version": "1.0.0"},
    )
    assert "2026-07-28" in discovery.supported_protocol_versions
    yield client
    server.terminate()
 
def test_create_refund_requires_scope(mcp_client, token_readonly):
    mcp_client.authenticate(token_readonly)
    resp = mcp_client.call_tool("create_refund", {"order_id": "ORD-1", "amount": 1, "reason": "test"})
    assert resp.error.code == -32011
 
def test_schema_rejects_negative_amount(mcp_client, token_admin):
    mcp_client.authenticate(token_admin)
    resp = mcp_client.call_tool("create_refund", {"order_id": "ORD-1", "amount": -1, "reason": "bug"})
    assert resp.error.code == -32602

合约测试：用 jsonschema 校验每个 Tool 的 request/response。
录放测试：录一次真实对话回放，检测 schema 退化。
fuzz：随机生成 input，确认 server 不崩。

9. 发布与客户端发现

打包：Python pip install mcp-server-orders；Node npx mcp-server-orders。
清单：提供 mcp.json，Claude Desktop / Cursor / Continue 可一键安装。
注册中心（企业内部）：自建 registry，列出所有 MCP Server 与 owner / scope / SLO。

10. 观测字段（与 LLMOps 对齐）

每次工具调用写 trace：

{
  "trace_id": "...", "span_id": "...",
  "server": "orders-mcp", "tool": "create_refund",
  "principal": "u-123", "tenant": "acme",
  "scope_used": "tools:execute:high",
  "input_hash": "sha256:...", "output_truncated": false,
  "latency_ms": 420, "status": "ok",
  "approval_id": "appr-456"
}

11. 工程化追问（面试版）

scope 如何切？ — 按动作类型 + 风险等级二维：read/write × low/medium/high。
Token 跨 server 泄漏怎么防？ — aud 绑定 + 短有效期 + refresh rotation。
schema 破坏性升级怎么灰度？ — 并行新旧版本 + 客户端遥测版本分布 + 统一下线。
Tool 描述怎么写模型才会正确选用？ — 明确前置条件、典型用法、不要交叉描述多工具。
怎么证明你的 MCP Server 生产可用？ — 合约测试 + fuzz + 录放 + SLO 仪表盘 + 回滚预案。

课程目标

讲清价值：为何需要标准工具协议，而不是每个 Agent 手写 HTTP。
能集成：跑通 1 个 MCP Server + 1 个客户端（IDE 或自研 Agent）。
会排障：超时、schema、传输方式、版本、权限。
ACP：能说明与 MCP 的使用边界（若你所在生态在用 ACP，按官方定义更新本节）。

概念对齐

概念	你要能一句话解释
Tool	模型可调用的能力，带 schema
Resource	可读上下文（文件、URI）
Transport	stdio / Streamable HTTP（旧 HTTP+SSE 已弃用）
治理	白名单、审计、敏感操作二次确认

10 天学习路径

Day1：问题动机

任务：列「无协议时」的 5 个痛点（重复集成、难发现、难审计）。
验收：向非技术干系人讲 1 分钟价值。

Day2：阅读规范目录

任务：通读 MCP 规范目录与术语；记版本号。
验收：画 client-host-server 三角。

Day3：stdio 模式

任务：本地起一个官方示例 server；观察启动参数与日志。
验收：解释 stdio 适用场景（本机工具）。

Day4：Streamable HTTP 与旧传输迁移

任务：读 Streamable HTTP 约束；列出从 HTTP+SSE 迁移时与企业网关的冲突点。
验收：记录公司网络下需要的白名单。

Day5：在 Agent 中挂载

任务：在你现有 LangChain/LangGraph 或 IDE 中启用工具列表。
验收：成功调用 1 次读资源 + 1 次工具。

Day6：权限模型

任务：设计工具分级：只读 / 写内部 / 写外部 / 资金相关。
验收：哪些必须人工批准。

Day7：schema 与兼容

任务：故意改坏一个参数类型，看错误信息；写修复流程。
验收：版本 pin 策略（lock server/client）。

Day8：观测

任务：为每次工具调用打 trace：name、latency、success、truncated。
验收：与 llmops-observability-evaluation 字段对齐。

Day9：ACP 与行业协议（补充）

任务：若目标公司提 ACP，查阅其官方定义；写「与 MCP 是否互斥/互补」。
验收：避免面试张冠李戴——以官方为准。

Day10：面试稿

任务：6 分钟：企业为何上 MCP；治理；一次排障故事。

排障 Checklist（可贴 wiki）

传输是否匹配（stdio vs 远程）
版本是否 lock
JSON schema 是否一致
超时与重试
权限与令牌
日志是否脱敏

常见陷阱

把 MCP 当「万能远程代码执行」，不做白名单。
工具描述含糊导致模型乱调用。
无超时，卡死整个会话。

实操验收

1 次 MCP 接入笔记（步骤 + 截图或日志节选）
mcp-integration-notes.md + 排障 checklist

深度专题：从消费者到生产者 —— MCP Server 工程化

面试里能说"我做过一个 MCP Server 并接入 Claude Desktop / Cursor"比"我知道 MCP"值 2 倍薪水。以下是把协议知识升级为生产级 Server 的完整工程栈。

0. 2026-07-28 正式规范：无状态核心与扩展机制

无状态核心 (Stateless Protocol Core)：移除 initialize / initialized 握手和 Mcp-Session-Id。客户端可先调用 server/discover，每个请求携带协议版本、客户端信息与能力；Streamable HTTP 请求使用 Mcp-Method / Mcp-Name，便于普通网关路由和无粘性会话的水平扩展。
Tasks 异步长任务生命周期：此前的实验能力转为官方扩展。Server 可从 tools/call 返回 task handle，Client 使用 tasks/get、tasks/update、tasks/cancel 驱动生命周期；tasks/list 因无会话条件下难以安全划分范围而被移除。
MCP Apps：Server 可提供交互式 HTML，由 Host 在 sandboxed iframe 中呈现；UI 发起的动作仍经过统一的 JSON-RPC、授权、同意和审计路径。
可路由、可缓存、可追踪：列表和资源结果增加 ttlMs / cacheScope，并约定 W3C Trace Context 在 _meta 中的传播方式。
安全与弃用策略：授权响应中的 iss 若存在必须与已记录 issuer 严格比较；新实现优先使用 Client ID Metadata Documents。Roots、Sampling、Logging 和旧 HTTP+SSE 已进入弃用生命周期，但不是在本版本中立即删除。

1. Tool / Resource / Prompt 三种边界

抽象	含义	典型例子	误用
Tool	模型可调用的"动作"，有副作用或强计算	`create_order` / `run_sql` / `send_email`	把"只读查询"也包成 Tool（浪费轮次）
Resource	可 URI 定位的"可读上下文"	`file://...` / `git://repo/path` / `kb://doc-123`	把"搜索"做成 Resource（搜索是动作，应做 Tool）
Prompt	预置工作流模板	`/review-pr` / `/daily-standup`	把动态参数塞进 Prompt 却不做校验

裁决口诀："取数据用 Resource，做事用 Tool，固定流程用 Prompt"。

2. Authorization（2026-07-28 规范）

HTTP 传输的 MCP Authorization 基于 OAuth 2.1 及一组既有 RFC；stdio 通常从环境获取凭据，不直接照搬浏览器授权流程。务必掌握：

OAuth 2.1：PKCE 强制、去掉隐式流、refresh token 轮换。
Resource Indicators（RFC 8707）：Token 必须绑定 aud=mcp-server-id，防止跨 server token 重放。
Scope 设计：tools:read / tools:execute:low / tools:execute:high 分级；不要一个 mcp:all。
客户端注册优先级：优先 Client ID Metadata Documents 或预注册；Dynamic Client Registration（RFC 7591）仅为兼容保留，已弃用。
Issuer 校验：客户端记录可信 metadata 中的 issuer；授权响应携带 iss 时必须做严格字符串比较，声明支持却缺失时拒绝。
Token audience check：Server 收到 token 必须校验 token 受众；客户端不得把为其他资源签发的 token 转发给 MCP Server。

def verify_token(raw: str) -> Principal:
    claims = jwt.decode(raw, JWKS, audience="mcp://orders-server",
                        issuer="https://auth.acme.com")
    if claims["scope"].split().count("tools:execute:high") == 0:
        raise HttpError(403, "insufficient scope")
    return Principal(sub=claims["sub"], tid=claims["tid"], scopes=claims["scope"].split())

面试陷阱："Bearer token 够用吗？" —— 不够。要 aud 绑定 + scope 分级 + 敏感工具二次挑战（step-up auth）。

3. Tool schema 设计规范

{
  "name": "create_refund",
  "title": "创建退款单",
  "description": "对指定订单发起退款。需要订单 ID 与金额；金额必须小于等于订单实付金额。",
  "inputSchema": {
    "type": "object",
    "required": ["order_id", "amount", "reason"],
    "properties": {
      "order_id": {"type": "string", "pattern": "^ORD-[0-9]{10}$"},
      "amount":   {"type": "number", "exclusiveMinimum": 0, "maximum": 100000},
      "reason":   {"type": "string", "minLength": 5, "maxLength": 500}
    },
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false
  }
}

要点：

description 写给模型看：动作、前置条件、金额/权限边界。不要写"如何调用"。
annotations：destructiveHint=true 的工具客户端会默认要求人审。
pattern / enum / min / max 尽量塞进 schema，防止模型瞎编参数。
additionalProperties: false 必加；否则模型会塞垃圾字段。

4. Schema 版本演进（不破坏客户端）

v1.0.0 初版
v1.1.0 新增可选字段 currency       ← 兼容
v1.2.0 annotations 更新描述         ← 兼容
v2.0.0 reason 由 optional 变 required ← 破坏

策略：

非破坏升级：minor bump，客户端自动适配。
破坏升级：同时保留 create_refund_v1 + create_refund_v2，并行 30-90 天再下线。
在 serverInfo 里带 protocolVersion 与 tools[].version。

5. 错误码与超时约定

所有错误走 JSON-RPC 标准：

Code	含义	典型场景
-32600	Invalid Request	协议层畸形
-32601	Method not found	工具不存在
-32602	Invalid params	schema 校验不通过
-32000 ~ -32019	实现自定义区段	业务错（细分，现有 SDK 用法保留）
-32020 ~ -32099	MCP 规范保留	不要分配给业务错误

业务层自定义：

{"code": -32010, "message": "order.not_found", "data": {"orderId": "ORD-..."}}
{"code": -32011, "message": "permission.denied", "data": {"requiredScope": "tools:execute:high"}}
{"code": -32012, "message": "rate.limited", "data": {"retryAfterMs": 1500}}

Timeout：每个 Tool 在 schema 里声明 x-timeout-ms（非标准但常用），客户端据此显示 loading；Server 侧硬超时。

6. Rate Limit / 并发控制

按 principal.sub + tool.name 双维度限流：令牌桶。
重试返回 Retry-After；客户端应指数退避。
并发危险工具（如发邮件）用分布式锁或数据库幂等键。

7. 危险工具审批策略

@tool(
    name="create_refund",
    annotations=Annotations(destructive=True),
)
def create_refund(order_id: str, amount: float, reason: str, ctx: Ctx):
    if amount > ctx.principal.auto_approve_limit:
        return require_approval(
            approver=ctx.principal.manager_id,
            payload={"order_id": order_id, "amount": amount},
        )
    return do_refund(order_id, amount, reason)

审批回调与 agent-state-persistence-hitl 的 interrupt 对齐。
审批决策与执行必须记录在 WORM 日志（见 ai-application-security 合规章）。

8. 测试夹具（Test Fixtures）

# 伪代码：具体方法名以所用 SDK 的 2026-07-28 迁移文档为准
@pytest.fixture
def mcp_client():
    server = subprocess.Popen(["python", "-m", "myserver"], stdin=PIPE, stdout=PIPE)
    client = StdioMCPClient(server)
    discovery = client.discover(
        protocol_version="2026-07-28",
        client_info={"name": "contract-tests", "version": "1.0.0"},
    )
    assert "2026-07-28" in discovery.supported_protocol_versions
    yield client
    server.terminate()
 
def test_create_refund_requires_scope(mcp_client, token_readonly):
    mcp_client.authenticate(token_readonly)
    resp = mcp_client.call_tool("create_refund", {"order_id": "ORD-1", "amount": 1, "reason": "test"})
    assert resp.error.code == -32011
 
def test_schema_rejects_negative_amount(mcp_client, token_admin):
    mcp_client.authenticate(token_admin)
    resp = mcp_client.call_tool("create_refund", {"order_id": "ORD-1", "amount": -1, "reason": "bug"})
    assert resp.error.code == -32602

合约测试：用 jsonschema 校验每个 Tool 的 request/response。
录放测试：录一次真实对话回放，检测 schema 退化。
fuzz：随机生成 input，确认 server 不崩。

9. 发布与客户端发现

打包：Python pip install mcp-server-orders；Node npx mcp-server-orders。
清单：提供 mcp.json，Claude Desktop / Cursor / Continue 可一键安装。
注册中心（企业内部）：自建 registry，列出所有 MCP Server 与 owner / scope / SLO。

10. 观测字段（与 LLMOps 对齐）

每次工具调用写 trace：

{
  "trace_id": "...", "span_id": "...",
  "server": "orders-mcp", "tool": "create_refund",
  "principal": "u-123", "tenant": "acme",
  "scope_used": "tools:execute:high",
  "input_hash": "sha256:...", "output_truncated": false,
  "latency_ms": 420, "status": "ok",
  "approval_id": "appr-456"
}

11. 工程化追问（面试版）

scope 如何切？ — 按动作类型 + 风险等级二维：read/write × low/medium/high。
Token 跨 server 泄漏怎么防？ — aud 绑定 + 短有效期 + refresh rotation。
schema 破坏性升级怎么灰度？ — 并行新旧版本 + 客户端遥测版本分布 + 统一下线。
Tool 描述怎么写模型才会正确选用？ — 明确前置条件、典型用法、不要交叉描述多工具。
怎么证明你的 MCP Server 生产可用？ — 合约测试 + fuzz + 录放 + SLO 仪表盘 + 回滚预案。

学完这篇你应该拿到什么

3 个高频追问

1 个证据

沉淀表达

面试时怎么讲

简历一句话

课程目标

概念对齐

10 天学习路径

Day1：问题动机

Day2：阅读规范目录

Day3：stdio 模式

Day4：Streamable HTTP 与旧传输迁移

Day5：在 Agent 中挂载

Day6：权限模型

Day7：schema 与兼容

Day8：观测

Day9：ACP 与行业协议（补充）

Day10：面试稿

排障 Checklist（可贴 wiki）

常见陷阱

实操验收

深度专题：从消费者到生产者 —— MCP Server 工程化

0. 2026-07-28 正式规范：无状态核心与扩展机制

1. Tool / Resource / Prompt 三种边界

2. Authorization（2026-07-28 规范）

3. Tool schema 设计规范

4. Schema 版本演进（不破坏客户端）

5. 错误码与超时约定

6. Rate Limit / 并发控制

7. 危险工具审批策略

8. 测试夹具（Test Fixtures）

9. 发布与客户端发现

10. 观测字段（与 LLMOps 对齐）

11. 工程化追问（面试版）

最新资料（2026-07-29 校验）

学完这篇你应该拿到什么

3 个高频追问

1 个证据

沉淀表达

面试时怎么讲

简历一句话

课程目标

概念对齐

10 天学习路径

Day1：问题动机

Day2：阅读规范目录

Day3：stdio 模式

Day4：Streamable HTTP 与旧传输迁移

Day5：在 Agent 中挂载

Day6：权限模型

Day7：schema 与兼容

Day8：观测

Day9：ACP 与行业协议（补充）

Day10：面试稿

排障 Checklist（可贴 wiki）

常见陷阱

实操验收

深度专题：从消费者到生产者 —— MCP Server 工程化

0. 2026-07-28 正式规范：无状态核心与扩展机制

1. Tool / Resource / Prompt 三种边界

2. Authorization（2026-07-28 规范）

3. Tool schema 设计规范

4. Schema 版本演进（不破坏客户端）

5. 错误码与超时约定

6. Rate Limit / 并发控制

7. 危险工具审批策略

8. 测试夹具（Test Fixtures）

9. 发布与客户端发现

10. 观测字段（与 LLMOps 对齐）

11. 工程化追问（面试版）

最新资料（2026-07-29 校验）