作者： PaperMoon团队
4 月 19 日，@Polkadot 主账号宣布 Docs MCP 上线，用的是这句标语：“Imagine having a Polkadot expert sitting next to you while you build”。一个专家坐在你旁边。这是给开发者听的话，温度合适，营销味也刚好。
4 月 27 日，@paritytech 再推一次。同一个工具、同一个产品，但开场白换了"Polkadot documentation is now available as structured context your tools can query on demand"。文档作为结构化上下文，可以被你的工具按需查询。
第二种讲法没有"专家"、没有"坐在你旁边"，甚至没有"AI"这个词。它讲的是数据接口，是协议，是一种"被调用"的资源。
8 天的时间，同一件事，从一个叙事跳到另一个叙事。这不是文案漂移，这是 Parity 在公开调整 Docs MCP 的产品定位。
而调整的方向，比上线本身更值得读。
先把第二条推文里那 4 个例子单独拎出来
@paritytech 这次列了 4 个示例问题：
- How XCM fees are calculated
- How to benchmark a custom pallet
- How to set up a validator, step by step
- How to register an asset on Polkadot Hub
跟 4 月 19 日 @Polkadot 列的那 6 个相比，这一份做了两件事
砍掉了概念性问题。比如 “What is the difference between EVM and PolkaVM?”、“Which OpenGov track does your proposal belong to?” 这种偏理解、偏判断的问题，4 月 27 日的版本里没有了。留下的全是操作类——计算、benchmark、搭建、注册。
换了"Asset Hub"为"Polkadot Hub"。4 月 19 日的版本说 register a foreign asset on Asset Hub，4 月 27 日说 register an asset on Polkadot Hub。这是一个正在进行中的命名收敛——Asset Hub 这个旧名在这次推送里被悄悄替换掉了。
这两个变化合起来读，能听出 Parity 在筛选示范场景时的逻辑——他们想强调的是 MCP 处理"具体步骤、具体参数、具体调用"的能力，而不是处理"理解和判断"的能力。
这恰好和"structured context"这个词对得上。结构化上下文是用来被查询的，不是用来跟你聊的。
docs-mcp.polkadot.com 真正提供了什么
打开 docs.polkadot.com/ai-resources 这一页，能看到 Polkadot Docs MCP 的完整规格。它不是一个 AI 助手——它是一组按 token 分级切好的文档资源。
服务端点：https://docs-mcp.polkadot.com
提供的文件分两层。
全站层有三个文件，按"信息密度 vs 上下文成本"排序：
| 文件 | Token 数 | 用途 |
|---|---|---|
llms.txt | 13,681 | 站点地图，告诉模型哪里有什么 |
site-index.json | 77,640 | 元数据 + 内容预览，适合中等上下文窗口 |
llms-full.jsonl | 635,411 | 全站完整内容 + 元数据，喂给大窗口模型或 RAG 管道 |
分类层把文档拆成 8 个主题——Basics、Smart Contracts、Parachains、Chain Interactions、Interoperability、Infrastructure、Polkadot Protocol、Tooling，外加一个 Reference。每个主题都有"完整版"和"轻量版"两个变体。比如 Smart Contracts 完整版 16 万 token、轻量版 7 千 token；Tooling 完整版 21 万 token、轻量版 8 千 token。
也就是说——同一份文档，被切成了 9 种不同尺寸的检索面（3 个全站 + 8 个主题 × 2 = 19 个文件，但概念上是 9 种规格）。
这种切法是有讲究的。你的 AI agent 用的是 32k 上下文窗口的模型？拿轻量版。它在做 RAG，需要原始素材库？拿 jsonl。它只是想确认"哪个章节存在"？拿 llms.txt 当目录。Polkadot 没有给你一个 AI，它给了你一个按上下文成本分级的检索接口。
这就是"structured context"这个词背后的真正含义。它不是营销化简——它是技术上准确的描述。
那一句被很多人忽视的"no persona or system prompts"
官方 ai-resources 页有一句很安静的描述：
Files provide “no persona or system prompts” and function as pure informational resources compatible with existing agent prompting systems.
不带人设、不带系统提示词、纯信息资源。
这句话很重要。在 2026 年，做一个文档 MCP 服务有两条主流路径——
路径 A：把文档喂给一个微调过的模型，给它装上 Polkadot 风格的对话人设、定制系统提示词，包装成"专家 chatbot"暴露给用户。这条路走得最快，演示效果最好，但你拿到的是别人调好的"答案"。
路径 B：把文档结构化、分级、贴上元数据，作为原始素材直接暴露，让你自己的 agent / IDE / 工作流去消费。这条路慢，演示难看，但你拿到的是可以无缝塞进任何现有 prompt 系统的纯燃料。
Polkadot Docs MCP 选了路径 B。
而且选得很坚决——官方文档里把"无人设"作为一个明确的设计声明，不是顺带提一句。这意味着 Parity 想要的是一个能被任何上下层架构吃掉的中间件，不是一个跟终端用户直接对话的产品。
这跟"AI 助手"是两种完全不同的产品形态。
回头看那两条推文的措辞变化，就能理解为什么 Parity 要在 8 天后再推一次——4 月 19 日那条对开发者讲了一个"AI 助手"的故事，传播效果好，但不准确。4 月 27 日这条是把定位拉回到产品的真实形态：你拿到的不是助手，是一种"可被任意工具调用的结构化资源"。
这不是营销退烧——这是产品方在把舆论叙事拉回到他们真正想做的事情上。
为什么这件事在 2026 年 4 月发生
把时间线往回拉一点。
Anthropic 在 2024 年底开源了 Model Context Protocol。2025 年大半年，MCP 还停在"实验性协议"的状态，主要在 Claude 生态里被验证。2025 年 12 月，Anthropic 把 MCP 捐给了 Linux 基金会下的 Agentic AI Foundation（AAIF）——和 Anthropic、Block、OpenAI 共同发起的中立组织。这一步把 MCP 从单家公司的协议变成了行业基础设施。
2026 年 3 月，MCP 安装量越过 9700 万次，社区贡献的 MCP 服务器超过 10000 个。Claude、ChatGPT、VS Code、Cursor 全部原生支持。4 月，AAIF 在纽约办了第一届 MCP Dev Summit North America，1200 人到场。
也就是说——Parity 选在 2026 年 4 月这个时间点上线 Docs MCP，正好踩在 MCP 从"协议规范"成型为"行业默认接口"的那个临界点上。这不是赶时髦，这是趁着标准刚刚稳定下来抢一个早期生态位置。
而且 Polkadot 不是孤例——同期能在 LLM 工具市场里搜到的"链 × MCP"项目已经开始多起来。但仔细看会发现，绝大多数都是社区项目（比如 Polkadot MCP Server 这种民间实现），把链 RPC 封装成 MCP 工具暴露给 AI。Polkadot 官方做的事情和它们都不一样——官方做的是文档侧的 MCP，把人类可读的文档变成机器可读的上下文资源。
这两件事是互补的，但优先级不同。链 RPC 暴露成 MCP 工具，让 AI 能"做事"——发交易、查链上状态。文档暴露成 MCP 上下文，让 AI 能"懂事"——理解为什么要这么做。前者是 verbs，后者是 substrate。Parity 先做了后者，逻辑很清楚——一个不懂 Polkadot 设计原理的 agent，给它一堆链工具也只会闯祸。
这条推送和 Polkadot 最近这一连串动作连起来看
把这件事放回 2026 年这几个月 Polkadot 的开发者体验改造时间线里看，会更清楚——
- 2 月：Foundry-Polkadot pallet-revive 测试链 工具链补齐
- 2 月：OpenZeppelin Wizard 支持 Polkadot
- 2 月：RevX Rust 合约 IDE 进入 Beta
- 3 月：Polkadot Hub 全平台开放，不用自建链就能部署合约
- 3 月底：Parity 在 PaperMoon 那篇文章里第一次正面拆开 DX 短板
- 4 月：Inferara 把形式化验证塞进 JAM 开发流程，AI 写代码 + 数学证明
- 4 月 19 日：Docs MCP 正式上线
- 4 月 27 日：Parity 二次推送，把定位从"AI 助手"调整到"结构化上下文"
这条曲线讲的是同一件事——Polkadot 在系统性地把"开发者第一次接触到落地"之间的每一道摩擦逐个清掉。Foundry 解决本地测试的摩擦，OpenZeppelin Wizard 解决合约模板的摩擦，Polkadot Hub 解决"非要先建一条链"的摩擦，Docs MCP 解决"找到正确文档"的摩擦。
这条曲线和 3 月那篇大改经济模型的文章 拼在一起看更有味道——Polkadot 在 2026 年同时在做两件事：经济模型上止血、开发者体验上加速。一边收紧、一边开闸。一个长期公链如果想再活十年，这两件事必须同时做。
而 Docs MCP 的"结构化上下文"定位，是这套加速里很容易被低估的一块——它表面上只是一个 AI 工具，实际上是 Polkadot 把自己的文档资产API 化了。文档不再是"网页"，是"接口"。
这件事一旦被开发者按这个路径吃进生产工作流，就很难退回去。
这意味着什么
对 Polkadot 生态——这是一次"产品形态"层级的升级。Docs MCP 不是给文档加了个 AI 入口，是把文档本身的产品边界从"给人读"扩到"给机器调用"。一旦这个接口被 Cursor / Claude Code / Codex 吃下去，每一次 Polkadot 文档更新都直接传播到全球开发者的 IDE 里，零延迟。
对其他 L1 / L2——这是一个公开的提示。把 docs 转成 MCP 不难，难的是想清楚"是要做 chatbot 还是要做 substrate"。Polkadot 选 substrate，这个选择对中长期生态的复利更大，但短期演示效果更平。如果只看媒体声量，会以为这是个普通的 AI 集成新闻。如果看产品形态，这是一次定位坚决的下沉式投资。
对开发者本人——别只把 Docs MCP 当 chatbot 用。它的 9 种规格是给你自己的 agent 体系做选型用的。如果你正在做一个 Polkadot 方向的开发工具、教学产品、CI 集成，llms-full.jsonl 就是你 RAG 管道里那个零成本的高质量语料源。这是 Polkadot 第一次主动把"我们的文档可以塞进你的产品里"写进了官方接口。
