# 连接 AI 代理（MCP）

使用单个URL在几分钟内将任何AI代理连接到**10,000+ 个API**。 兼容OpenClaw、Claude Code/Desktop、Cursor、Devin、Cline — 任何MCP兼容的AI客户端。

**您的 API 访问密钥**
您需要Zyla API密钥才能使用此MCP服务器

[获取API密钥](https://zylalabs.com/zh/register)
[登录](https://zylalabs.com/zh/login)

## 把这句话交给您的智能体

**mcp.zylalabs.com**
支持 OpenClaw、Claude Code/Desktop、Cursor、Devin、Cline 以及任何兼容 MCP 的 AI 客户端。

$
set up zyla - https://zylalabs.com/llms.txt

粘贴到 Claude Code、Cursor、Codex 或任何 AI 智能体中。它会读取说明、向您索取 API key 并自动完成连接。

您的代理将自动连接到Zyla的MCP服务器，发现 10,000+ 个API，并准备好调用它们。无需额外配置。

已经用 MCP URL 连接？它仍然可用，无需任何更改。
不起作用？请参阅 [各客户端的兼容性和设置](#compatibility) 获取详细说明。

## 或仅MCP URL

如果您的代理只需要URL，请复制此：

```text
https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY
```

## 桌面客户端的JSON配置

某些客户端如Claude Desktop、Cursor或Devin需要JSON配置文件。粘贴并保存：

```json
{
  "mcpServers": {
    "zyla-api-hub": {
      "url": "https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY"
    }
  }
}
```

- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows)

- **Cursor:** `.cursor/mcp.json`

- **Cline:** `~/.config/cline/mcp_settings.json`

## 什么是MCP？

**模型上下文协议（MCP）**是一个开放标准，允许AI代理发现和调用外部工具。Zyla的MCP服务器将 10,000+ 个REST API转化为任何AI代理都可以使用的工具 — 您的代理可以搜索目录、阅读API文档，并通过自然语言执行实时API调用。

- **一个URL，所有API** 单个MCP端点让您的代理访问整个目录。无需逐个API配置。

- **您现有的API密钥** 身份验证自动处理。您的Zyla API密钥已嵌入URL中。

- **零安装** 无需SDK、无需包、无需Docker容器。只需粘贴URL即可开始。

## 工作原理

当您的AI代理连接到Zyla API Hub MCP服务器时，以下是幕后发生的事情：

- **连接** 您的AI客户端使用API密钥连接到`mcp.zylalabs.com`。服务器公布可用工具。

- **您提出问题** 您输入类似"将100美元转换为欧元"的内容。AI决定使用哪些工具。

- **搜索和发现** 代理调用`search_catalog`查找货币转换API，然后调用`get_api_info`读取其端点和参数。

- **调用API** 代理使用正确的参数调用`call_api`。MCP服务器执行真正的API调用并返回响应。

- **获取答案** 代理格式化响应："100 USD = 92.34 EUR（汇率：0.9234）"。全部在几秒钟内完成，完全自动化。

## 试一试

连接后，尝试向您的代理提问。无需先订阅每个API — Zyla API Hub在您的代理首次调用任何API时自动激活按需付费计划：

- "Convert 100 USD to EUR"

- "What's the weather in Buenos Aires?"

- "Validate the email hello@example.com"

- "Search for finance APIs"

- "Get the BIN info for card 411111"

- "Browse all sports APIs, page 2"

- "Check my account status and API usage"

- "Get the IP geolocation for 8.8.8.8"

## 完整的代理体验

您可以从AI代理完成所有操作，无需访问zylalabs.com：

- **创建帐户** 告诉代理您的姓名、邮箱和密码。它使用`register`工具创建帐户并获取API密钥。

- **发现API** 让代理按关键词搜索API（`search_catalog`）或按类别浏览（`browse_catalog`）。

- **调用API** 代理使用`call_api`调用API。首次使用时自动创建订阅。

- **添加付款** 需要时，代理通过`get_payment_url`获取Stripe Checkout链接。在浏览器中打开添加您的卡片。

- **检查状态** 随时使用`account_status`查看您的计划、使用情况和账单信息。

## 可用的MCP工具

连接后，您的AI代理可以访问这些工具。代理根据您的请求选择调用哪个：

|
工具 |
作用 |
示例 |

| `search_catalog` | 按关键词搜索 10,000+ 个API。返回匹配的API及其ID、名称、描述、类别和端点数量。 | `search_catalog({ query: "currency exchange", limit: 5 })` |

| `browse_catalog` | 使用分页浏览完整目录。按类别、搜索关键词或排序方式筛选。访问所有公共API，超越前500名。 | `browse_catalog({ category: "Sports & Gaming", page: 1 })` |

| `list_categories` | 列出所有API类别（金融、天气、AI、体育、翻译等）以及每个类别中的API数量。 | `list_categories()` |

| `get_api_info` | 获取特定API的完整文档：每个端点、所有参数（名称、类型、必需/可选）和示例值。 | `get_api_info({ api_id: 1234 })` |

| `call_api` | 执行实时API调用。传递API ID、端点ID、HTTP方法和参数。返回真实的响应数据。 | `call_api({ api_id: 1234, endpoint_id: 5678, params: { from: "USD", to: "EUR" } })` |

| `register` | 直接从AI代理创建新的Zyla帐户。立即返回API密钥。无需访问网站。 | `register({ name, email, password })` |

| `account_status` | 检查您的帐户状态：计划信息、API调用使用情况以及是否有付款方式。用于诊断问题。 | `account_status()` |

| `get_payment_url` | 获取Stripe Checkout链接以添加或更新信用卡。用户在浏览器中打开链接完成付款设置。 | `get_payment_url()` |

提供商还可以使用 provider_* 工具来发布和更新自己的 API。
[用你的 AI 代理发布](https://zylalabs.com/zh/docs/publish-with-agent)

## 这适合谁？

- **构建AI代理的开发者** 让您的代理访问真实世界数据 — 汇率、天气、邮箱验证、地理位置等 — 无需编写自定义API集成。

- **AI辅助编程（Cursor、Devin、Cline）** 直接从IDE查询API。需要测试端点或检查数据？询问您的编程助手，它会为您调用API。

- **Claude Desktop & ChatGPT用户** 将您的AI聊天变成通用API客户端。用自然语言提问，从数千个API获取实时数据。

- **无代码团队** 无需编程。连接MCP，用自然语言提问，获取真实数据。非常适合研究、分析和原型设计。

## 各客户端的兼容性和设置

Zyla API Hub MCP使用**Streamable HTTP（SSE）**传输 — 服务器在云端运行，因此您无需安装Python、Node.js或任何本地运行时。只需提供URL。

|
客户端 |
如何连接 |
传输 |
难度 |

| Claude Code | 运行`claude mcp add`并粘贴URL | stdio / http | 非常简单 |

| Claude Desktop | 编辑JSON配置文件并粘贴URL | stdio / http | 简单 |

| OpenClaw | 运行`openclaw mcp add`并粘贴URL | stdio / SSE | 非常简单 |

| Codex CLI | 运行`codex mcp add`并粘贴URL | stdio / http | 非常简单 |

| Cursor | 在您的项目中编辑`.cursor/mcp.json` | stdio | 简单 |

| Devin | 编辑JSON配置文件 | stdio | 简单 |

| Cline (VS Code) | 编辑JSON配置文件 | stdio | 简单 |

| ChatGPT | 设置 → 应用 → 高级 → 使用URL创建连接器 | SSE / HTTP | 中等 |

### 重要说明

- **ChatGPT需要手动设置** 与Claude Code或OpenClaw不同，您不能直接在ChatGPT聊天中粘贴MCP行。您需要转到**设置 → 应用 → 高级设置 → 开发者模式**，创建新的连接器/应用，然后在那里粘贴Zyla API Hub MCP URL。配置完成后，您可以从聊天中正常使用它。

- **基于云端 — 无需本地运行时** MCP服务器使用SSE（服务器发送事件）传输，这意味着它完全在云端运行。您无需在机器上安装Python、Node.js或Docker。您的AI代理连接到`mcp.zylalabs.com`就像访问网站一样。

- **保护您的API密钥隐私** MCP URL中的`apikey=`参数是您的私有凭证。不要公开分享或提交到公共仓库。任何拥有您密钥的人都可以使用您的Zyla API Hub额度。如果您认为密钥已泄露，请从您的[API密钥页面](/api_keys)轮换它。

## 常见问题

### 我的API密钥安全吗？

您的密钥通过HTTPS发送，仅用于验证对Zyla API Hub的调用。它从不被MCP服务器存储 — 每次请求都是直接传递的。

### 我可以将此用于Zyla上的任何API吗？

是的。市场上列出的任何API都可以通过MCP使用。您的代理将通过`search_catalog`或`list_categories`找到它。您无需手动订阅 — 当您的代理首次调用某个API时，会自动创建按需付费订阅。

### 如果我的代理无法连接怎么办？

确保您使用的是包含API密钥的完整URL：`https://mcp.zylalabs.com/mcp?apikey=YOUR_KEY`。保存配置后重启您的AI客户端。如果问题仍然存在，请检查您的密钥在[API密钥页面](/api_keys)是否处于活跃状态。

### 这与直接调用API有何不同？

使用MCP，您的AI代理处理一切：找到正确的API、阅读其文档、构建请求和解析响应。您只需用自然语言提问。

### 我需要在使用前订阅每个API吗？

不需要。当您的代理调用您之前未使用过的API时，Zyla API Hub会自动为该API创建按需付费订阅。您只需为使用的部分付费 — 无需逐个API手动注册。只需连接MCP并开始提问。

### 我在哪里可以获取我的API密钥？

您可以：(1) 让AI代理使用`register`工具创建帐户并立即获取密钥，或 (2) [在网站上创建帐户](/register)并在[API密钥页面](/api_keys)找到密钥。

### 我可以不访问网站就注册吗？

可以！让AI代理使用`register`工具为您注册。只需提供姓名、邮箱和密码。代理会立即收到您的API密钥。

### 如何从AI代理添加付款方式？

让代理获取付款链接（使用`get_payment_url`工具）。您将收到Stripe Checkout URL — 在浏览器中打开，添加卡片即可。

### 我的代理可以浏览所有 10,000+ APIs吗？

可以。使用`browse_catalog`分页浏览所有公共API。按类别或关键词筛选。

## 资源

- [llms.txt](https://mcp.zylalabs.com/llms.txt): LLM的精简API目录

- [llms-full.txt](https://mcp.zylalabs.com/llms-full.txt): 供无法使用 MCP 的代理使用的完整 HTTP 参考（加上 ?apikey=YOUR_API_KEY）

- [浏览所有API](https://zylalabs.com/zh/api-marketplace): 探索完整市场

- [MCP规范](https://modelcontextprotocol.io): 官方模型上下文协议文档

---
Source: https://zylalabs.com/zh/docs/mcp