概览 — Herline MCP 接口

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

仅受邀内测账号可以接入。Core / Pro 是会员必要条件，不等于自动开通；受邀的 Core / Pro 账号可通过 OAuth 连接，受邀的 Pro 账号可申请 API Key。连接地址、工具列表和参数仍可能调整。

它是什么

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

给谁

• 已收到 MCP 内测邀请，并希望在支持 MCP 的 AI 客户端中调用 Herline 能力的用户。
• 受邀的 Core 和 Pro 账号可通过 OAuth 以本人身份连接。
• 受邀的 Pro 账号可申请 API Key，用于无人值守自动化。

怎么运转

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

核心边界

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

接着看

• 接入：OAuth、API Key 与权限。
• 能力与边界：工具分类、可调用范围与限制。
• 调用与计费：返回结构、Her能 扣减与余额不足。
• 错误与限制：状态、限流、重试与反馈。