故障排查

大多数问题都能归入五类之一。浏览一下标题,找到属于你的那一类。

我的 AI 应用说它连不上 Lune

如果连接彻底失败(超时、"couldn't reach the server"):

  1. 确认 URL。远程 MCP 位于 https://mcp.luneresearch.com。旧地址 https://mcp.luneresearch.com/mcp 仍然可用,两种写法都行。

  2. 确认你的网络能访问到它。在终端里运行:

    curl -sS -o /dev/null -w "%{http_code}\n" \
      https://mcp.luneresearch.com/.well-known/oauth-protected-resource

    你应该看到 200。其他结果都指向你这一侧的网络或 DNS 问题。

  3. 查看我们的 状态页面(如果控制台里有链接),或留意控制台横幅是否有正在发生的故障。

我遇到 "401 unauthorized" 或 "invalid token"

你的 AI 应用发送的令牌与某个有效密钥不匹配。

  • 个人访问令牌:打开控制台的 凭证页面,生成一个新令牌,再把它粘贴回 AI 应用的连接器配置里。PAT 以 lune_ 开头。免费版令牌永不过期,但任何有控制台访问权限的人都能撤销它们。
  • OAuth(浏览器登录流程):在 AI 应用的连接器设置里退出登录,然后重新登录。令牌刷新过程是自动的,但长时间闲置的会话可能已经超过了刷新窗口。
  • 选错了团队:一个令牌只属于一个团队。如果你最近在控制台里切换了团队,旧令牌仍然指向旧团队。请在你想使用的团队下重新生成一个令牌。

我遇到 "rate limited" 或 "429"

你已经达到每日请求上限,或者点数已用尽。

  • 免费版 把你限制在每天 10 次请求,在 UTC 午夜重置。Pro 把上限提到 300,Max 提到 600。可从 设置 → 账单升级。
  • 点数包($0.99 换 300 次额外请求)让你在超过每日上限后还能继续工作。在同一个账单页面充值即可,点数永不过期,并在团队内共享。
  • 突发上限:我们还把瞬时突发限制在每秒 30 次请求,以防脚本失控。如果你的 AI 应用并行发出大量工具调用,可能还没到每日上限就先撞上突发限制。错误信息会准确告诉你是哪个限制被触发了。

我的 AI 应用连上了,但工具不显示

MCP 会话已经打开,但 tools/list 没有返回任何内容,或者应用尚未刷新它的工具目录。

  • 重启 AI 应用。大多数客户端只在冷启动时获取 tools/list
  • 对于网页版 AI 应用,移除连接器再重新添加。我们这边部署之后,网页客户端有时会一直用着已经过期的会话 ID。
  • 对于 Claude Desktop,请完全退出(不只是关闭窗口)再重新启动。
  • 确认你的令牌拥有正确的权限范围。默认 PAT 拥有全部四种权限范围(papers:readguidance:readsubs:rwaccount:read);自定义权限范围的密钥可能不包含你预期的工具。

如需更深入的、针对具体应用的提示,请参阅本地 AI Agent网页版 AI 应用

搜索结果看起来不对、缺失或过时

  • 覆盖范围:Lune 收录了顶级同行评审会议(NeurIPS、ICLR、ICML、ACL、EMNLP、CVPR、ICCV、USENIX Security、IEEE S&P、CCS、NDSS 等)。如果某个会议不在这份列表上,对应论文就不会在我们的文献库里。完整列表可通过 list_conferences 工具获取。
  • 时效性:新录用的论文会在会议官方公布后 24 小时内进入文献库。如果你发现昨天的录用结果还没出现,明天再来看看。
  • 措辞:Lune 在使用完整的自然语言查询时表现最好("methods for retrieval-augmented generation that reduce hallucination on long-form QA")。简短的关键词堆砌("RAG hallucination")往往会漏掉相关论文。
  • 会议筛选:短名称是模糊匹配,但不会将错就错。筛选条件匹配不上时,搜索会退回到不加筛选,而不是悄悄给你一份错的结果。当存在歧义时,错误信息会列出候选的短名称。

我还是卡住了

发邮件至 support@luneresearch.com,并附上:

  • 你正在使用的 AI 应用(Claude.ai、Claude Code、Cursor 等)
  • 确切的错误信息
  • 如果你的 AI 应用显示了 request_id,请一并提供(每个 Lune 响应都会在响应数据中带上一个)
  • 这是全新安装,还是之前能正常工作的配置

我们通常当天就会回复。