# 接入 — OAuth 与 API Key

> Herline MCP 支持 OAuth 授权连接和 API Key 直连。OAuth 面向 Core/Pro；API Key 面向 Pro 自动化。

更新:2026-06-29
页面:https://herline.vip/developers/connect

---


Herline MCP 支持两种接入方式：OAuth 授权连接和 API Key 直连。二者使用同一套工具、权限和计费规则。

> 内测中：以下地址、流程和可用工具可能调整，以正式开放公告为准。

## 方式一：以你的身份连接（Core / Pro）

适合在支持 MCP 的 AI 客户端中使用。

1. 在客户端中添加 Herline MCP 地址：`https://herline.vip/mcp/`。
2. 保留结尾斜杠。`/mcp/` 是有效地址，`/mcp` 不接受连接。
3. 按客户端提示跳转到 Herline 登录并确认授权。
4. 授权完成后，agent 将以你的身份调用工具。

OAuth 连接会自动完成客户端注册和令牌交换。你的权限、会员门禁和额度与网页端一致。

## 方式二：密钥直连（仅 Pro）

适合脚本、后台任务和无人值守流程。

1. 在账户中签发专用 API Key。密钥只显示一次。
2. 调用时在请求头中发送：`X-API-KEY: <your-key>`。
3. 可用能力仍受 Pro 会员权限、工具门禁、余额和日额度限制。

密钥只存哈希、可随时吊销；吊销后立即失效。

## 准入与权限

- **OAuth**：Core 和 Pro 可用，按本人网页端权限调用。
- **API Key**：仅 Pro 可用，用于 headless 自动化。

MCP 不放宽会员门禁，也不新增绕过额度的路径。

## 接着看

- [能力与边界](/developers/capabilities)：工具分类与调用限制。
- [调用与计费](/developers/billing)：返回结构、扣费与余额不足。
