# 用你的 AI 代理发布

你的代理可以为你发布并维护你的 API。它使用你的密钥连接到 Zyla MCP 服务器，并调用 `provider_*` 工具，这些工具会调用 [Listings API](https://zylalabs.com/zh/docs/listings-api)。任何已验证邮箱的账户都可以使用它们。

同样的指南，带有一键复制按钮并已填好你的密钥，也可以在你的控制台中找到：**Add new API → For AI agents**。

## 1. 获取你的 API 密钥

从 [连接 AI 代理（MCP）](https://zylalabs.com/zh/docs/mcp) 复制它。参见 [你的 API 密钥](https://zylalabs.com/zh/docs/api-keys)。

## 2. 连接 MCP 服务器

将这一行粘贴到你的代理中：

```text
set up zyla with key YOUR_API_KEY - https://zylalabs.com/llms.txt
```

或者在你的客户端中添加 `https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY` 作为一个远程 MCP 服务器。各客户端的具体操作见 [连接 AI 代理（MCP）](https://zylalabs.com/zh/docs/mcp)。

## 3. 让它发布

```text
请使用 provider_upsert_listing 工具，在 Zyla API Hub 上发布我的 API。
这是我的 OpenAPI 规范 / base URL：https://api.example.com/openapi.json
名称：Example Weather API。
为每个主要操作添加一个端点，并附带真实的示例响应，提出套餐和价格建议，
并在发布之前把完整的请求内容给我看一下。
```

## 工具

| 工具 | 功能 |
|---|---|
| `provider_list_categories` | 市场分类列表（Zyla 会自动为你的 API 设置分类） |
| `provider_upsert_listing` | 创建或更新一个完整的 API 上架页（`PUT /api/listings`） |
| `provider_get_listing` | 获取你某个 API 上架页当前的定义，以便编辑 |
| `provider_list_listings` | 获取你的 API 上架页列表及其状态和 URL |
| `provider_delete_listing` | 删除一个 API 上架页；需要传入 `confirm: true` |

## 须知

- 当该 API 上架页通过 [质量规则](https://zylalabs.com/zh/docs/quality-rules) 的检查，并且有一个带示例响应的端点和生效的套餐时，它就会上线。可以让代理发送 `"publish": false` 以保持为草稿。
- [新 API 配额](https://zylalabs.com/zh/docs/quality-rules) 同样适用，和网页端一致。
- 你的源站密钥（`access`）会被隐藏存储，永远不会被返回或记录。
- 更新 API 上架页不会计入配额：可以让代理用 `provider_get_listing` 读取它，修改需要的内容后再发回去。


---
Source: https://zylalabs.com/zh/docs/publish-with-agent