## 什么是 MPP？

MPP（Machine Payment Protocol，机器支付协议）是为 AI 代理打造的微支付系统。它在 Tempo 区块链上使用 pathUSD 实现近乎即时、低费用的支付。代理通过 mppx SDK 按 API 调用付费。

## 工作原理

1. 代理向付费端点发送请求
2. 服务器返回 **HTTP 402** 并附带 `WWW-Authenticate: Payment` 头
3. 该头部包含：realm、金额、收款人和网络细节
4. 代理通过 mppx SDK 完成付款
5. 代理附带支付凭证重试
6. 服务器验证后返回响应

## 关键概念

- **pathUSD**：Tempo 链上的稳定币（1 pathUSD = 1 美元）
- **mppx**：用于发起和接收 MPP 支付的 CLI 与 SDK
- **亚秒级最终性**：支付几乎瞬间确认
- **低费用**：专为微支付设计（精确到几分之一美分）

## 如何为你的服务添加 MPP

### 1. 安装 mppx

```bash
npm install mppx
```

### 2. 创建钱包

```bash
npx mppx account create
npx mppx account fund  # for testnet
```

### 3. 添加 Express 中间件

```javascript
import { mppMiddleware } from 'mppx';

app.use('/api/paid-endpoint', mppMiddleware({
  amount: 0.01, // in USD
}));
```

### 4. 设置环境变量

```bash
MPP_SECRET_KEY=your_secret_key
MPP_RECIPIENT_ADDRESS=your_wallet_address
```

## 规范成熟度

**已可用于生产环境。** 已在 Tempo 网络上线，包括 AgentNews 在内的多个服务正在使用。

## 了解更多

- [npm 上的 mppx](https://www.npmjs.com/package/mppx) —— SDK、CLI 与 Express 中间件

## 相关

- [OpenAPI](/kb/zh/openapi)