# 概览 — Herline MCP 接口

> 通过 MCP 让外部 AI agent 调用 Herline 能力。这里说明接口定位、适用对象、权限边界与计费原则。

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

---


Herline 通过 MCP（Model Context Protocol）向外部 AI agent 暴露结构化工具。连接后，agent 可以在你的授权范围内调用深读、调研、成课、检索和导出等能力。

> 内测中：连接地址、工具列表和参数可能调整，以正式开放公告为准。

## 它是什么

Herline MCP 暴露的是 typed tools。每个工具都有明确的输入、输出、权限和计费规则。外部 agent 调用能力总线，不需要再经过 Herline 的对话助手。

## 给谁

- 在支持 MCP 的 AI 客户端中工作，希望让 agent 调用 Herline 能力的用户。
- Core 和 Pro 用户可通过 OAuth 以本人身份连接。
- Pro 用户可使用 API Key 做无人值守自动化。

## 怎么运转

1. **连接**：在 AI 客户端中添加 Herline MCP 地址并完成授权，见[接入](/developers/connect)。
2. **调用**：agent 读取工具列表，按工具 schema 发起调用。可调用范围等同于你在网页端已有的权限。
3. **计费**：生产类工具按用量消耗 Her能；返回结果会包含本次扣减和剩余额度，见[调用与计费](/developers/billing)。

## 核心边界

陪练、测评等能力需要本人参与。agent 可以发起会话、传入上下文、读取结果，但不能替用户完成逐轮练习或测评。详见[能力与边界](/developers/capabilities)。

## 接着看

- [接入](/developers/connect)：OAuth、API Key 与权限。
- [能力与边界](/developers/capabilities)：工具分类、可调用范围与限制。
- [调用与计费](/developers/billing)：返回结构、Her能 扣减与余额不足。
- [错误与限制](/developers/errors)：状态、限流、重试与反馈。