# SDK、MCP 与智能体发现

智能体接口契约通过 SDK、CLI、HTTP 和 MCP 形式公开统一验证模型。[实现状态](https://proof21.xyz/zh-hans/docs/start/status/) 标识可用接口。

## 一个核心，多种接口

TypeScript 参考核心负责解释。CLI、HTTP、MCP 和客户端语言绑定携带相同结论、限制与错误，不实现相互冲突的策略逻辑，也不将结果简化为布尔值。

## 生成方与接收方工具

接口规范定义 `p21_verify_report`、`p21_check_payment`、`p21_resolve_element`、`p21_request_sample` 和 `p21_get_job`。只读验证与付费任务创建及状态变更操作相互分离。

## 两个入门按钮

**本地安装：**固定版本、验证说明、不需要钱包的样例，以及能正确失败的无效示例。

**连接智能体：**经审查配置、支持能力、所需权限、价格及明确支出上限。远程 MCP 连接不能静默索要钱包密钥。

公开技能或设置指南教智能体如何使用 P21；仓库 `AGENTS.md` 指导开发 P21 的编码智能体。两者都不能覆盖运营方权限。

## 发现不等于授权

服务发现为已发布的接口提供能力描述和模式。A2A Agent Card 描述符合 A2A 规范的服务。GitBook 的文档 MCP 提供文档检索，与 P21 验证接口相互独立。

参考：[MCP Registry](https://modelcontextprotocol.io/registry/about)、[A2A 发现](https://a2a-protocol.org/latest/topics/agent-discovery/)、[x402 Bazaar](https://docs.x402.org/extensions/bazaar)。

<!-- p21-source-payment-v08 -->

## 商业启用与实现状态

NAT 和 USDC 都必须通过初次商业发布验收。公开文档、源代码和策略测试样例不是实时支付端点。静态支付策略将必备方式列为 `enabled: false`，不提供收款方或实时端点，直到各通道通过端到端结算、记账、失败与重组、安全及所有者批准关卡。不能把仅支持 USDC 的版本称为完整首发支付范围。

此版本未发行代币、未公布数据源元素，也未执行主网铭文、客户扣款、资金兑换或钱包授权。生产服务可用性与网站发布分开。此处不暗示 Trac 合作关系、托管 SLA 或独立密码学审计。


[1] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/digital-elements/.element-registry

[2] https://github.com/Trac-Systems/ord-tap/blob/b8f6ea35cf6b9d405d4db7c58555e3c8ab33e8cd/src/index/updater/inscription_updater/tap/ops/dmt_element.rs

[3] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/nat-use-cases/usdnat-method-1-live

[4] https://digital-matter-theory.gitbook.io/digital-matter-theory/introduction/non-arbitrary-tokens-nats/nat-token-transfer

[5] https://docs.x402.org/core-concepts/network-and-token-support

[6] https://github.com/Trac-Systems/ord-tap/blob/b8f6ea35cf6b9d405d4db7c58555e3c8ab33e8cd/README.md

[7] https://arxiv.org/abs/1605.04559

<!-- p21-enforcement-v10 -->

## 智能体集成边界

智能体可以请求验证、评估返回材料并提出受保护操作，但模型文本绝不能成为钱包/API 权限。证据模式以报告结束；执行门控模式把 P21 授权交给独立受保护的 capability adapter，由它重新计算精确 action digest，并在不匹配、过期、nonce 重放或关键检查未解析时失败关闭。

接收智能体也可以签署 consumer decision receipt。其他智能体可以验证该决策，但不会因此赋予它改写底层 proof 或 settlement 的能力。