# 网页 AI 应用

这些应用把 Lune 作为连接器接入：ChatGPT、Claude、Grok、Perplexity、Manus、Muse、Grok Bot，以及其他带自定义连接器表单的应用。ChatGPT、Claude、Grok 和 Grok Bot 通过浏览器登录 Lune，什么都不用粘贴。Perplexity 和 Manus 需要访问密钥。Muse 先用访问密钥接入，连接器能用之后可以改用 OAuth。

如果你用的是 Claude Code、Cursor、Codex、Hermes Agent 或其他通过命令或配置文件接入的 Agent，请改看[本地 AI Agent](https://luneresearch.com/zh-Hans/docs/mcp/stdio)。

## 填写自定义连接器表单

大多数表单只问三项：

| 字段         | 填写内容                                                       |
| ------------ | -------------------------------------------------------------- |
| 名称（Name） | `Lune`                                                         |
| 服务器地址   | `https://mcp.luneresearch.com`（有的表单叫「MCP server URL」） |
| 认证方式     | OAuth，或表单的默认选项。client ID 和 secret 留空。            |

保存表单后，应用会打开 Lune 的登录窗口：登录，确认它申请的权限，然后点击**授权**。

如果表单要你填授权地址或令牌地址，请从[授权服务器](https://luneresearch.com/zh-Hans/docs/mcp#授权服务器)里复制。Lune 没有 client secret。如果表单要求先提供 client ID 才能连接，请用注册端点注册一个，回调地址填表单显示的那个；具体请求见 [auth.md](https://luneresearch.com/auth.md)。

## 改用访问密钥

应用不支持 OAuth、要你填 API key，或者只能设置请求头时，改用访问密钥。

1. 在[凭证页面](https://luneresearch.com/dashboard/settings/credentials)打开 **API 密钥**，点击**新建密钥**。马上复制：控制台只显示一次。
2. 把密钥填到应用要求的位置。**API key** 字段直接填密钥本身。请求头的名称填 `Authorization`，值填 `Bearer lune_your_access_key`，把 `Bearer` 后面的部分换成你的密钥。JSON 配置用下面的格式：

   ```json
   {
     "mcpServers": {
       "lune": {
         "type": "http",
         "url": "https://mcp.luneresearch.com",
         "headers": { "Authorization": "Bearer lune_your_access_key" }
       }
     }
   }
   ```

访问密钥的用量记在创建它的团队名下。它会一直有效，直到你撤销它，或到了创建时设定的有效期。

## 各应用说明

[安装页面](https://luneresearch.com/dashboard/install)为每个应用准备了完整步骤，需要访问密钥的地方已经替你填好。

**ChatGPT。** Lune 已上架 ChatGPT 的插件目录。在侧边栏的 **Plugins** 中找到 Lune，添加后按提示登录 Lune。在新对话里输入 `@Lune` 即可直接调用。

**Claude。** 从 Claude 的**连接器目录**添加 Lune，并批准登录。同一个条目适用于网页版、桌面版和移动版 Claude。

**Grok。** 打开 [grok.com/connectors](https://grok.com/connectors)，或在对话框点击 **+** 后打开 **Connectors**。点击 **Add connector**，在 **New Connector** 对话框里选择 **Custom**。名称填 `Lune`，服务器地址填上面的地址，点击 **Add Connector**，然后批准 Lune 登录。

**Grok Bot。** xAI 的桌面 Agent 应用。打开侧边栏的 **Marketplace**，或依次打开 **Settings**、**Plugins**（视版本而定），添加自定义 MCP 服务器，名称填 `Lune`，地址填服务器地址。然后在浏览器里批准 Lune 登录。如果 Grok Bot 改为要求填写请求头，就用访问密钥。如果找不到添加自定义服务器的选项，就在对话里请 Grok Bot 添加名为 Lune、地址为 `https://mcp.luneresearch.com` 的自定义 MCP 服务器。在任务里输入 `@Lune` 即可调用。

**Muse。** Meta 的 Agent 会自己搭建连接器。在对话里请 Muse 根据 `https://luneresearch.com/docs/mcp` 为 Lune 创建自定义连接器。它向你要凭证时，把访问密钥粘贴到 Muse 弹出的凭证输入框里，不要发在对话中。Muse 会把密钥存进它的 Secure Credentials Store。连接器能用之后，你可以让 Muse 改用 OAuth，要发送的消息见安装页面。

**Perplexity。** 点击侧边栏的 **Customize**，或在对话框点击 **+** 后选择 **Manage Connectors**。点击右上角的 **+ Custom connector**，再选择 **Remote**。填写 **Name**、简短的 **Description** 和 **MCP server URL**，把 **Transport** 设为 Streamable HTTP。然后展开 **Advanced**，在 **Authentication** 里选择 **API Key**，粘贴访问密钥。勾选表示你了解自定义连接器风险的复选框，点击 **Add**，再在 **Connectors** 下点击 Lune 卡片启用它。Perplexity 还会要求上传图标，安装页面的步骤里提供了可下载的图标。

**Manus。** 依次打开 **Settings**、**Connectors**、**+ Add Connectors**、**Custom MCP**。选择 **Import by JSON**，粘贴安装页面上的 JSON，其中已带访问密钥。

**其他应用。** 在应用的 MCP 或连接器设置里添加服务器地址。应用支持 OAuth 的话会请你登录，不支持就用访问密钥。

## 常见问题

**AI 应用能看到我的密码吗？**
看不到。你在自己的浏览器里、在 Lune 自己的页面上登录，应用只拿到代表你账户的令牌，拿不到密码。

**请求从哪个团队扣额度？**
通过登录接入的连接，用量记在你的个人团队名下。访问密钥的用量记在创建它的团队名下。想使用共享团队的套餐，请看[团队与访问密钥](https://luneresearch.com/zh-Hans/docs/concepts/orgs-and-keys)。

**我可以撤销某个应用的访问权限吗？**
可以，在[凭证页面](https://luneresearch.com/dashboard/settings/credentials)操作。选中个人团队后，**OAuth 客户端**标签页会列出你通过登录接入的应用。撤销后，它无法再续期登录；它手上已有的访问令牌最多还能用一小时。访问密钥撤销后，会在五分钟内失效。

**Lune 会把什么分享给应用的开发商？**
只有工具调用返回的内容：搜索结果、Paper 文本、引用列表，以及请求用完时错误信息里的用量数字。Lune 不会发送你的邮箱地址或支付信息。应用如何处理这些结果，由它自己的隐私政策约定。

## 出现问题时

- 登录窗口一直在转圈，多半是应用拦截了弹窗。为应用的网站允许弹窗，再试一次。
- 助手已接入却没有 Lune 的工具，就移除连接器再重新添加。有些应用会缓存工具列表。
- 如果你失去了 AI 应用账户的控制权，在凭证页面撤销它的 Lune 连接。
- 错误码和处理方法见[故障排查](https://luneresearch.com/zh-Hans/docs/troubleshooting)。