把 Lune 接入你的 AI 应用
接入一次 Lune，之后直接用自然语言向 AI Agent 提研究问题即可。Agent 会调用 Lune 的工具检索 Paper、阅读全文、追踪引用、比较结果、核验论断，并查询科研最佳实践。你不需要记工具名称。
选择接入方式
- 网页 AI 应用：ChatGPT、Claude、Grok、Perplexity、Manus、Muse、Grok Bot，以及任何带自定义连接器表单的应用。其中不少通过浏览器登录。
- 本地 AI Agent：Claude Code、Cursor、VS Code、Codex、OpenCode、Antigravity、Zed、Hermes Agent，以及其他通过命令或配置文件接入的 MCP 客户端。
控制台的安装页面为每个应用准备了步骤，需要访问密钥的地方已经替你填好。
连接参数
这一节写给连接器表单、MCP 客户端，以及自己搭建连接器的 Agent。大多数应用只需要服务器地址，其余信息会自动发现。
| 项目 | 值 |
|---|---|
| 服务器地址 | https://mcp.luneresearch.com |
| 旧地址 | https://mcp.luneresearch.com/mcp 和 https://mcp.luneresearch.com/v1/mcp 仍然可用 |
| 传输方式 | Streamable HTTP，无状态，不保留会话。用 POST 发送 JSON-RPC；GET 和 DELETE 返回 405 |
| 协议版本 | 2026-07-28、2025-11-25、2025-06-18、2025-03-26 和 2024-11-05。initialize 可以省略 |
| 请求头 | Content-Type: application/json 和 Accept: application/json, text/event-stream |
| 凭证 | Authorization: Bearer，后接 OAuth 访问令牌或访问密钥 |
| 本地方案 | stdio 包 @retrograde-labs/lune-mcp-server（见本地 AI Agent） |
当前的 MCP SDK 会替你处理协议版本。如果你手写请求：不带 MCP-Protocol-Version 请求头的 POST 按 2025 年及更早的旧版协议处理，响应格式为 text/event-stream，内容是一条 event: message，它的 data: 行就是 JSON-RPC 响应。2026-07-28 版的请求需要带 _meta 信封和 Mcp-Method 请求头，响应格式为 application/json。只发送版本请求头会得到 400。
凭证
服务器接受两种凭证，都放在 Authorization: Bearer 请求头里：
- OAuth 访问令牌。 应用把你带到 Lune 登录，你批准后，应用拿到代表你账户的令牌。只要应用支持 OAuth 就用这种方式，什么都不用复制。
- 访问密钥。 以
lune_开头的密钥。在凭证页面打开 API 密钥标签页，点击新建密钥即可创建。密钥只显示一次。应用只能发送固定请求头，或者要你填 API key 时，用这种方式。
授权服务器
Lune 为 MCP 连接器提供的授权服务器：
| 项目 | 值 |
|---|---|
| 签发方（Issuer） | https://api.luneresearch.com |
| 授权端点 | https://api.luneresearch.com/oauth/authorize |
| 令牌端点 | https://api.luneresearch.com/oauth/token |
| 注册端点（RFC 7591） | https://api.luneresearch.com/oauth/register |
| 撤销端点（RFC 7009） | https://api.luneresearch.com/oauth/revoke |
| JWKS | https://api.luneresearch.com/.well-known/jwks.json |
| 资源元数据（RFC 9728） | https://mcp.luneresearch.com/.well-known/oauth-protected-resource |
| 授权服务器元数据（RFC 8414） | https://api.luneresearch.com/.well-known/oauth-authorization-server |
| 权限 | papers:read guidance:read account:read |
| 资源标识（RFC 8707） | https://mcp.luneresearch.com |
客户端需要做到：
- 先注册，拿到 client ID。 客户端都是公开客户端：没有 client secret，令牌端点的认证方式为
none。注册端点是获取 client ID 的唯一途径，client ID 以lune_oauth_开头。 - 使用带 PKCE 的授权码流程。 只支持
response_type=code和code_challenge_method=S256。state可以不传，但建议传。授权码有效期 10 分钟，只能用一次。 - 申请上表中的三个权限，不多不少。 它们覆盖全部工具。不传
scope，或申请的权限 Lune 一个都不支持时，默认就是这三个。 - 在授权请求和令牌请求里都带上
resource=https://mcp.luneresearch.com。 两个请求都没带时，令牌的受众会是你的 client ID，当前协议版本下 MCP 服务器会拒绝这种令牌。 - 逐字注册回调地址。 Lune 接受任意主机的
https、仅限本机回环地址（127.0.0.1、[::1]或localhost）的http，以及cursor://这类私有 scheme，不允许带片段（#）。授权请求必须与某个已注册地址完全一致，只有一个例外：已注册的http回环地址可以换用任意端口（RFC 8252 第 7.3 节）。回调会带上code、iss，以及你发送的state。 - 向令牌端点和撤销端点提交表单编码的请求体（
application/x-www-form-urlencoded），并把client_id放在请求体里。Lune 不读取 HTTP Basic 凭证，JSON 请求体会得到422。 - 轮换刷新令牌。 访问令牌是 RS256 JWT，有效期一小时。每次刷新都会返回新的刷新令牌：保存新的，丢弃旧的。已用过的刷新令牌若在 30 秒后再次出现，Lune 会撤销整条令牌链。刷新令牌闲置 90 天后过期。
- 不支持 OpenID Connect。 Lune 不签发 ID 令牌，也没有
/.well-known/openid-configuration。
每个 OAuth 连接的用量都记在你的个人团队名下，与控制台当前选中哪个团队无关。想用共享团队的套餐，请用在该团队下创建的访问密钥连接。
完整流程和可直接复制的请求见 auth.md。错误码和处理方法见故障排查。
工具
工具调用从凭证所属团队的每日额度中扣除。大多数调用算一次请求，批量工具按条目计费，list_conferences 免费。计费规则见套餐、请求与点数。每个工具在运行时检查自己需要的权限。
| 工具 | 用途 | 权限 | 计费单位 |
|---|---|---|---|
search_papers | 用一条自然语言查询检索文献库 | papers:read | 每次调用 |
search_papers_many | 一次运行最多 25 条查询变体，并合并结果 | papers:read | 每条查询 |
search_related_papers | 查找与某篇 Paper 主题相近的 Paper | papers:read | 每次调用 |
get_paper_fulltext | 阅读 Paper 全文，或只取你指定的章节 | papers:read | 每次调用 |
get_paper_citations | 列出一篇 Paper 的参考文献，或引用它的已收录 Paper | papers:read | 每次调用 |
list_conferences | 列出 Lune 收录的顶会 | 无 | 免费 |
get_conference_papers | 列出某个顶会的 Paper，每次最多 100 篇 | 无 | 每次调用 |
extract_from_papers | 从最多 50 篇 Paper 的全文中提取对比表格 | papers:read | 每篇 Paper |
verify_claims | 对照文献库核验最多 25 条论断，有证据时附原文引用 | papers:read | 每条论断 |
gather_evidence | 围绕一项任务最多运行 25 次检索，指出仍缺的证据，并建议下一步检索 | papers:read | 每次实际检索 |
search_research_guidance | 检索关于研究方法、评估、写作和同行评审的精选最佳实践 | guidance:read | 每次调用 |
get_research_guidance_doc | 阅读一篇最佳实践文档的全文 | guidance:read | 每次调用 |
托管服务器还会列出 get_more_tools。Agent 需要某项 Lune 还没有的功能时，可以调用它把需求告诉 Lune。这次调用只记录需求，不返回科研数据，也不计费。本地 stdio 服务器没有这个工具。
提示词
部分应用会把它们显示为斜杠命令。每个提示词会启动一套基于上述工具的流程。直接用自然语言说明同一项任务也可以，Agent 会自己挑选工具。
| 提示词 | 参数 | 你会得到 |
|---|---|---|
/literature_review | topic（必填）、venues、since_year | 一份综述：主要脉络、奠基与近期工作、尚未解决的空白 |
/find_related_work | abstract（必填）、venues | 需要引用的先前工作，按主题分组，并说明你的贡献有何不同 |
/compare_papers | topic（必填：一个主题或一组 Paper 标题）、columns | 根据各篇 Paper 全文整理的对比表 |
/verify_draft | draft（必填） | 每条论断的结论，有支撑引文时一并给出 |
/trace_citations | paper（必填） | 这篇 Paper 的前序工作、后续工作与相邻工作 |
/research_methodology | question（必填） | 关于实验设计、消融、评估、回应审稿人或选投顶会的建议，附来源 |
所有参数都是文本。venues 和 columns 接受逗号分隔的列表，例如 NeurIPS, ICML 或 dataset, metric, result。
管理连接
Lune 可以接入任意多个应用。用量记在同一个团队名下的连接，共享该团队的额度和点数。凭证页面列出两种凭证：API 密钥标签页是访问密钥，OAuth 客户端标签页是你通过登录接入的应用。OAuth 连接属于你的个人团队，切换到个人团队才能看到。
