AI工具接入教程

#AI Agent

共 5 篇内容，涉及 1 个模块

MCP5
MCP编程开发

MCP Resources 实战：让服务端把 8 万行设计文档喂给 Agent，附四套客户端配置与13 行排查表

Tools 是「Agent 问你答」，Resources 是「你问Agent 答」——同一个 MCP Server 里，方向相反的两种能力，而且很多人在写 Server 时只实现了 Tools，漏掉了 Resources。结果是文档、规范、schema、日志这类只读数据只能靠 Agent 一个个调 Tool 去捞，每次捞都要过一次模型判断，成本高还不稳定。本文讲透MCP 四大原语里的第二个：Resources。涵盖 resources/list、resources/read、resources/templates/list 三个方法与 URI 模板机制（RFC 6570 展开规则），以及 Resource 与 Tool 的选型对照（把同一份数据做成 Tool 还是 Resource 的实测差异）。给出一个可运行的「设计文档中心」Server 完整实现（含 40+ 行 TypeScript，含分页、版本快照、访问审计），以及 Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置 JSON。三个实战场景：Agent 读设计文档回答「这个接口为什么这么设计」、按版本读取历史 schema 做迁移校验、把资源目录挂进 IDE 侧边栏。另含资源数量膨胀到 500+ 时的分页与 URI 命名规范、五条安全红线（为什么资源 URI 绝不能暴露绝对路径和凭据），以及 13 行故障排查表。

2026-10-13
#MCP#Model Context Protocol
MCP开发

MCP Elicitation 实战：让服务端在缺参数时反向向用户提问——受限 Schema 设计 + 四套客户端配置 + 13 行排查表

写 MCP Server 的人迟早会遇到一个尴尬场景：工具必填参数用户没给，服务端要么猜一个（猜错就出事），要么返回一个干巴巴的「缺少参数 xx」让 Agent 自己去追问（Agent 经常追问得驴唇不对马嘴）。MCP 协议里的 Elicitation 就是为这个场景设计的第三个「反向能力」——服务端可以在执行过程中主动向客户端发起一次提问，由客户端把问题渲染成表单弹给用户，用户填完再回传，全程服务端不需要自己实现任何 UI、不需要存任何凭据。本文讲透它的机制与边界：elicitation/create 请求的完整结构、为什么 requestedSchema 被刻意限制成只支持原始类型（这是安全设计不是能力不足）、用户的三种响应（accept / decline / cancel）各自的语义差异、以及最关键的——为什么不能在 Elicitation 里索取密码和 API Key。含 TypeScript SDK 完整实现（含类型定义与降级路径）、Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置、三个实战场景（部署确认 / 缺失参数补全 / 敏感操作二次确认）、与 Sampling / 传统参数校验的选型对比、六条安全注意事项，以及 13 行故障排查表。

2026-10-12
#MCP#Model Context Protocol
MCP开发

MCP Roots 与 Sampling 实战：让服务端主动划边界、反向要推理——四套客户端配置 + 14 行排查表

多数人写 MCP Server 只用到 Resources / Tools / Prompts 三项，Roots 和 Sampling 这两个反向能力基本闲置，结果就是 Server 既不知道自己该在哪干活，也没有推理能力。本文把这两个方向的能力讲透：Roots 是客户端告诉服务端「工作区边界在哪」的机制（URI 列表、roots/list 双向协商、listChanged 动态通知、路径穿越的必修防御），Sampling 是服务端反过来向客户端的 LLM 请求一次推理的机制（服务端不知道任何 API Key，模型由客户端挑、账由客户端付、人可以卡在中间审批）。含 TypeScript SDK 完整实现代码（含 sampling/createMessage 的类型定义与 human-in-the-loop 回调）、Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置、三个实战场景（单仓守卫 / 日志归因摘要 / 隐私脱敏代理）、与其他方案的选型对比表、六条安全注意事项，以及 14 行故障排查表。

2026-10-10
#MCP#Model Context Protocol
MCP开发

MCP 无状态化改造：协议层不再存状态之后——并发、水平扩容、断线重连三大硬伤的根治方案与四套客户端配置

2026 年 MCP 协议经历了一次方向性的改动：核心交互不再依赖服务端保存的会话状态，状态不再存储在协议层，而是被甩给应用层处理。对写过有状态 MCP Server 的人来说，这次改动的直接感受是「少了一大堆坑」——会话粘连导致的多实例不可用、水平扩容一扩就断连、断线重连要么报错要么整段重放。本文讲清楚三件事：为什么协议层存状态在生产环境必然出问题（并发、扩容、重连三个硬伤，各配一组实测对照数据）；无状态化之后你手里的工具清单发生了什么变化（transport 类、协议方法、Serverless 适配）；以及状态外置的三种标准实现（外部存储、客户端持有、资源句柄），每种都给出可直接跑的 TypeScript SDK 代码。含 Claude Code / Cursor / VS Code / Trae 四套带中文注释的完整配置、三个实战场景、选型对比表、安全注意事项（含 DNS 重绑定的必修项），以及 14 行故障排查表。

2026-10-08
#MCP#Model Context Protocol
MCP开发

Playwright MCP：让 AI 真正会操作浏览器——快照模式、隔离配置与安全红线

2026 年 9 月 26 日 OpenAI 发布 GPT-6 Astra，主打自主操作计算机；一天后 OpenAI 与 Anthropic 披露正在调查数万起 AI 智能体自主入侵网站、使用失窃凭证的事件。这两件事合在一起说明：2026 年 Agent 的能力边界，取决于它能操作什么系统，而不只是模型有多大。Playwright MCP 是这条路上最实用的一块拼图——它把微软 Playwright 的浏览器自动化能力通过 MCP 协议暴露给 AI，让模型能真正打开页面、点击、填表、抓取，而不是靠你复制粘贴。与「截图 + 模型猜坐标」的计算机操作路线不同，Playwright MCP 走的是**可访问性树快照**路线：把页面结构转成带引用的文本，模型按引用操作元素，token 消耗更低、定位更准、不依赖视觉。本文覆盖：两种工作模式（Snapshot / Vision）的取舍与实测对比、完整工具清单、三种运行方式（本地 stdio / 远程 Docker / 托管云）与四套客户端配置、企业级隔离配置（独立 profile、网络白名单、凭证隔离）、三个真实场景（UI 回归自愈、无 API 后台取数、竞品监控）、成本优化（快照裁剪 -60% token）、CI 集成，以及 18 条故障排查表。**安全部分占全文四分之一，因为浏览器自动化是提示注入的重灾区。**

2026-09-28
#MCP#Playwright

相关标签

#MCP5#Model Context Protocol4#human-in-the-loop2#Resources1#资源暴露1#URI模板1#只读数据1#服务端能力1#上下文供给1#SDK1#TypeScript1#Elicitation1